Skip to main content

span_billing_info

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

Overview​

Namespan_billing_info
TypeResource
Idsumologic.tracing.span_billing_info

Fields​

The following fields are returned by SELECT queries:

Billing information of the span with the given identifier.

NameDatatypeDescription
billed_bytesintegerNumber of bytes that were charged for the span. (wire: billedBytes)
billed_formatstringBilling format of the span. Number of bytes of this representation of the span is equal to billedBytes. (example: traceId=2ff9c457b1aa00f4;spanId=97872e33215c4275;parentSpanId=98bcdfc5da874c40;operation=spanId-97872e33215c4275;startTimestamp=1603283111874000000;endTimestamp=1603283112268000000;service=ServiceA;status.code=ERROR;status.message=ERROR;kind=SERVER;custom-tag-2=value2;_sourcehost=127.0.0.1;url.full=https:​//example.com/api/operation-x;message=Some error message;_sourcecategory=Http Input;custom-tag-1=value1;error=true;_sourcename=Http Input;error.kind=InvalidInput;_collector=trace-generator-collector;http.request.method=GET;) (wire: billedFormat)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselecttrace_id, span_id, regionGet the billing information of the span.

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
regionstringSumo Logic deployment (au, ca, ch, de, eu, fed, in, jp, kr, us1, us2). Resolved from the SUMOLOGIC_ENVIRONMENT environment variable when it is set (x-stackQL-envVar, the same variable the Terraform provider reads); otherwise defaults to us2. A WHERE region = '...' value always takes precedence. (enum: [au, ca, ch, de, eu, fed, in, jp, kr, us1, us2], default: us2, x-stackQL-envVar: SUMOLOGIC_ENVIRONMENT)
span_idstringIdentifier of the span to get the billing info. (wire: spanId)
trace_idstringIdentifier of the trace the span belongs to. (wire: traceId)

SELECT examples​

Get the billing information of the span.

SELECT
billed_bytes,
billed_format
FROM sumologic.tracing.span_billing_info
WHERE trace_id = '{{ trace_id }}' -- required
AND span_id = '{{ span_id }}' -- required
AND region = '{{ region }}' -- required unless SUMOLOGIC_ENVIRONMENT is set
;