Skip to main content

traces

Creates, updates, deletes, gets or lists a traces resource.

Overview

Nametraces
TypeResource
Idsumologic.tracing.traces

Fields

The following fields are returned by SELECT queries:

Details of the trace with the given identifier.

NameDatatypeDescription
idstringTrace identifier. (example: 00000000000120CB)
criticalPathServiceBreakdownSummaryobject
metricsobjectCalculated trace metrics.
rootOperationNamestringThe name of the operation given to the root span. (example: retrieveAccount)
rootResourcestringRoot resource on which the trace was started. Examples: db.query, http.request, rpc.call, container (example: http.request)
rootServicestringRoot service which started the trace. Examples: user-service, authentication-service, payment-service, /shopping-cart (example: user-service)
rootStatusobject
startedAtstring (date-time)Date and time the trace was started in ISO 8601 / RFC3339 format. (example: 2019-11-22T09:00:00Z)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getTraceselecttraceId, regionGet details of a trace with the given identifier.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringSumoLogic region (enum: [us2, au, ca, de, eu, fed, in, jp], default: us2)
traceIdstringIdentifier of the trace to get the details.

SELECT examples

Get details of a trace with the given identifier.

SELECT
id,
criticalPathServiceBreakdownSummary,
metrics,
rootOperationName,
rootResource,
rootService,
rootStatus,
startedAt
FROM sumologic.tracing.traces
WHERE traceId = '{{ traceId }}' -- required
AND region = '{{ region }}' -- required
;