---
title: OpenTelemetry
description: OTEL-native. OpenInference attributes.
---

# OpenTelemetry

Agenko is OTEL-native. We do not invent a proprietary wire format.

## Stack

- **OpenTelemetry** SDK — tracer provider, OTLP/HTTP exporter
- **OpenInference** (Arize) — span kinds and LLM/tool attributes
- **OpenLLMetry / instrumentors** — where we wrap OpenAI, Anthropic, LangChain instead of writing exporters

We wrap a real OpenTelemetry `TracerProvider` — the same OTEL-native pattern modern LLM observability stacks use. Our backend is Postgres-first, not a fork of someone else's data plane.

## Attributes we care about

| Attr | Why |
|---|---|
| `openinference.span.kind` | TOOL / LLM / AGENT / CHAIN |
| `tool.name`, `gen_ai.tool.name` | Actual tool for the receipt |
| `agenko.*` | Receipt, gate, cost, session — see the spec YAML |

Third-party vendor attribute namespaces are **not** our contract. If you dual-export, map attributes at the edge.

## Collector

`AGENKO_ENDPOINT` can point at any OTLP/HTTP traces URL. Default is the Agenko control plane. You can dual-export later; do not replace `init()`'s provider with a second competing global provider unless you know what you are doing.

## Agent instructions

This page: https://docs.agenko.app/opentelemetry.md

Fetch `/llms.txt` for the full index. Search: `GET /api/search-docs?query=...`
