Dynatrace

Use Dynatrace to inspect observability and security data, manage problems and configuration, or submit metrics, logs, and events.

Supported operations

• Problems — list and inspect Davis problems, read their root cause and affected entities, close them, and manage their comments.
• Metrics — query time series with a metric selector, discover which metrics exist, read a metric's descriptor, and push your own data points.
• Entities — list and inspect monitored hosts, services, applications, and Kubernetes workloads, and enumerate the entity types available for building selectors.
• Tags — read, add, and remove the custom tags that drive selectors, management zones, and alerting.
• Events — read deployments, availability changes, and annotations, and ingest your own.
• Logs — search log records and ingest new ones.
• SLOs — read, create, update, and delete service-level objectives, with their attainment, error budget, and burn rate.
• Application Security — list and inspect vulnerabilities with risk assessment and remediation guidance, walk their remediation items, mute and unmute them singly or in bulk, and review the runtime attacks that exploited them.
• Settings — browse schemas and read, create, update, and delete settings objects. This is how maintenance windows, alerting profiles, management zones, and anomaly-detection thresholds are configured.
• Synthetic — list monitors, trigger an on-demand batch execution, and poll the batch for its result.
• Audit log — read who changed which configuration, and when.

Setup

You need two values: your environment URL and an access token.

The environment URL is the base address of your Dynatrace environment, without the API path:

Create the token under Access tokens in Dynatrace, and grant only the scopes for the operations you plan to call. Each action's apiToken description names the scope it needs:

Synthetic monitors use Environment API v1 — Sim handles the path difference, but the token scopes differ from the v2 endpoints.

Selectors

Most read operations are scoped by a selector rather than by fixed filter fields. Criteria are comma-separated, and every criterion matched must hold:

entitySelector:         type("HOST"),tag("env:prod")
problemSelector:        status("open"),severityLevel("AVAILABILITY")
metricSelector:         builtin:host.cpu.usage:splitBy("dt.entity.host"):avg:names
securityProblemSelector: status("OPEN"),riskLevel("CRITICAL")

For selector fields with a wand, describe the filter in plain language to generate a selector, then review its syntax before running the operation.

Settings objects

Most Dynatrace configuration is a settings object: a JSON value whose shape is defined by a schema such as builtin:alerting.maintenance-window. The schema determines the JSON shape. Read its definition or an existing object of the same schema before constructing value. Get Settings Object also returns an updateToken — pass it back on update or delete and the call fails rather than overwriting a change someone else made in the meantime.

Pagination

List operations return a nextPageKey (a nextSliceKey for log search). Feed it back into the next call to read the following page. Dynatrace encodes the original filters into the cursor, so Sim sends the cursor alone and ignores the other filters on that call — which is what the API requires.

Use the block

Integrate Dynatrace into workflows. Investigate and close Davis problems, query metrics and monitored entities, search and ingest logs, push deployment events, manage SLOs and their burn rates, triage and mute Application Security vulnerabilities, review runtime attacks, tag entities, manage settings objects such as maintenance windows and alerting profiles, run synthetic monitors on demand, and read the audit log.

Actions

Dynatrace List Problems

List Davis-detected problems in a Dynatrace environment, filtered by timeframe, problem selector, or entity selector.

Dynatrace Get Problem

Get the full details of a single Dynatrace problem, including root cause, affected entities, and optionally its evidence and impact analysis.

Dynatrace Close Problem

Close a Dynatrace problem and record the closing comment.

Dynatrace List Problem Comments

List the comments recorded on a Dynatrace problem.

Dynatrace Add Problem Comment

Add a comment to a Dynatrace problem.

Dynatrace Query Metrics

Read metric data points from Dynatrace using a metric selector, with optional entity and management-zone scoping.

Dynatrace List Metrics

Discover the metrics available in a Dynatrace environment, filtered by metric selector, free text, or metadata.

Dynatrace Get Metric Descriptor

Get the descriptor of a single Dynatrace metric — its unit, dimensions, supported aggregations, and transformations.

Dynatrace Ingest Metrics

Push custom metric data points into Dynatrace using the metric line protocol, one data point per line.

Dynatrace List Entities

List monitored entities — hosts, services, applications, Kubernetes workloads — matching an entity selector.

Dynatrace Get Entity

