AI agent skill · by @Arize-ai

Phoenix Otel Development

Guide for the phoenix-otel TypeScript package — OTel registration, stack-based global provider management, and provider lifecycle.

Archived 2026-10-23 · Source updated 2026-10-12 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# Phoenix OTel Development

OpenTelemetry registration and provider lifecycle layer for Phoenix. Single source of truth for OTel configuration — other Phoenix packages delegate here rather than importing OTel packages directly.

Read existing code in the directory you're working in before writing new code.

## Rule Files

| Rule file                            | When to read                                                          |
| ------------------------------------ | --------------------------------------------------------------------- |
| `rules/global-provider-lifecycle.md` | Global provider attachment, detachment, snapshot/restore, mount stack |
| `rules/register-api.md`              | `register()`, span processor setup, public API surface                |
| `rules/testing.md`                   | Tests for provider lifecycle, registration, span export               |

## Build and Test

```bash
cd js/
pnpm --filter phoenix-otel test
```

Dual-module output (CJS + ESM). Tests use **vitest**.