Skip to main content
Sumo Logic

Span Analytics API

The Span Analytics API allows you to browse spans collected in the system. You can execute queries to find individual spans matching provided search criteria as well as run aggregated span queries and retrieve their results.

The Span Analytics API allows you to browse spans collected in the system. You can execute queries to find individual spans matching provided search criteria as well as run aggregated span queries and retrieve their results. For more information see Spans.

Endpoints for API access 

Sumo Logic has deployments that are assigned depending on the geographic location and the date an account is created. For API access, you must manually direct your API client to the correct Sumo Logic API URL.

See Sumo Logic Endpoints for the list of the URLs.

API authentication 

See API Authentication for a description of options for API authentication.

Session Timeout

While the span analytics query is running you need to request the query status based on the query ID. The API keeps the query alive by either polling for status or gathering results. If the search job is not kept alive by API requests, it is canceled after fifteen minutes. When a query is canceled after fifteen minutes of inactivity, you will get a 404 status.

Errors Edit section

The APIs return operation failures with a description and error code, including the following generic errors that apply to all APIs: 

Code

Error

Description

301

moved

The requested resource SHOULD be accessed through returned URI in Location Header.

401

unauthorized

Credential could not be verified.

403

forbidden

This operation is not allowed for your account type.

404

notfound

Requested resource could not be found.

405

method.unsupported

Unsupported method for URL.

415

contenttype.invalid

Invalid content type.

429

rate.limit.exceeded

The API request rate is higher than 4 request per second.

500

internal.error

Internal server error.

503

service.unavailable

Service is currently unavailable.

API authentication 

See API Authentication for a description of options for API authentication.

Documentation  Edit section

Documentation for OpenAPI built APIs is hosted on each deployment. Sumo Logic has several deployments that are assigned depending on the geographic location and the date an account is created. See how to determine which endpoint to use if you are unsure.

Select the documentation link for your deployment:

Deployment

Documentation URL

AU

https://api.au.sumologic.com/docs/#tag/spanAnalytics 

CA

https://api.ca.sumologic.com/docs/#tag/spanAnalytics 

DE

https://api.de.sumologic.com/docs/#tag/spanAnalytics 

EU

https://api.eu.sumologic.com/docs/#tag/spanAnalytics 

FED

https://api.fed.sumologic.com/docs/#tag/spanAnalytics 

IN

https://api.in.sumologic.com/docs/#tag/spanAnalytics 

JP

https://api.jp.sumologic.com/docs/#tag/spanAnalytics 

US1

https://api.sumologic.com/docs/#tag/spanAnalytics 

US2

https://api.us2.sumologic.com/docs/#tag/spanAnalytics