BugSnag: List Spans
bugsnag_list_spansRetrieve individual spans from a span group with filtering, sorting, and pagination to debug performance issues and analyze slow operations.
Instructions
Get individual spans belonging to a span group
Toolset: Performance
Parameters:
projectId (string): Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools.
spanGroupId (string) required: ID of the span group
sort (enum): Field to sort by
direction (enum): Sort direction for ordering results (default: "desc")
perPage (number): How many results to return per page. (default: 30)
nextUrl (string): URL for retrieving the next page of results. Use the value in the previous response to get the next page when more results are available. Only values provided in the output from this tool can be used. Do not attempt to construct it manually.
filters (record<string, array>): Apply filters to narrow down the span group list. Use the List Trace Fields tool to discover available filter fields. Time filters support extended ISO 8601 format (e.g. 2018-05-20T00:00:00Z) or relative format (e.g. 7d, 24h). (default: {"span.since":[{"type":"eq","value":"7d"}]})
Use Cases: 1. Analyze individual slow operations 2. Debug performance issues by examining specific traces 3. Find patterns in operation attributes
Examples:
Get slowest spans for an operation
{
"spanGroupId": "[HttpClient]GET-api.example.com",
"sort": "duration",
"direction": "desc",
"perPage": 10
}Expected Output: Array of the 10 slowest span instances
Get spans filtered by OS with pagination
{
"spanGroupId": "[HttpClient]GET-api.example.com",
"sort": "timestamp",
"filters": {
"os.name": [
{
"type": "eq",
"value": "iOS"
}
]
},
"nextUrl": "/projects/123/spans?offset=30&per_page=30"
}Expected Output: Array of spans from iOS devices with next page navigation
Hints: 1. Sort by duration descending to find the slowest instances 2. Each span includes trace ID for further investigation
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Field to sort by | |
| filters | No | Apply filters to narrow down the span group list. Use the List Trace Fields tool to discover available filter fields. Time filters support extended ISO 8601 format (e.g. 2018-05-20T00:00:00Z) or relative format (e.g. 7d, 24h). | |
| nextUrl | No | URL for retrieving the next page of results. Use the value in the previous response to get the next page when more results are available. Only values provided in the output from this tool can be used. Do not attempt to construct it manually. | |
| perPage | No | How many results to return per page. | |
| direction | No | Sort direction for ordering results | desc |
| projectId | No | Unique identifier of the project. This is optional if a current project is set and is used to set the current project for BugSnag tools. | |
| spanGroupId | Yes | ID of the span group |