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 App Editor modal appears, allowing you to select an app and provide it with a 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

Additional helpful documentation, links, and articles:

Actions CatalogAPP

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