signoz_query_metrics
Query known metrics for values, trends, breakdowns, or formulas
How to use it
signoz_query_metrics is exposed by the Signoz MCP Server MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the signoz_query_metrics tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Signoz MCP Server
claude mcp add --scope user --transport http signoz https://mcp.<region>.signoz.cloud/mcpOther tools in Signoz MCP Server (39)
Aggregate log statistics and grouped or top-N breakdowns
Aggregate span statistics and grouped or top-N breakdowns
Return label/attribute keys for a single metric with cardinality counts and sample values, sorted highest-cardinality first
Given a list of metric names (up to 50 per call), return which dashboards and alerts reference each one
Create a v2 direct/policy-routed alert or a direct-routed v1 anomaly alert
Create a custom multi-panel dashboard
Save one reusable Explorer query
Permanently delete a confirmed alert rule by UUIDv7 id
Permanently delete a confirmed dashboard by id
Permanently delete a confirmed saved view by id
Query Builder v5 requests the dedicated tools cannot express
Fetch one known official-doc page or heading as Markdown
Get one alert rule's full definition by id
Get one rule's firing or state-transition history
Get one dashboard's full layout, variables, panels, and queries
Discover available field keys for metrics, traces, or logs
Get possible values for a field key
Get all provider-specific settings for one channel by ID
Get the current status and overall posture of the SigNoz deployment, with typed projections plus sourceStats containing every reported stats field
Get ranked operations for one traced service
Return top 100 metrics ranked by ingested sample volume with pre-computed percentages for cost and volume analysis
Get one known trace with all spans and hierarchy
Get one saved Explorer view's complete definition by id
Create a dashboard from a known curated template path
List configured alert-rule summaries, including inactive/OK and disabled rules
List firing/silenced/inhibited Alertmanager alert instances (not rule definitions)
List curated templates and discover an import path
List tenant-dashboard summaries and discover UUIDs
Discover active metric names and catalog metadata
List channel summaries for name verification and ID discovery
List APM services with trace activity in a time range
List saved Explorer views for traces/logs/metrics/Cost Meter and discover UUIDs
Apply a partial RFC 6902 JSON Patch without resending the whole dashboard
Find ranked official-doc matches when no exact page is selected
Return individual log records matching filters
Return individual span rows or discover trace IDs
Fully replace an existing alert rule by id
Fully replace a fetched dashboard while preserving unrequested fields
Fully replace a fetched saved view while preserving unrequested fields