Top operations by usage/health for a graph over a time window, as compact CSV.
Columns: start timestamp, end exclusive timestamp, operation name, request count, request latency p50 ms, request latency p99 ms, request with error count.
Ranked by `orderBy` descending: default REQUEST_COUNT (busiest); REQUEST_WITH_ERROR_COUNT for most error-prone, REQUEST_LATENCY_P99_MS for slowest.
`variantName` scopes to one or more variants (omit for all).
`clients` scopes to one or more clients; omit `clientVersion` to match every version of that client, and use GetClientMetrics to discover the names a graph sees.
Keep the default `resolution` of ENTIRE_RANGE for totals and top-N, which gives one row per operation ranked over the whole window.
DAY/HOUR/MINUTE give one row per operation per bucket ranked within each bucket, so a window total then needs a per-operation sum plus a `limit` big enough to cover every bucket; too small a `limit` silently undercounts.
Only HOUR and MINUTE accept a `to` of now, so use them for bursts in the last 24 hours.
Avoid MONTH: it labels buckets by calendar month, not by the requested window.
View input schema
{
"type": "object",
"properties": {
"graphId": {
"type": "string"
},
"from": {
"description": "The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601). This timestamp cannot exceed your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing).",
"$ref": "#/definitions/Timestamp"
},
"to": {
"description": "The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601). This timestamp cannot exceed your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing).",
"$ref": "#/definitions/Timestamp"
},
"resolution": {
"description": "The resolution of the time groups for the report. This resolution will affect the range of times that can be used for the 'from' and\n'to' timestamps:\n- For the MINUTE resolution, the total time between 'from' and 'to' must be no more than 1 day, and the 'from' time must be no earlier than 30 days ago.\n- For the HOUR resolution, the total time between 'from' and 'to' must be no more than 7 days, and the 'from' time must be no earlier than 90 days ago.\n- For the DAY, MONTH, and ENTIRE_RANGE resolutions, the 'from' time must be no earlier than 549 days ago (approx 18 months), and the 'to' time must be no later than 1 day ago.\n- These time ranges are further constrained by your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing).\nIf these criteria are not met, this will return a REQUEST_INVALID error.",
"anyOf": [
{
"$ref": "#/definitions/TimeseriesReportResolution"
},
{
"type": "null"
}
],
"default": "ENTIRE_RANGE"
},
"orderBy": {
"anyOf": [
{
"$ref": "#/definitions/OperationInsightsTimeseriesReportMetric"
},
{
"type": "null"
}
],
"default": "REQUEST_COUNT"
},
"variantName": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
{
"type": "null"
}
]
},
"clients": {
"anyOf": [
{
"type": "array",
"items": {
"anyOf": [
{
"$ref": "#/definitions/OperationInsightsTimeseriesReportClientFilterInInput"
},
{
"type": "null"
}
]
}
},
{
"type": "null"
}
]
},
"limit": {
"description": "Maximum number of records to return (default: 100, max 10000).",
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 50
}
},
"required": [
"graphId",
"from",
"to"
],
"definitions": {
"Timestamp": {
"description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
},
"TimeseriesReportResolution": {
"description": "The size of each time bucket in a timeseries report.\n\nValues:\nDAY: One-day buckets.\nENTIRE_RANGE: Single bucket containing the entire time range.\nHOUR: One-hour buckets.\nMINUTE: One-minute buckets.\nMONTH: One-month buckets.",
"type": "string",
"enum": [
"DAY",
"ENTIRE_RANGE",
"HOUR",
"MINUTE",
"MONTH"
]
},
"OperationInsightsTimeseriesReportMetric": {
"description": "\n\nValues:\nREQUEST_COUNT: \nREQUEST_LATENCY_P50_MS: \nREQUEST_LATENCY_P90_MS: \nREQUEST_LATENCY_P99_MS: \nREQUEST_WITH_ERROR_COUNT: ",
"type": "string",
"enum": [
"REQUEST_COUNT",
"REQUEST_LATENCY_P50_MS",
"REQUEST_LATENCY_P90_MS",
"REQUEST_LATENCY_P99_MS",
"REQUEST_WITH_ERROR_COUNT"
]
},
"OperationInsightsTimeseriesReportClientFilterInInput": {
"description": "The named type and version of the clients to include or exclude in the operation timeseries report.",
"type": "object",
"properties": {
"clientName": {
"description": "The client name.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"clientVersion": {
"description": "The client version.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
}
}
}