query_metrics
Execute an InfluxQL query against the operator's metrics database.
Execute an InfluxQL query against the operator's metrics database.
Read-only · Calls external systems. Safe to call: this tool does not modify data.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
detail | boolean | No | Return full JSON instead of statistical summary (default: false) |
operator | string | Yes | Operator slug (= InfluxDB database name) |
precision | string | No | Query time precision (s, ms, u, ns) |
query | string | Yes | InfluxQL query string |
summary_mode | string | No | Output detail: 'full' (default, all metrics), 'executive' (1-line status, key metrics only) |
Example arguments
Illustrative arguments an agent supplies when calling this tool:
{
"operator": "string",
"query": "string"
}Description
Returns statistical summaries by default; use detail=true for raw JSON.
PREREQUISITE: call platform_guide topic=metrics for the schema discovery workflow, measurement catalog, and example queries.
Start with SHOW MEASUREMENTS to discover tables, then SHOW FIELD KEYS FROM <measurement> for fields. Always include a WHERE time clause (recommended max 90 days for summary mode, 30 days for detail=true). In detail mode, results truncated at 5000 points.Related
What's next?
Last updated on