Get the properties, tags, management zones, and relationships of a single monitored entity.

Dynatrace List Entity Types

List the monitored entity types available in the environment, with the properties and relationships each supports. Use it to build valid entity selectors.

Dynatrace List Events

List events — deployments, availability changes, alerts, custom annotations — in a Dynatrace environment.

Dynatrace Get Event

Get the full details of a single Dynatrace event.

Dynatrace Ingest Event

Push an event into Dynatrace — a deployment marker, custom annotation, or custom alert — attached to the entities matched by an entity selector.

Dynatrace Search Logs

Search log records in Dynatrace by query and timeframe, for troubleshooting and incident analysis.

Dynatrace Ingest Logs

Push log events into Dynatrace. Accepts a single log event object or an array of them.

Dynatrace List SLOs

List service-level objectives with their current attainment, error budget, and burn rate.

Dynatrace Get SLO

Get a single service-level objective with its evaluated attainment, error budget, and burn rate.

Dynatrace List Security Problems

List vulnerabilities detected by Dynatrace Application Security, filtered by risk level, status, CVE, or technology.

Dynatrace Get Security Problem

Get a single vulnerability with its description, remediation guidance, affected entities, and risk assessment.

Dynatrace Get Audit Logs

Read the Dynatrace audit log — who changed which configuration, when, and whether it succeeded.

Dynatrace Mute Security Problem

Mute a single Dynatrace vulnerability with a reason, for triaging false positives or accepted risk.

Dynatrace Unmute Security Problem

Unmute a single Dynatrace vulnerability, returning it to the active triage queue.

Dynatrace Mute Security Problems

Mute several Dynatrace vulnerabilities at once with a shared reason, for bulk triage.

Dynatrace Unmute Security Problems

Unmute several Dynatrace vulnerabilities at once, returning them to active triage.

Dynatrace List Remediation Items

List the remediation items of a third-party vulnerability — the components to upgrade, their affected entities, and their mute state.

Dynatrace List Attacks

List runtime attacks Dynatrace Application Protection detected — injection attempts, their source, and whether they were blocked.

Dynatrace Get Attack

Get a single attack with its entry point, payload, attacker, and the vulnerability it exploited.

Dynatrace List Tags

List the custom tags applied to the monitored entities an entity selector matches.

Dynatrace Add Tags

Add custom tags to every monitored entity an entity selector matches. Tags drive selectors, management zones, and alerting.

Dynatrace Delete Tag

Remove a custom tag from every monitored entity an entity selector matches. Deletes one key-value pair, or every tag with the key.

Dynatrace List Settings Schemas

List the settings schemas available in the environment. Use it to find the schema ID for a configuration type such as builtin:alerting.profile.

Dynatrace List Settings Objects

List settings objects — the configuration behind maintenance windows, alerting profiles, management zones, and anomaly detection.

Dynatrace Get Settings Object

Get a single settings object with its value and its update token. Read it before updating so the token can guard against a concurrent change.

Dynatrace Create Settings Object

Create a settings object — a maintenance window, alerting profile, management zone, or any other schema-backed configuration.

Dynatrace Update Settings Object

Update an existing settings object. Pass the update token from Get Settings Object to fail rather than overwrite a concurrent change.

Dynatrace Delete Settings Object

Delete a settings object. Dynatrace cannot undo this.

Dynatrace List Synthetic Monitors

List synthetic monitors and their IDs. Use it to find the monitor IDs to feed into an on-demand execution.

Dynatrace Execute Synthetic Monitors

Trigger an on-demand batch execution of synthetic monitors, for gating a deploy on a smoke test. Returns a batch ID to poll.

Dynatrace Get Synthetic Batch

Get the status and failures of an on-demand synthetic batch execution. Poll it after triggering to gate a deploy on the result.

Dynatrace Get Problem Comment

Get a single comment on a Dynatrace problem.

Dynatrace Update Problem Comment

Replace the text of an existing comment on a Dynatrace problem.

Dynatrace Delete Problem Comment

Delete a comment from a Dynatrace problem.

Dynatrace Create SLO

Create a service-level objective from a metric expression, target, and evaluation timeframe.

Dynatrace Update SLO

Update an existing service-level objective. Every field is replaced, so send the complete definition.

Dynatrace Delete SLO

Delete a service-level objective.