MCP Metrics: Distribution Examples

Top servers by request count

Count requests per server, alongside p99 latency:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "mcpServerName"},
        {"type": "p99", "column": "latencyMs"}
    ],
    "groupBy": ["mcpServerName"]
}

Tool calls grouped by tool name

Restrict to tools/call and group by toolName:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "toolName"}
    ],
    "groupBy": ["toolName"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]}
    ]
}

Method distribution per server

Traffic mix per server (initialize / tools/list / tools/call / …):

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "method"}
    ],
    "groupBy": ["mcpServerName", "method"]
}

Latency percentiles by tool

p50, p90, and p99 latency per tool:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "p50", "column": "latencyMs"},
        {"type": "p90", "column": "latencyMs"},
        {"type": "p99", "column": "latencyMs"}
    ],
    "groupBy": ["toolName"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]}
    ]
}

Distinct tools per server

How many unique tools each server exposed:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "countDistinct", "column": "toolName"}
    ],
    "groupBy": ["mcpServerName"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]}
    ]
}

Exclude internal tools

Count tool calls excluding internal/debug tools using NOT_IN:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "toolName"}
    ],
    "groupBy": ["toolName"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]},
        {"fieldName": "toolName", "operator": "NOT_IN", "value": ["internal-debug", "healthcheck", "echo"]}
    ]
}

High-latency tool calls

Find slow tool calls (above 5 seconds):

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "toolName"}
    ],
    "groupBy": ["mcpServerName", "toolName"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]},
        {"fieldName": "latencyMs", "operator": "GREATER_THAN", "value": 5000}
    ]
}

Group by metadata

Tool-call counts per metadata key:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "toolName"}
    ],
    "groupBy": ["toolName", "metadata.environment"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]}
    ]
}

Filter by team

Tool-call activity scoped to a team:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "toolName"}
    ],
    "groupBy": ["mcpServerName"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]},
        {"fieldName": "team", "operator": "ARRAY_HAS_ANY", "value": ["team-alpha"]}
    ]
}

Complex filter combination

Tool-call traffic on a known list of servers, latency window, scoped to a team:

json={
    "startTs": "2026-04-21T00:00:00.000Z",
    "endTs": "2026-04-22T00:00:00.000Z",
    "datasource": "mcpMetrics",
    "type": "distribution",
    "aggregations": [
        {"type": "count", "column": "toolName"},
        {"type": "p99", "column": "latencyMs"}
    ],
    "groupBy": ["mcpServerName", "toolName"],
    "filters": [
        {"fieldName": "method", "operator": "IN", "value": ["tools/call"]},
        {"fieldName": "mcpServerName", "operator": "IN", "value": ["github-mcp", "atlassian-mcp"]},
        {"fieldName": "latencyMs", "operator": "BETWEEN", "value": [100, 10000]},
        {"fieldName": "team", "operator": "ARRAY_HAS_ANY", "value": ["team-alpha"]}
    ]
}

Get Started

LLM Gateway

MCP Registry and Gateway

Skills Registry

Prompt Registry

Guardrails and Security

Observability

Deployment

Admin Guide

Chat

Messages

Embeddings

Rerank

Responses

Image

Audio

Batch

Files

Fine-tuning

Moderations

Models

MCP Metrics: Distribution Examples

Distribution queries

​Distribution queries

Distribution queries