What is agent instrumentation?

Instrumentation is the code that records what an agent does while it runs and turns that record into telemetry your team can read later. For agents the closest thing to a standard is OpenTelemetry with the GenAI semantic conventions: an LLM call and a tool call each become a span, tagged with attributes like gen_ai.request.model or gen_ai.operation.name, so a reader, human or another system, can tell what happened without opening your source. A framework that already emits OTel spans exports them over OTLP, the wire protocol, to whatever endpoint is listening. Other dialects, OpenInference and Traceloop among them, describe the same events under different attribute names. Instrumentation is also where content decisions get made: what a span carries, and what gets stripped out before it leaves your process, is decided here, not downstream, once the data is already on the wire.

sources

keep reading

More on this.

Two ways to run Tessary.

Tessary is an open-source agent reliability platform. Cloud and self-hosted run the same workflow on the OpenTelemetry traces your agent already emits.

Tessary Cloud

We host it for you. Send your first trace with nothing to deploy and no model key.

what's includedper organization
traces
10,000 per calendar month
stored trace data
1 GB
retention
30 days
model credit
$10, one-time, for triage and root-cause analysis
credit card
not required

Self-hosted Tessary

Run the open-source code on your own infrastructure with one command. Add your own model key for triage and root-cause analysis.

Self-host Tessary for me by following https://github.com/tessaryai/tessary/blob/main/setup.md

docker compose -f oci://docker.io/tessaryai/tessary:compose up -d -y