How do I set up email-based problem-notifications?

Dynatrace offers several out-of-the-box integrations that automatically push Dynatrace problem notifications to your third-party messaging or incident-management systems. If however your third-party system isn't supported with an out-of-the-box integration, you can easily set up email integration. Using this approach, an email is sent out whenever Dynatrace detects a problem in your environment that affects real users.

You can customize the Subject line of problem-notification emails by defining a text template that includes placeholders that are dynamically populated with relevant problem details, such as problem ID, problem impact, or problem state. By default, the body of email notifications contain an HTML formatted description of the detected problem and a direct link to the corresponding problem details page in Dynatrace.

To set up email-based problem notifications

  1. Navigate to Settings > Integration > Problem notifications.
  2. Click Set up notifications.
  3. Select Email to access the Set up email integration page.
  4. In the To field, type the email address, where you want problem notifications to be sent.
  5. In the CC field, type additional email addresses that should receive notifications.
  6. In the Subject field, type text and/or insert placeholders that will be automatically populated with relevant problem details, such as problem ID, state, or impact (see example above).
  7. Select an alerting profile to filter the problem feed.

Available placeholders

  • {ImpactedEntities}: Details about the entities impacted by the problem in form of a JSON array.
  • {ImpactedEntity}: Entity impacted by the problem (or x impacted entities when there are multiple).
  • {PID}: Unique system identifier of the reported problem.
  • {ProblemDetailsHTML}: All problem event details including root cause as an HTML-formatted string.
  • {ProblemDetailsJSON}: All problem event details including root cause in form of a json object.
  • {ProblemDetailsMarkdown}: All problem event details including root cause as a Markdown-formatted string.
  • {ProblemDetailsText}: All problem event details including root cause as a text-formatted string.
  • {ProblemID}: Display number of the reported problem.
  • {ProblemImpact}: Impact level of the problem. Possible values are APPLICATION, SERVICE, or INFRASTRUCTURE.
  • {ProblemSeverity}: Severity level of the problem. Possible values are AVAILABILITY, ERROR, PERFORMANCE, RESOURCE_CONTENTION, or CUSTOM_ALERT.
  • {ProblemTitle}: Short description of the problem.
  • {ProblemURL}: URL of the problem within Dynatrace.
  • {State}: Problem state. Possible values are OPEN or RESOLVED or in some cases MERGED when the problem has been merged into another problem.
  • {Tags}: Comma separated list of tags that are defined for all impacted entities.