Skip to main content
skill CX Codex

iii-observability — Claude Code skill: OpenTelemetry tracing and logs

The iii-observability skill gives the iii engine tracing, structured logs, metrics with rollups, alerts, and sampling via OpenTelemetry. Call engine::* functions to emit and query telemetry; bind a log trigger to react to every entry.

no license 195 installs ★ 18,938 updated 2026-11-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add iii-hq/iii --skill iii-observability -a claude-code
Open on GitHub

What iii-observability does

Nine namespaces inside: engine::log::* emits entries by level (info, warn, error), engine::logs::list reads stored logs filtered by time and trace, engine::traces::* returns spans as a list, tree, or grouped by attribute, engine::metrics::list and engine::rollups::list show metrics and aggregates over one-minute, five-minute, or one-hour windows. engine::baggage::* manages OpenTelemetry baggage, engine::health::check and engine::alerts::* inspect engine state and alert rules.

Data flows to a collector via OTLP/gRPC (endpoint, defaults to http://localhost:4317) or stays in memory (exporter: memory or both). Read functions work only with memory or both. TLS turns on automatically for https://; for HTTP/protobuf set OTEL_EXPORTER_OTLP_PROTOCOL=http/protobuf. Collector headers go in OTEL_EXPORTER_OTLP_HEADERS or separately for traces, metrics, and logs.

The log trigger runs a function on every entry in the log pipeline. Set level: error to catch only errors, or omit it to receive everything. The handler's return value is ignored; invocations spawn asynchronously.

What it helps with

  • emit structured logs from a function without calling an external collector
  • run a handler on every log entry in real time
  • read stored spans and metrics filtered by attributes and time
  • propagate OpenTelemetry baggage across calls
  • inspect engine state and alert rules operationally

Example prompts for the agent

  • Log an error with user_id attribute via engine::log::error
  • Show all logs from the last hour at warn level or above
  • Group spans by http.status_code and return counts per group

How to install iii-observability

1Skills CLI (Vercel)

npx skills add iii-hq/iii --skill iii-observability -a claude-code

2Manually: put the files in place

~/.claude/skills/skills/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skills/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about iii-observability

How to install iii-observability in Claude Code?

Run npx skills add iii-hq/iii --skill iii-observability -a claude-code, then npx skills add iii-hq/iii --skill skills -a claude-code and open ~/.claude/skills/skills/SKILL.md.

What does iii-observability do?

The skill adds tracing, logs, metrics, and alerts to the iii engine via OpenTelemetry. Functions engine::* emit and query telemetry; a log trigger reacts to every entry.

Why do read functions return nothing?

Functions like engine::logs::list and engine::traces::* only work when exporter is set to memory or both. With otlp the data lives in your collector and cannot be queried directly.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set8

iii-engine-config iii-engine-config — a skill for Claude Code and Codex that guides engine configuration across Compose files and direct YAML specs. Configures network listeners, sandbox adapters, observer bounds, and RBAC proxies. CX Codex +1 5,200installs iii-error-handling iii-error-handling is a Claude Code skill that reads iii engine and SDK error codes, distinguishes network failures from access denials, and assesses safe retries for remote calls. CX Codex +1 5,000installs iii-sdk-reference Skill with iii SDK reference for Node.js, Python, Rust, Go, and browser environments. Covers worker registration, function calls, observers, channels, logging, and OpenTelemetry with code examples for each language. CX Codex +1 4,900installs iii-core-primitives The iii-core-primitives Claude Code skill covers iii function calls, event observers, and worker management. It applies when an agent needs to register functions, inspect the engine registry, or connect work to an event. CX Codex +1 4,900installs iii-architecture-patterns The iii-architecture-patterns Claude Code skill maps backend requirements to architecture patterns built from iii primitives. It covers queued workflows, observers, event-driven designs, and agent handoffs. CX Codex +1 4,900installs presentation Turns a technical-spec directory into an interactive web presentation. Use it when a specification needs a shareable deck with a clear narrative. CX Codex +1 4,400installs iii-observe A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that teaches the agent how to wire iii functions together with iii.observe. CX Codex +1 1,100installs

Project sponsors

Companies that keep this analytics open