Observability
The kinds of traces Chalk records, where to view each one, and how to control and export them.
A trace records one request as it moves through your code and Chalk: each operation is a span, with its start time, duration, status, and attributes, and spans nest under the operation that started them. Chalk records traces in the OpenTelemetry format and keeps them in your Chalk environment.
Chalk records these traces:
| Where | What it shows |
|---|---|
| Traces page | Every trace in the current Chalk environment. See Trace Explorer. |
| AI traces page | Only AI traces, with sessions. See AI Traces. |
| Trace tab on an online query’s page | That query’s trace. See Query Traces. |
| Traces tab on a function’s or scaling group’s page | Calls to that function or scaling group. |
You can also read traces with SQL from the chalk.telemetry schema. See
Chalk Catalog Components.
Each kind of trace has its own sampling setting:
OTEL_TRACES_SAMPLER and OTEL_TRACES_SAMPLER_ARG environment variables,
and a single query can request a trace. See
Query Traces.tracing setting. See
Tracing Policy.To send traces to your own monitoring service as well, see Export telemetry over OTLP.