Get Gnocchi Aggregates
get_gnocchi_aggregatesAggregate telemetry across current-project resources to compute project-wide averages, totals, top-N rankings, grouped metrics, or metric ratios.
Instructions
Aggregate measured telemetry across many current-project resources.
Use for cross-resource questions: project-wide averages or totals, top N resources, per-flavor or per-host groups, and ratios between metrics. For one resource's time series, use get_gnocchi_measures instead. For allocations, capacity, or quotas, use get_resource_monitoring.
Choose ONE mode:
Simple mode (preferred): set metric and aggregation, plus optional reaggregation, groupby, and top. Leave operations empty.
Project-wide average CPU: metric="cpu", aggregation="rate:mean", reaggregation="mean"
Top 5 instances by CPU: metric="cpu", aggregation="rate:mean", top=5
Mean memory use per flavor: metric="memory.usage", reaggregation="mean", groupby="flavor_name"
Expression mode: set operations only, for arithmetic between metrics or advanced Gnocchi functions. Leave metric and reaggregation empty. Write metric NAMES, never metric UUIDs, as (metric NAME AGGREGATION). Example ratio: (/ (metric memory.usage mean) (metric memory mean)) Arithmetic returns points only where every operand has data; memory (flavor size) is recorded sparsely, so this ratio has fewer points.
Units: cpu with rate:mean is CPU nanoseconds per granularity window; utilization fraction = value / (granularity * 1e9 * vCPUs). memory.usage is MB in use. vcpus and memory are flavor sizes, not usage.
Results are always limited to resources of the current project. The response echoes the executed operations expression.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_gnocchi_aggregates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | Return only the N series with the highest latest value (0 = all) | |
| fill | No | Value for missing points when combining series: a number, "null", or "dropna" | |
| stop | No | Exclusive ISO 8601 stop time | |
| limit | No | Maximum latest rows per series (1-1000, default 20) | |
| start | No | Inclusive ISO 8601 start time | |
| metric | No | Metric name for simple mode, such as cpu or memory.usage | |
| filters | No | JSON object of attribute equality filters, for example {"flavor_name": "m1.small"} | |
| groupby | No | Comma-separated resource attributes, such as flavor_name or host; one result group per value | |
| operations | No | Expression mode only; a Gnocchi operations expression | |
| aggregation | No | Aggregation from the metric archive policy, such as mean or rate:mean (use rate:mean for cumulative cpu) | mean |
| granularity | No | Granularity in seconds from the archive policy | |
| reaggregation | No | Combine all matched resources into one series with mean, sum, min, max, or median. Empty keeps one series per resource | |
| resource_type | No | Gnocchi resource type to search (default instance) | instance |
| needed_overlap | No | Percent of aligned points required across series (Gnocchi default 100); lower it or set fill for uneven data |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |