captureSpan

Reports one span of a trace, with times you measured yourself. Spans with the same traceId form a request's trace waterfall. Most code uses startSpan or the framework integrations instead, which fill these in for you.

Parameters

traceIdstringrequired

The trace it belongs to.

spanIdstringrequired

This span's id, 16 hex characters.

parentSpanIdstring

The span that started this one.

namestringrequired

What it was, such as orders.insert.

servicestring

A category that colours it in the waterfall, such as db.

operationIdstring

The operation it belongs to.

startTimeISO timestamprequired

When it started.

endTimeISO timestamp

When it ended.

statuschoice

ok or error.

Example

import { captureSpan, newSpanId } from "@octri/node";

captureSpan({
  traceId: trace.traceId,
  spanId: newSpanId(),
  parentSpanId: trace.parentSpanId,
  name: "invoice.render",
  service: "pdf",
  startTime: started.toISOString(),
  endTime: new Date().toISOString(),
  status: "ok",
});

In each language

Language	Call
Node	`captureSpan()`
Python	`octri.capture_span()`
Go	`octri.CaptureSpan()`
Ruby	`Octri.capture_span`
Java	`Octri.captureSpan()`
Kotlin	`Octri.captureSpan()`
PHP	`Octri::captureSpan()`
Rust	`octri_monitoring::capture_span()`
Swift	`Octri.captureSpan()`
Dart	`Octri.captureSpan()`

Other functions: init, captureError, captureEvent, traceFromHeader, addScrubFields, setBeforeSend, startSpan, withSpan, instrument, autoInstrument.
Backend SDKs: installing a runtime and its framework integrations.

Parameters

Example

In each language

Related