Embedded Apps

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

App Builder is not supported for your selected Datadog site ().

Join the Beta!

Datadog App Builder is in private beta. Complete the form to request access.

Request Access

When you have Datadog App Builder apps embedded in your dashboards, you can take direct actions on your resources, and all of the relevant data and context is immediately available. Link your app with the dashboard’s time frame and template variables to dynamically set the scope of the app’s actions, which allows you to carry out actions in your environment at any needed scope.

Add apps to your dashboard

Add a previously published app to your dashboard by dragging the App widget type out of the dashboard’s widget tray:

The dashboard widget tray with the App widget type highlighted

The App Editor modal appears, allowing you to select an app and provide it with a title:

The App Editor modal with an app selected and a widget title

Sync your app with dashboard template variables

You can link your app to template variables anywhere that supports template expressions in your queries or app elements. Use the following code snippet as an example, replacing <TEMPLATE_VARIABLE_NAME> and <DEFAULT_VALUE> with the template variable name and default value, respectively. Paste the snippet into your template expression.

Note: If you want to leave an element (such as a search field) blank by default, you can set the default value to an empty string ("") or undefined.

${self.options?.find(o => o.includes(global.dashboard.templateVariables?.find(v => v.name === '<TEMPLATE_VARIABLE_NAME>')?.value)) || '<DEFAULT_VALUE>'}

Scope your app dynamically

App elements that are linked with dashboard template variables update in tandem with the values of the template variables on the dashboard. For example, selecting a particular instance_id value through the template variable dropdown or directly from a graph adds the instance_id value to the app’s filter as well, so that you can take any necessary actions on that instance:

Further reading

Documentation, liens et articles supplémentaires utiles:

Do you have questions or feedback? Join the #app-builder channel on the Datadog Community Slack.