Dynatrace · JSON Structure

Problems Api V2 Problem Structure

Represents a Dynatrace-detected problem, which is an aggregated set of related events indicating a service degradation. Problems are detected and correlated by the Davis AI engine.

Type: object Properties: 12
AI OperationsAnalyticsAPMApplication Performance MonitoringApplication SecurityAutomationCloud MonitoringDigital Experience ManagementIntelligenceObservability

Problem is a JSON Structure definition published by Dynatrace, describing 12 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

problemId displayId title severityLevel status startTime endTime affectedEntities impactedEntities rootCauseEntity managementZones problemFilters

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-structure/problems-api-v2-problem-structure.json",
  "description": "Represents a Dynatrace-detected problem, which is an aggregated set of related events indicating a service degradation. Problems are detected and correlated by the Davis AI engine.",
  "type": "object",
  "properties": {
    "problemId": {
      "type": "string",
      "description": "The internal unique identifier of the problem, e.g., -1234567890123456789_V2.",
      "example": "abc123"
    },
    "displayId": {
      "type": "string",
      "description": "The human-readable problem identifier displayed in the Dynatrace UI, e.g., P-123456.",
      "example": "abc123"
    },
    "title": {
      "type": "string",
      "description": "The title summarizing the nature of the problem, generated by the Davis AI.",
      "example": "example-value"
    },
    "severityLevel": {
      "type": "string",
      "description": "The severity classification of the problem, indicating the type of impact.",
      "enum": [
        "AVAILABILITY",
        "ERROR",
        "PERFORMANCE",
        "RESOURCE_CONTENTION",
        "CUSTOM_ALERT"
      ],
      "example": "AVAILABILITY"
    },
    "status": {
      "type": "string",
      "description": "The current status of the problem.",
      "enum": [
        "OPEN",
        "RESOLVED"
      ],
      "example": "OPEN"
    },
    "startTime": {
      "type": "int64",
      "description": "The Unix timestamp in milliseconds when the problem was first detected.",
      "example": 1718153645993
    },
    "endTime": {
      "type": "int64",
      "description": "The Unix timestamp in milliseconds when the problem was resolved. Returns -1 if the problem is still open.",
      "example": 1718153645993
    },
    "affectedEntities": {
      "type": "array",
      "description": "The list of entities directly affected by the problem. These are the entities where the anomaly was first detected.",
      "items": {
        "$ref": "#/components/schemas/EntityStub"
      },
      "example": [
        {
          "entityId": "abc123",
          "name": "Production Service",
          "type": "STANDARD"
        }
      ]
    },
    "impactedEntities": {
      "type": "array",
      "description": "The list of entities experiencing degradation as a result of the problem, including downstream dependencies.",
      "items": {
        "$ref": "#/components/schemas/EntityStub"
      },
      "example": [
        {
          "entityId": "abc123",
          "name": "Production Service",
          "type": "STANDARD"
        }
      ]
    },
    "rootCauseEntity": {
      "description": "The entity identified by Davis AI as the root cause of the problem. Null if the root cause could not be determined.",
      "nullable": true,
      "oneOf": [
        {
          "$ref": "#/components/schemas/EntityStub"
        }
      ],
      "example": "example-value"
    },
    "managementZones": {
      "type": "array",
      "description": "The management zones that contain the affected entities, used for access control and scoping.",
      "items": {
        "$ref": "#/components/schemas/ManagementZone"
      },
      "example": [
        {
          "id": "abc123",
          "name": "Production Service"
        }
      ]
    },
    "problemFilters": {
      "type": "array",
      "description": "The alerting profiles (problem filters) that match this problem and control notification routing.",
      "items": {
        "$ref": "#/components/schemas/AlertingProfileStub"
      },
      "example": [
        {
          "id": "abc123",
          "name": "Production Service"
        }
      ]
    }
  },
  "name": "Problem"
}