List Traces
list_tracesRead-only
Search and retrieve distributed traces by time range, service, environment, version, latency, or attributes to investigate slow requests and system behavior.
Instructions
Search and retrieve traces from Mackerel for distributed tracing analysis.
š USE THIS TOOL WHEN USERS:
Search for traces within a time range
Find slow traces by latency filtering
Filter traces by service, environment, or version
Investigate distributed system behavior
Filter by latency
list_traces(
serviceName="my-service",
from=1700000000,
to=1700001800,
minLatencyMillis=100,
maxLatencyMillis=1000
)Filter by environment and version
list_traces(
serviceName="my-service",
from=1700000000,
to=1700001800,
environment="production",
version="v1.2.3"
)Search by span name
list_traces(
serviceName="my-service",
from=1700000000,
to=1700001800,
spanName="HTTP GET /api/users"
)Pagination and sorting
list_traces(
serviceName="my-service",
from=1700000000,
to=1700001800,
page=2,
perPage=50,
order={ column: "LATENCY", direction: "DESC" }
)Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | End time for trace search (Unix epoch seconds) | |
| from | Yes | Start time for trace search (Unix epoch seconds) | |
| page | No | Page number (starting from 1). Default is 1 | |
| order | No | Sort preferences. Default is { column: 'START_AT', direction: 'DESC' } | |
| perPage | No | Number of items per page (1-100). Default is 20 | |
| traceId | No | Filter by trace ID (32-digit hexadecimal string) | |
| version | No | Version. Corresponds to `service.version` in OpenTelemetry semantic conventions | |
| spanName | No | Filter by span name | |
| attributes | No | Custom attribute filter conditions | |
| environment | No | Environment name. Corresponds to `deployment.environment` or `deployment.environment.name` in OpenTelemetry semantic conventions | |
| serviceName | Yes | Service name. Corresponds to `service.name` in OpenTelemetry semantic conventions | |
| issueFingerprint | No | Filter by issue fingerprint | |
| maxLatencyMillis | No | Maximum latency in milliseconds | |
| minLatencyMillis | No | Minimum latency in milliseconds | |
| serviceNamespace | No | Service namespace. Corresponds to `service.namespace` in OpenTelemetry semantic conventions | |
| resourceAttributes | No | Resource-level attribute filters |