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"
  ]
}