get_traces_overview
Analyze distributed tracing data to monitor trace volume, error rates, latency percentiles, and service dependencies across applications.
Instructions
Get distributed tracing overview.
Returns a summary of distributed traces across all applications:
Trace volume and trends
Error rates
Latency percentiles
Service dependencies
Args: project_id: Project ID query: Search/filter query (optional)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| query | No |
Implementation Reference
- src/mcp_coroot/server.py:456-486 (handler)The primary handler for the 'get_traces_overview' MCP tool. Includes the @mcp.tool() decorator for registration, error handling, the implementation logic that invokes the CorootClient, and the tool docstring serving as input schema definition.@handle_errors async def get_traces_overview_impl( project_id: str, query: str | None = None, ) -> dict[str, Any]: """Get traces overview.""" overview = await get_client().get_traces_overview(project_id, query) return { "success": True, "overview": overview, } @mcp.tool() async def get_traces_overview( project_id: str, query: str | None = None, ) -> dict[str, Any]: """Get distributed tracing overview. Returns a summary of distributed traces across all applications: - Trace volume and trends - Error rates - Latency percentiles - Service dependencies Args: project_id: Project ID query: Search/filter query (optional) """ return await get_traces_overview_impl(project_id, query) # type: ignore[no-any-return]
- src/mcp_coroot/client.py:520-544 (helper)Supporting utility in CorootClient that makes the authenticated HTTP GET request to the Coroot API endpoint '/api/project/{project_id}/overview/traces' and returns the parsed JSON response.async def get_traces_overview( self, project_id: str, query: str | None = None, ) -> dict[str, Any]: """Get distributed tracing overview. Args: project_id: Project ID. query: Search/filter query. Returns: Traces overview data. """ params = {} if query: params["query"] = query response = await self._request( "GET", f"/api/project/{project_id}/overview/traces", params=params, ) data: dict[str, Any] = response.json() return data