Type to search.

Dynatrace connector

Serverless Preview

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Preview

    This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply.

Serverless interfaces and procedures might differ from classic Elastic Stack deployments.

Stack Planned

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Planned

    We plan to add this functionality in a future Elastic Stack update. Subject to changes.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

The Dynatrace connector connects directly to the Dynatrace Environment API v2. It lets a workflow or agent triage Davis problems — list, read, comment, and close — plus ingest events, query metrics and entities, and manage maintenance windows, without opening the Dynatrace console.

You can use this connector in Agent Builder and Workflows.

The Dynatrace connector uses Dynatrace's REST API with Authorization: Api-Token authentication. You configure your environment URL and an API access token when creating the connector.

You can create a Dynatrace connector in Stack Management > Connectors.

Environment URL
Environment API base URL, without a trailing /api/v2. SaaS must use https://your-environment-id.live.dynatrace.com (not the *.apps.dynatrace.com UI host — including trial/sandbox). Managed example: https://your-domain/e/your-environment-id. Environment ActiveGate example: https://your-activegate-domain:9999/e/your-environment-id.
Authentication
API token. Paste the raw Dynatrace API token value only (for example dt0c01....) — do not include a prefix. The connector sends Authorization: Api-Token <token> automatically. Required scopes: problems.read, problems.write, events.read, events.ingest, metrics.read, entities.read, settings.read, settings.write.
Action Description
listProblems List Davis problems. Parameters: problemSelector, entitySelector, from, to, fields, sort, pageSize, nextPageKey.
getProblem Get one problem by ID. Parameters: problemId (required), fields.
closeProblem Close a problem with a comment. Parameters: problemId (required), message (required).
addProblemComment Post a comment on a problem. Parameters: problemId (required), message (required), context.
listProblemComments List comments on a problem. Parameters: problemId (required), pageSize, nextPageKey.
ingestEvent Ingest a custom event. Parameters: eventType (required), title (required), entitySelector, properties, startTime, endTime, timeout.
listEvents List events. Parameters: eventSelector, entitySelector, from, to, pageSize, nextPageKey.
getEvent Get one event by ID. Parameters: eventId (required).
queryMetrics Query metric data points. Parameters: metricSelector (required), from, to, resolution, entitySelector.
listMetrics Discover metric keys/descriptors. Parameters: metricSelector, text, fields, pageSize, nextPageKey.
getMetricDescriptor Get one metric descriptor. Parameters: metricId (required), fields.
listEntities List monitored entities. Parameters: entitySelector (required), from, to, fields, pageSize, nextPageKey.
getEntity Get one entity by ID. Parameters: entityId (required), fields, from, to.
createMaintenanceWindow Create a once-off maintenance window (Settings API). Parameters: name (required), filter (required DQL), startDateTime (required), durationMinutes (required), description, enabled, autoDelete, timezone.
listMaintenanceWindows List maintenance windows. Parameters: pageSize, nextPageKey, fields.
deleteMaintenanceWindow Delete a maintenance window by Settings object ID. Parameters: objectId (required).

You can test connectors as you're creating or editing the connector in Kibana. The connectivity test lists a single problem (pageSize=1) against your environment.

To use the Dynatrace connector, you need to:

  1. Open your Dynatrace environment. For SaaS (including trial/sandbox), use the Environment API host https://{environment-id}.live.dynatrace.com — not the *.apps.dynatrace.com UI URL from the browser address bar.
  2. Go to Access tokens and create an API token with these scopes: problems.read, problems.write, events.read, events.ingest, metrics.read, entities.read, settings.read, settings.write.
  3. When creating the connector in Kibana, paste the raw token value (without an Api-Token prefix) and set the Environment URL to the base URL from step 1.