Problem

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-schema/problems-api-v2-problem-schema.json",
  "title": "Problem",
  "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": "integer",
      "format": "int64",
      "description": "The Unix timestamp in milliseconds when the problem was first detected.",
      "example": 1718153645993
    },
    "endTime": {
      "type": "integer",
      "format": "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"
        }
      ]
    }
  }
}