Dynatrace

Dynatrace is an observability platform that monitors applications, infrastructure, and user experience from a single agent. Its Davis AI correlates signals across the stack into problems — a single incident with a root cause, an impact assessment, and the affected entities attached — instead of a stream of disconnected alerts.

What you can reach from Sim

• 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:

Note that Synthetic monitors are the one part of this integration on 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")

Every selector field in the block has a wand — describe what you want in plain language and Sim writes the selector for you.

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. There is no fixed structure Sim can validate for you, so the reliable way to write one is to read an existing object of the same schema first and mirror its 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.

Usage Instructions

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.

Input

Output

Dynatrace Get Problem

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

Input

Output

Dynatrace Close Problem

Close a Dynatrace problem and record the closing comment.

Input

Output

Dynatrace List Problem Comments

List the comments recorded on a Dynatrace problem.

Input

Output

Dynatrace Add Problem Comment

Add a comment to a Dynatrace problem.

Input

Output

Dynatrace Query Metrics

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

Input

Output

Dynatrace List Metrics

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

Input

Output

Dynatrace Get Metric Descriptor

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

Input

Output

Dynatrace Ingest Metrics

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

Input

Output

Dynatrace List Entities

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

Input

Output

Dynatrace Get Entity

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

Input

Output

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.

Input

Output

Dynatrace List Events

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

Input

Output

Dynatrace Get Event

Get the full details of a single Dynatrace event.

Input

Output

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.

Input

Output

Dynatrace Search Logs

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

Input

Output

Dynatrace Ingest Logs

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

Input

Output

Dynatrace List SLOs

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

Input

Output

Dynatrace Get SLO

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

Input

Output

Dynatrace List Security Problems

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

Input

Output

Dynatrace Get Security Problem

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

Input

Output

Dynatrace Get Audit Logs

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

Input

Output

Dynatrace Mute Security Problem

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

Input

Output

Dynatrace Unmute Security Problem

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

Input

Output

Dynatrace Mute Security Problems

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

Input

Output

Dynatrace Unmute Security Problems

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

Input

Output

Dynatrace List Remediation Items

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

Input

Output

Dynatrace List Attacks

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

Input

Output

Dynatrace Get Attack

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

Input

Output

Dynatrace List Tags

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

Input

Output

Dynatrace Add Tags

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

Input

Output

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.

Input

Output

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.

Input

Output

Dynatrace List Settings Objects

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

Input

Output

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.

Input

Output

Dynatrace Create Settings Object

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

Input

Output

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.

Input

Output

Dynatrace Delete Settings Object

Delete a settings object. Dynatrace cannot undo this.

Input

Output

Dynatrace List Synthetic Monitors

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

Input

Output

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.

Input

Output

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.

Input

Output

Dynatrace Get Problem Comment

Get a single comment on a Dynatrace problem.

Input

Output

Dynatrace Update Problem Comment

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

Input

Output

Dynatrace Delete Problem Comment

Delete a comment from a Dynatrace problem.

Input

Output

Dynatrace Create SLO

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

Input

Output

Dynatrace Update SLO

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

Input

Output

Dynatrace Delete SLO

Delete a service-level objective.

Input

Output