Skip to main content

Sumo Logic Tracing APIs

The Tracing APIs give you the ability to browse and execute queries for traces and span analytics, and request a service map of your application environment.

Refer to Getting Started for Authentication and Endpoint information.

Sumo Logic has several deployment types, which vary by geographic location and the date an account is created. Select the documentation link below that corresponds to your deployment. If you're not sure, see How to determine your endpoint.

APIDocumentation URL
Traceshttps://api.sumologic.com/docs/#tag/traces
Span Analyticshttps://api.sumologic.com/docs/#tag/spanAnalytics
Service Maphttps://api.sumologic.com/docs/#tag/serviceMap

Service Map API

The Service Map API allows you to fetch a graph representation of the Service Map, which is a high-level view of your application environment, automatically derived from tracing data. For more information see Service Map.

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.

An HTTP 301 Moved error suggests that the wrong endpoint was specified.

Errors

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

CodeErrorDescription
301movedThe requested resource SHOULD be accessed through returned URI in Location Header.
401unauthorizedCredential could not be verified.
403forbiddenThis operation is not allowed for your account type.
404notfoundRequested resource could not be found.
405method.unsupportedUnsupported method for URL.
415contenttype.invalidInvalid content type.
429rate.limit.exceededThe API request rate is higher than 4 request per second.
500internal.errorInternal server error.
503service.unavailableService is currently unavailable.

Documentation

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:

DeploymentDocumentation URL
AUhttps://api.au.sumologic.com/docs/#tag/serviceMap
CAhttps://api.ca.sumologic.com/docs/#tag/serviceMap
DEhttps://api.de.sumologic.com/docs/#tag/serviceMap
EUhttps://api.eu.sumologic.com/docs/#tag/serviceMap
FEDhttps://api.fed.sumologic.com/docs/#tag/serviceMap
INhttps://api.in.sumologic.com/docs/#tag/serviceMap
JPhttps://api.jp.sumologic.com/docs/#tag/serviceMap
US1https://api.sumologic.com/docs/#tag/serviceMap
US2https://api.us2.sumologic.com/docs/#tag/serviceMap

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. 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.

An HTTP 301 Moved error suggests that the wrong endpoint was specified.

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

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

CodeErrorDescription
301movedThe requested resource SHOULD be accessed through returned URI in Location Header.
401unauthorizedCredential could not be verified.
403forbiddenThis operation is not allowed for your account type.
404notfoundRequested resource could not be found.
405method.unsupportedUnsupported method for URL.
415contenttype.invalidInvalid content type.
429rate.limit.exceededThe API request rate is higher than 4 request per second.
500internal.errorInternal server error.
503service.unavailableService is currently unavailable.

Documentation

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:

DeploymentDocumentation URL
AUhttps://api.au.sumologic.com/docs/#tag/spanAnalytics
CAhttps://api.ca.sumologic.com/docs/#tag/spanAnalytics
DEhttps://api.de.sumologic.com/docs/#tag/spanAnalytics
EUhttps://api.eu.sumologic.com/docs/#tag/spanAnalytics
FEDhttps://api.fed.sumologic.com/docs/#tag/spanAnalytics
INhttps://api.in.sumologic.com/docs/#tag/spanAnalytics
JPhttps://api.jp.sumologic.com/docs/#tag/spanAnalytics
US1https://api.sumologic.com/docs/#tag/spanAnalytics
US2https://api.us2.sumologic.com/docs/#tag/spanAnalytics

Traces API

The Traces API allows you to browse traces collected in the system. You can execute queries to find traces matching provided search criteria as well as gather detailed information about individual traces and spans. For more information see View and investigate traces.

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.

An HTTP 301 Moved error suggests that the wrong endpoint was specified.

Session Timeout

While the trace search 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 query 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

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

CodeErrorDescription
301movedThe requested resource SHOULD be accessed through returned URI in Location Header.
401unauthorizedCredential could not be verified.
403forbiddenThis operation is not allowed for your account type.
404notfoundRequested resource could not be found.
405method.unsupportedUnsupported method for URL.
415contenttype.invalidInvalid content type.
429rate.limit.exceededThe API request rate is higher than 4 request per second.
500internal.errorInternal server error.
503service.unavailableService is currently unavailable.

Rate limit throttling

  • A rate limit of four API requests per second (240 requests per minute) applies to all API calls from a user.
  • A rate limit of 10 concurrent requests to any API endpoint applies to an access key. \ If a rate is exceeded, a rate limit exceeded 429 status code is returned.
  • A limit of 10 active concurrent trace search requests applies to your organization. Bear in mind that a single API request can consist of multiple queries and each query is treated as a separate trace search. \ Once you reach the limit of 10 concurrent active searches, attempting an additional search will result in a status code of 429 Too Many Requests telling you that you are over the allowed concurrent search requests limit.
Documentation

21

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:

DeploymentDocumentation URL
AUhttps://api.au.sumologic.com/docs/#tag/traces
CAhttps://api.ca.sumologic.com/docs/#tag/traces
DEhttps://api.de.sumologic.com/docs/#tag/traces
EUhttps://api.eu.sumologic.com/docs/#tag/traces
FEDhttps://api.fed.sumologic.com/docs/#tag/traces
INhttps://api.in.sumologic.com/docs/#tag/traces
JPhttps://api.jp.sumologic.com/docs/#tag/traces
US1https://api.sumologic.com/docs/#tag/traces
US2https://api.us2.sumologic.com/docs/#tag/traces
Sumo Logic YouTubeSumo Logic Twitter
Legal
Privacy Statement
Terms of Use

Copyright © 2022 by Sumo Logic, Inc.