topic Re: Downloading new Dashboards with Monaco in Dashboarding

Downloading new Dashboards with Monaco

mouru — Tue, 21 May 2024 11:50:06 GMT

I'm trying to download all my hand build configurations from Dynatrace with Monaco, but new Dashboards seem to be excluded from the pack. I can manually click on the Download button in the UI but this is not sustainable for CI.

Re: Downloading new Dashboards with Monaco

AntonPineiro — Tue, 21 May 2024 12:17:06 GMT

Hi,

You can see here all APIs supported in Monaco.

I think that API is not supported today. If that is the case, it can be a interesting product idea.

Best regards

Re: Downloading new Dashboards with Monaco

Vakho_ — Mon, 27 May 2024 16:28:07 GMT

Hello,
I might be wrong, but when I tested Monaco with the download flag, it only fetched the dashboards that were created via Monaco. To include your existing dashboards, you can export them and then re-upload them via Monaco. After doing this, using the download flag will display all your custom/created dashboards.

I think it works in the same logic as Terraform when the host was provisioned manually and you need to import it.

Re: Downloading new Dashboards with Monaco

mouru — Tue, 28 May 2024 05:26:13 GMT

Hi,

I definitely can download all my dashboards (classic) with Monaco even when I have build them in browser.

This is not the case with Dashboards v2 or Notebooks, which are newer + might still be WIP.

Re: Downloading new Dashboards with Monaco

AntonPineiro — Tue, 28 May 2024 06:45:55 GMT

Hi,

Are you talking about new Dashboards or Classic Dashboards?

I can download all classic dashboards without problem.

Best regards

Re: Downloading new Dashboards with Monaco

Vakho_ — Tue, 28 May 2024 15:37:36 GMT

Hello,

Hmm, that's odd. I tried it, and only the present dashboards were downloaded automatically. I will double-check with the classic one. Seems like I missing something..
Thanks for the feedback

Re: Downloading new Dashboards with Monaco

Julius_Loman — Tue, 28 May 2024 18:26:21 GMT

@mouru The new dashboards and notebooks can only be downladed and uploaded with recent Monaco versions and it's still hidden under a feature flag (monaco >=2.14) - MONACO_FEAT_DOCUMENTS.

Also don't forget to create an OAuth client for that and also include policies for the document service which are not yet in the docs.

Re: Downloading new Dashboards with Monaco

nico_riedmann — Wed, 26 Jun 2024 12:05:41 GMT

Please note that new/Dynatrace Platform Dashboards and Notebooks are not yet supported by Monaco.

While it is true that you can activate support for them already via a feature flag, flags are generally used in Monaco to aid development, internal feedback, and incremental releases - and not meant to be modified. Thus they are also not documented.

Support for new Dashboards and Documents will be part of the upcoming 2.15.0 release. Within the next few days, documentation will describe how to configure them, with the release following soon after.

---

While you can turn the feature on via the flag as described, please note that:
* configuration might still change, and any new dashboard downloaded with a current release of Monaco may not be compatible with the 2.15.0 release.
* Dynatrace Support won't be able to help you with any issues if you're using unreleased features/change feature flags from default. (With the exception of a handful of flags you can find described in the documentation.)

Best,
Nico
Team Monaco

Re: Downloading new Dashboards with Monaco

SjoerdB — Fri, 09 Aug 2024 08:13:08 GMT

Hi @nico_riedmann , can you point me to the documentation of the notebooks/documents? I don't see the place where I can define the dashboard sharing options...

Re: Downloading new Dashboards with Monaco

nico_riedmann — Fri, 09 Aug 2024 08:19:50 GMT

Hi @SjoerdB, sharing settings of private 3rd gen documents are currently not supported.
Currently, you can only define public documents (shared with all logged-in users) or private ones and apply share settings manually.

https://docs.dynatrace.com/docs/shortlink/configuration-as-code-yaml-configuration#type-document

Re: Downloading new Dashboards with Monaco

SjoerdB — Fri, 09 Aug 2024 08:38:20 GMT

I assume (but will test), that public means that they are in a "read-only" for public and read-write for the oauth user which is used for the MoNaCo interaction?

Does this automatically imply it is best practice to only have 1 oauth user for MoNaCo, because otherwise the document would get deployed by various individuals and right management would be hard...

Re: Downloading new Dashboards with Monaco

nico_riedmann — Fri, 09 Aug 2024 12:49:49 GMT

Correct - 'public' relates to 'Access for all' as described in the documentation for sharing documents , meaning "read-only" for public, "read-write" for owner.

You certainly do not want more than one set of credentials to manage the same configuration. As you already mentioned, two users managing the same document will require you to set up manual sharing settings, allowing the user who's not the document's owner to edit it.

In general, I'd say it's best practice to have 1 set of credentials (oAuth client, API token, ..) per logical grouping of configuration.
That might be one for all your config-as-code usage, one per department grouping several Monaco projects, one per team, etc. - this all depends a bit on the number of configurations, how Dynatrace usage is structured/managed, and what fits your Dynatrace access permission concept (in general you won't want to have one set of 'master admin credentials' which everyone can access but use granular permissions and policies, but if all config-as-code is managed in one repository and rolled out automatically having one such admin token for this might fit)

Hope that helps!

Re: Downloading new Dashboards with Monaco

Kenny_Gillette — Mon, 14 Apr 2025 14:38:19 GMT

Hi, any updates to Monaco 2.0 downloading New Dashboards, Workflows, Notebooks, etc?

Re: Downloading new Dashboards with Monaco

Julius_Loman — Tue, 15 Apr 2025 06:54:54 GMT

@Kenny_Gillette has worked for me for at least a couple of months. Be sure to properly configure OAuth2 client
and assign the requested scopes.

Re: Downloading new Dashboards with Monaco

Kenny_Gillette — Thu, 17 Apr 2025 16:12:51 GMT

Thanks, will look at that.

Re: Downloading new Dashboards with Monaco

Kenny_Gillette — Fri, 18 Apr 2025 18:48:20 GMT

I tried adding OAuth client but getting error.

2025-04-18T13:06:29-04:00 error error during parsing the manifest: yaml: unmarshal errors:
line 11: field token not found in type persistence.Environment
line 13: field oAuth not found in type persistence.Environment: manifest.yaml
2025-04-18T13:06:29-04:00 error Error: failed to load manifest 'manifest.yaml'

Re: Downloading new Dashboards with Monaco

Julius_Loman — Sat, 19 Apr 2025 09:03:59 GMT

@Kenny_Gillette Can you share your manifest.yaml?

Re: Downloading new Dashboards with Monaco

Kenny_Gillette — Mon, 21 Apr 2025 15:19:38 GMT

manifestVersion: 1.0

environmentGroups:

- name: Trek10

environments:

- name: Trek10

url:

type: value

value: https://DTURL.live.dynatrace.com/

auth:

token:

oAuth:

clientId:

clientSecret:

Re: Downloading new Dashboards with Monaco

Kenny_Gillette — Tue, 06 May 2025 12:38:28 GMT

@Julius_Loman

Thoughts?

Re: Downloading new Dashboards with Monaco

AntonPineiro — Tue, 06 May 2025 13:09:34 GMT

Hi,

I would try:

Replace tokens with environmens variables.
Replace "apps" instead of "live" in URL.

This is working for me:

environmentGroups: - name: dev environments: - name: inetum url: type: value value: "https://XXXX.apps.dynatrace.com" auth: token: name: "INETUM_API_TOKEN" oAuth: clientId: name: "CLIENT_ID" clientSecret: name: "CLIENT_SECRET"

Best regards