Datadog · Schema

LogsAggregateRequest

Request body for aggregating log events

AnalyticsDashboardsMonitoringPlatformT1Visualizations

Properties

Name Type Description
filter object
compute array List of aggregation computations to perform on the filtered log set
group_by array List of facets to group results by, enabling breakdown by log attribute
options object Options for the aggregation query
View JSON Schema on GitHub

JSON Schema

datadog-logs-logs-aggregate-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-logs-logs-aggregate-request-schema.json",
  "title": "LogsAggregateRequest",
  "description": "Request body for aggregating log events",
  "type": "object",
  "properties": {
    "filter": {
      "$ref": "#/components/schemas/LogsQueryFilter"
    },
    "compute": {
      "type": "array",
      "description": "List of aggregation computations to perform on the filtered log set",
      "items": {
        "$ref": "#/components/schemas/LogsCompute"
      }
    },
    "group_by": {
      "type": "array",
      "description": "List of facets to group results by, enabling breakdown by log attribute",
      "items": {
        "$ref": "#/components/schemas/LogsGroupBy"
      }
    },
    "options": {
      "type": "object",
      "description": "Options for the aggregation query",
      "properties": {
        "timezone": {
          "type": "string",
          "description": "The timezone to use for time-based group-by operations (IANA timezone name)"
        }
      }
    }
  }
}