Dynatrace · JSON Structure

Log Monitoring Api V2 Log Ingest Record Structure

A single log record to ingest into the Dynatrace Grail data lakehouse. The content field is required. Additional fields provide context for routing, filtering, and entity association.

Type: object Properties: 5 Required: 1

AI OperationsAnalyticsAPMApplication Performance MonitoringApplication SecurityAutomationCloud MonitoringDigital Experience ManagementIntelligenceObservability

LogIngestRecord is a JSON Structure definition published by Dynatrace, describing 5 properties, of which 1 is required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

content severity timestamp log.source dt.entity.host

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

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/dynatrace/refs/heads/main/json-structure/log-monitoring-api-v2-log-ingest-record-structure.json",
  "description": "A single log record to ingest into the Dynatrace Grail data lakehouse. The content field is required. Additional fields provide context for routing, filtering, and entity association.",
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The main log message or text. Required. This is the primary searchable content of the log record.",
      "example": "example-value"
    },
    "severity": {
      "type": "string",
      "description": "The severity level of the log record. Standard syslog severity levels are supported.",
      "enum": [
        "EMERGENCY",
        "ALERT",
        "CRITICAL",
        "ERROR",
        "WARNING",
        "NOTICE",
        "INFO",
        "DEBUG",
        "TRACE"
      ],
      "example": "EMERGENCY"
    },
    "timestamp": {
      "type": "string",
      "description": "The timestamp of the log record. Accepts ISO 8601 format (e.g., 2024-01-15T10:30:00.000Z) or Unix timestamp in milliseconds. If not specified, the ingestion time is used.",
      "example": "example-value"
    },
    "log.source": {
      "type": "string",
      "description": "A string identifier for the source of the log record, such as an application name, component, or log file path.",
      "example": "example-value"
    },
    "dt.entity.host": {
      "type": "string",
      "description": "The Dynatrace host entity ID to associate this log record with, e.g., HOST-1234567890ABCDEF. This enables correlation between logs and monitored infrastructure.",
      "example": "example-value"
    }
  },
  "required": [
    "content"
  ],
  "name": "LogIngestRecord"
}