Grafana / warm

Inspect Traces

Run a bounded TraceQL search against a Tempo datasource configured in Grafana. Returns compact trace summaries for operator inspection.

Quick Start

aweb inspect grafana.inspect_traces
aweb add grafana
aweb plan "use Grafana inspect traces in an agent workflow"
import Aweb, { Agent } from '@aweb/sdk';

const aweb = new Aweb({ apiKey: process.env.AWEB_API_KEY });
const agent = new Agent({ tools: aweb.tools });

agent.add('grafana');

const plan = await agent.plan('Use Grafana for this workflow');
const tool = await aweb.tools.inspect('grafana.inspect_traces');

console.log(plan.nextAction);
console.log(tool.inputSchema);

Tool Card

Tool idgrafana.inspect_traces
ProviderGrafana (grafana)
Tool nameinspect_traces
Activationwarm
Healthhealthy
Trust score1.00
Transportstreamable_http
Latencynot yet measured
Costunknown

Requirements and Governance

Authstatic_fields
Credentialsetup_required
Workspaceglobal
Approvalnone
RiskREAD
Permissionsread
Credential setup/api/mcp-warehouse/credentials/grafana/init

Schemas

{
  "type": "object",
  "properties": {
    "datasource_uid": {
      "type": "string",
      "description": "Tempo datasource UID to query through Grafana datasource proxy."
    },
    "query": {
      "type": "string",
      "description": "TraceQL query."
    },
    "start": {
      "type": "string",
      "description": "ISO-8601 or unix timestamp lower bound."
    },
    "end": {
      "type": "string",
      "description": "ISO-8601 or unix timestamp upper bound."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum trace results (default 20, max 100)."
    },
    "most_recent": {
      "type": "boolean",
      "description": "Optional Tempo search hint to prefer the most recent matching traces."
    }
  },
  "required": [
    "datasource_uid",
    "query"
  ],
  "additionalProperties": false
}

Examples

[
  {
    "objective": "Use Grafana inspect traces in an agent workflow.",
    "args": {
      "datasource_uid": "<datasource_uid>",
      "query": "<query>",
      "start": "<start>",
      "end": "<end>"
    }
  }
]
Back to MCP Tool Cards