Export over OpenTelemetry

asz can send what it collects to an OpenTelemetry receiver, such as the SkyWalking OAP or an OpenTelemetry Collector: every collected file and every conversation round as a log record, and the metrics derived from them. OTLP Records describes what a receiver gets.

Send

Name the receiver in asz.yaml:

export:
  otlp:
    protocol: grpc
    endpoint: 127.0.0.1:11800   # the SkyWalking OAP's gRPC port

For HTTP, set protocol: http and endpoint: http://127.0.0.1:12800. Put a token in headers if the receiver needs one. Configuration lists every setting.

asz collect and asz server then send what is new after every collection. asz push sends everything not sent yet, and exits. Each file is sent once.

Metrics

asz derives these metrics from what it collects, and sends them with the files:

agent.token.usage: the tokens of each Claude Code model call.
agent.mcp.calls and agent.mcp.duration: each call to an MCP server and the time it took. They need the Claude Code plugin.

They are on by default, and derived only when they will be sent: with an endpoint set and export.otlp.metrics on. asz push derives them too, before it sends. The first derivation over a root reaches back three days. To change that, or to turn the metrics off:

metrics:
  enabled: true
  lookback: 72h   # 0 or none sends all the history

Cost, active time, sessions, lines of code, commits, pull requests and edit decisions come only from Claude Code’s own OpenTelemetry exporter, and asz does not receive it. For the SkyWalking OAP, point the exporter at the OAP directly, as Metrics of the agent runtime shows.

Limit the rate

The first send carries the whole history. To spread it out, set a limit:

export:
  otlp:
    max_bytes_per_minute: 10485760   # 10 MiB

Receiver limits

A request carries up to 8 MiB, batch_bytes, and a single larger file goes in a request of its own. The SkyWalking OAP accepts that. An OpenTelemetry Collector accepts only 4 MiB over gRPC unless its receiver sets max_recv_msg_size_mib, as below.

See what a receiver gets

Run an OpenTelemetry Collector that writes what it receives to a file:

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
        max_recv_msg_size_mib: 32
      http:
        endpoint: 0.0.0.0:4318
exporters:
  file:
    path: /out/logs.json
service:
  pipelines:
    logs:
      receivers: [otlp]
      exporters: [file]

Point endpoint at 127.0.0.1:4317, run asz push, and read logs.json.

AI Sessionizer