Get Involved
Edit on GitHub

STEAMPIPE_OTEL_LEVEL

Specify which OpenTelemetry data to send via OTLP. Accepted values are:

LevelDescription
ALLSend Metrics and Traces via OTLP
METRICSSend Metrics via OTLP
NONEDo not send OpenTelemetry data (default)
TRACESend Traces via OTLP

Steampipe is instrumented with the Open Telemetry SDK which supports the standard SDK environment variables. If OTEL_EXPORTER_OTLP_ENDPOINT is not specified, Steampipe will default to localhost:4317.

Currently, Steampipe only supports OTLP/gRPC.

The Steampipe Plugin SDK added OpenTelemetry support in version 3.3.0 - plugins must be compiled with v3.3.0 or later.

Usage

Trace a single query and send to default endpoint (localhost:4317):

STEAMPIPE_OTEL_LEVEL=TRACE steampipe query "select * from aws_iam_role"

Turn on Metrics and Tracing for the session:

export OTEL_EXPORTER_OTLP_ENDPOINT=my-otel-collector.mydomain.com:4317
export STEAMPIPE_OTEL_LEVEL=ALL
steampipe query