# Phoenix Otel Development

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

- Skill: `arize-ai-phoenix/phoenix-otel-development` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add arize-ai-phoenix/phoenix-otel-development`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arize-ai-phoenix/phoenix-otel-development/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: arize-ai (https://skillmd.com/u/arize-ai-phoenix)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/arize-ai-phoenix/phoenix-otel-development

---


# 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**.