Kong · Schema

AgenticQuery

A query targeting the agentic usage analytics datasource.

API GatewayAI GatewayAI ConnectivityAgent GatewayEvent GatewayMCP RegistryService MeshLLMKafkaKonnectOpen Source

Properties

Name Type Description
datasource string
metrics object
dimensions array List of attributes or entity types to group by.
filters object
granularity object
time_range object
View JSON Schema on GitHub

JSON Schema

kong-agenticquery-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/AgenticQuery",
  "title": "AgenticQuery",
  "description": "A query targeting the agentic usage analytics datasource.",
  "type": "object",
  "properties": {
    "datasource": {
      "type": "string",
      "enum": [
        "agentic_usage"
      ]
    },
    "metrics": {
      "$ref": "#/components/schemas/AgenticMetrics"
    },
    "dimensions": {
      "description": "List of attributes or entity types to group by.",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "a2a_context_id",
          "a2a_error",
          "a2a_method",
          "a2a_task_id",
          "api",
          "api_package",
          "api_product",
          "api_product_version",
          "application",
          "consumer",
          "control_plane",
          "control_plane_group",
          "country_code",
          "data_plane_node",
          "data_plane_node_version",
          "gateway_service",
          "mcp_error",
          "mcp_method",
          "mcp_session_id",
          "mcp_tool_name",
          "portal",
          "realm",
          "response_source",
          "route",
          "status_code",
          "status_code_grouped",
          "time",
          "upstream_status_code",
          "upstream_status_code_grouped"
        ],
        "x-speakeasy-unknown-values": "allow"
      },
      "maxItems": 2
    },
    "filters": {
      "$ref": "#/components/schemas/AgenticFilters"
    },
    "granularity": {
      "$ref": "#/components/schemas/Granularity"
    },
    "time_range": {
      "$ref": "#/components/schemas/TimeRange"
    }
  },
  "example": {
    "datasource": "agentic_usage",
    "time_range": {
      "type": "relative",
      "time_range": "24h",
      "tz": "EST"
    },
    "dimensions": [
      "time",
      "mcp_tool_name"
    ],
    "filters": [
      {
        "operator": "in",
        "field": "control_plane",
        "value": [
          "d5ac5d88-efed-4e10-9dfe-0b0a6646c219"
        ]
      }
    ],
    "granularity": "hourly",
    "metrics": [
      "request_count"
    ]
  },
  "additionalProperties": false,
  "required": [
    "datasource"
  ]
}