{"id":"7febe91c-d1e1-4e70-bc53-9adafb2cb257","shortId":"qgkG4n","kind":"skill","title":"Phoenix Tracing","tagline":"Awesome Copilot skill by Github","description":"# Phoenix Tracing\n\nComprehensive guide for instrumenting LLM applications with OpenInference tracing in Phoenix. Contains reference files covering setup, instrumentation, span types, and production deployment.\n\n## When to Apply\n\nReference these guidelines when:\n\n- Setting up Phoenix tracing (Python or TypeScript)\n- Creating custom spans for LLM operations\n- Adding attributes following OpenInference conventions\n- Deploying tracing to production\n- Querying and analyzing trace data\n\n## Reference Categories\n\n| Priority | Category        | Description                    | Prefix                     |\n| -------- | --------------- | ------------------------------ | -------------------------- |\n| 1        | Setup           | Installation and configuration | `setup-*`                  |\n| 2        | Instrumentation | Auto and manual tracing        | `instrumentation-*`        |\n| 3        | Span Types      | 9 span kinds with attributes   | `span-*`                   |\n| 4        | Organization    | Projects and sessions          | `projects-*`, `sessions-*` |\n| 5        | Enrichment      | Custom metadata                | `metadata-*`               |\n| 6        | Production      | Batch processing, masking      | `production-*`             |\n| 7        | Feedback        | Annotations and evaluation     | `annotations-*`            |\n\n## Quick Reference\n\n### 1. Setup (START HERE)\n\n- [setup-python](references/setup-python.md) - Install arize-phoenix-otel, configure endpoint\n- [setup-typescript](references/setup-typescript.md) - Install @arizeai/phoenix-otel, configure endpoint\n\n### 2. Instrumentation\n\n- [instrumentation-auto-python](references/instrumentation-auto-python.md) - Auto-instrument OpenAI, LangChain, etc.\n- [instrumentation-auto-typescript](references/instrumentation-auto-typescript.md) - Auto-instrument supported frameworks\n- [instrumentation-manual-python](references/instrumentation-manual-python.md) - Custom spans with decorators\n- [instrumentation-manual-typescript](references/instrumentation-manual-typescript.md) - Custom spans with wrappers\n\n### 3. Span Types (with full attribute schemas)\n\n- [span-llm](references/span-llm.md) - LLM API calls (model, tokens, messages, cost)\n- [span-chain](references/span-chain.md) - Multi-step workflows and pipelines\n- [span-retriever](references/span-retriever.md) - Document retrieval (documents, scores)\n- [span-tool](references/span-tool.md) - Function/API calls (name, parameters)\n- [span-agent](references/span-agent.md) - Multi-step reasoning agents\n- [span-embedding](references/span-embedding.md) - Vector generation\n- [span-reranker](references/span-reranker.md) - Document re-ranking\n- [span-guardrail](references/span-guardrail.md) - Safety checks\n- [span-evaluator](references/span-evaluator.md) - LLM evaluation\n\n### 4. Organization\n\n- [projects-python](references/projects-python.md) / [projects-typescript](references/projects-typescript.md) - Group traces by application\n- [sessions-python](references/sessions-python.md) / [sessions-typescript](references/sessions-typescript.md) - Track conversations\n\n### 5. Enrichment\n\n- [metadata-python](references/metadata-python.md) / [metadata-typescript](references/metadata-typescript.md) - Custom attributes\n\n### 6. Production (CRITICAL)\n\n- [production-python](references/production-python.md) / [production-typescript](references/production-typescript.md) - Batch processing, PII masking\n\n### 7. Feedback\n\n- [annotations-overview](references/annotations-overview.md) - Feedback concepts\n- [annotations-python](references/annotations-python.md) / [annotations-typescript](references/annotations-typescript.md) - Add feedback to spans\n\n### Reference Files\n\n- [fundamentals-overview](references/fundamentals-overview.md) - Traces, spans, attributes basics\n- [fundamentals-required-attributes](references/fundamentals-required-attributes.md) - Required fields per span type\n- [fundamentals-universal-attributes](references/fundamentals-universal-attributes.md) - Common attributes (user.id, session.id)\n- [fundamentals-flattening](references/fundamentals-flattening.md) - JSON flattening rules\n- [attributes-messages](references/attributes-messages.md) - Chat message format\n- [attributes-metadata](references/attributes-metadata.md) - Custom metadata schema\n- [attributes-graph](references/attributes-graph.md) - Agent workflow attributes\n- [attributes-exceptions](references/attributes-exceptions.md) - Error tracking\n\n## Common Workflows\n\n- **Quick Start**: setup-{lang} → instrumentation-auto-{lang} → Check Phoenix\n- **Custom Spans**: setup-{lang} → instrumentation-manual-{lang} → span-{type}\n- **Session Tracking**: sessions-{lang} for conversation grouping patterns\n- **Production**: production-{lang} for batching, masking, and deployment\n\n## How to Use This Skill\n\n**Navigation Patterns:**\n\n```bash\n# By category prefix\nreferences/setup-*              # Installation and configuration\nreferences/instrumentation-*    # Auto and manual tracing\nreferences/span-*               # Span type specifications\nreferences/sessions-*           # Session tracking\nreferences/production-*         # Production deployment\nreferences/fundamentals-*       # Core concepts\nreferences/attributes-*         # Attribute specifications\n\n# By language\nreferences/*-python.md          # Python implementations\nreferences/*-typescript.md      # TypeScript implementations\n```\n\n**Reading Order:**\n1. Start with setup-{lang} for your language\n2. Choose instrumentation-auto-{lang} OR instrumentation-manual-{lang}\n3. Reference span-{type} files as needed for specific operations\n4. See fundamentals-* files for attribute specifications\n\n## References\n\n**Phoenix Documentation:**\n\n- [Phoenix Documentation](https://docs.arize.com/phoenix)\n- [OpenInference Spec](https://github.com/Arize-ai/openinference/tree/main/spec)\n\n**Python API Documentation:**\n\n- [Python OTEL Package](https://arize-phoenix.readthedocs.io/projects/otel/en/latest/) - `arize-phoenix-otel` API reference\n- [Python Client Package](https://arize-phoenix.readthedocs.io/projects/client/en/latest/) - `arize-phoenix-client` API reference\n\n**TypeScript API Documentation:**\n\n- [TypeScript Packages](https://arize-ai.github.io/phoenix/) - `@arizeai/phoenix-otel`, `@arizeai/phoenix-client`, and other TypeScript packages","tags":["phoenix","tracing","awesome","copilot","github"],"capabilities":["skill","source-github","category-awesome-copilot"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/phoenix-tracing","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"install_from":"skills.sh"}},"qualityScore":"0.300","qualityRationale":"deterministic score 0.30 from registry signals: · indexed on skills.sh · published under github/awesome-copilot","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill:v1","enrichmentVersion":1,"enrichedAt":"2026-04-22T02:40:28.776Z","embedding":null,"createdAt":"2026-04-18T20:36:19.503Z","updatedAt":"2026-04-22T02:40:28.776Z","lastSeenAt":"2026-04-22T02:40:28.776Z","tsv":"'/arize-ai/openinference/tree/main/spec)':531 '/phoenix)':526 '/phoenix/)':566 '/projects/client/en/latest/)':552 '/projects/otel/en/latest/)':540 '1':72,120,483 '2':78,143,491 '3':85,184,502 '4':94,263,512 '5':101,287 '6':106,299 '7':112,314 '9':88 'ad':52 'add':330 'agent':230,236,388 'analyz':63 'annot':114,117,317,323,327 'annotations-overview':316 'annotations-python':322 'annotations-typescript':326 'api':196,533,545,557,560 'appli':34 'applic':15,276 'ariz':130,542,554 'arize-ai.github.io':565 'arize-ai.github.io/phoenix/)':564 'arize-phoenix-cli':553 'arize-phoenix-otel':129,541 'arize-phoenix.readthedocs.io':539,551 'arize-phoenix.readthedocs.io/projects/client/en/latest/)':550 'arize-phoenix.readthedocs.io/projects/otel/en/latest/)':538 'arizeai/phoenix-client':568 'arizeai/phoenix-otel':140,567 'attribut':53,92,189,298,342,347,357,360,371,378,385,390,392,469,517 'attributes-except':391 'attributes-graph':384 'attributes-messag':370 'attributes-metadata':377 'auto':80,147,151,158,162,405,451,495 'auto-instru':150,161 'awesom':3 'bash':442 'basic':343 'batch':108,310,431 'call':197,225 'categori':67,69,444 'category-awesome-copilot' 'chain':204 'chat':374 'check':256,407 'choos':492 'client':548,556 'common':359,397 'comprehens':10 'concept':321,467 'configur':76,133,141,449 'contain':21 'convent':56 'convers':286,424 'copilot':4 'core':466 'cost':201 'cover':24 'creat':46 'critic':301 'custom':47,103,171,180,297,381,409 'data':65 'decor':174 'deploy':31,57,434,464 'descript':70 'docs.arize.com':525 'docs.arize.com/phoenix)':524 'document':216,218,247,521,523,534,561 'embed':239 'endpoint':134,142 'enrich':102,288 'error':395 'etc':155 'evalu':116,259,262 'except':393 'feedback':113,315,320,331 'field':350 'file':23,335,506,515 'flatten':365,368 'follow':54 'format':376 'framework':165 'full':188 'function/api':224 'fundament':337,345,355,364,514 'fundamentals-flatten':363 'fundamentals-overview':336 'fundamentals-required-attribut':344 'fundamentals-universal-attribut':354 'generat':242 'github':7 'github.com':530 'github.com/arize-ai/openinference/tree/main/spec)':529 'graph':386 'group':273,425 'guardrail':253 'guid':11 'guidelin':37 'implement':476,480 'instal':74,128,139,447 'instrument':13,26,79,84,144,146,152,157,163,167,176,404,414,494,499 'instrumentation-auto':403,493 'instrumentation-auto-python':145 'instrumentation-auto-typescript':156 'instrumentation-manu':413,498 'instrumentation-manual-python':166 'instrumentation-manual-typescript':175 'json':367 'kind':90 'lang':402,406,412,416,422,429,487,496,501 'langchain':154 'languag':472,490 'llm':14,50,193,195,261 'manual':82,168,177,415,453,500 'mask':110,313,432 'messag':200,372,375 'metadata':104,105,290,294,379,382 'metadata-python':289 'metadata-typescript':293 'model':198 'multi':207,233 'multi-step':206,232 'name':226 'navig':440 'need':508 'openai':153 'openinfer':17,55,527 'oper':51,511 'order':482 'organ':95,264 'otel':132,536,544 'overview':318,338 'packag':537,549,563,572 'paramet':227 'pattern':426,441 'per':351 'phoenix':1,8,20,41,131,408,520,522,543,555 'pii':312 'pipelin':211 'prefix':71,445 'prioriti':68 'process':109,311 'product':30,60,107,111,300,303,307,427,428,463 'production-python':302 'production-typescript':306 'project':96,99,266,270 'projects-python':265 'projects-typescript':269 'python':43,126,148,169,267,279,291,304,324,475,532,535,547 'python.md':474 'queri':61 'quick':118,399 'rank':250 're':249 're-rank':248 'read':481 'reason':235 'refer':22,35,66,119,334,473,477,503,519,546,558 'references/annotations-overview.md':319 'references/annotations-python.md':325 'references/annotations-typescript.md':329 'references/attributes-':468 'references/attributes-exceptions.md':394 'references/attributes-graph.md':387 'references/attributes-messages.md':373 'references/attributes-metadata.md':380 'references/fundamentals-':465 'references/fundamentals-flattening.md':366 'references/fundamentals-overview.md':339 'references/fundamentals-required-attributes.md':348 'references/fundamentals-universal-attributes.md':358 'references/instrumentation-':450 'references/instrumentation-auto-python.md':149 'references/instrumentation-auto-typescript.md':160 'references/instrumentation-manual-python.md':170 'references/instrumentation-manual-typescript.md':179 'references/metadata-python.md':292 'references/metadata-typescript.md':296 'references/production-':462 'references/production-python.md':305 'references/production-typescript.md':309 'references/projects-python.md':268 'references/projects-typescript.md':272 'references/sessions-':459 'references/sessions-python.md':280 'references/sessions-typescript.md':284 'references/setup-':446 'references/setup-python.md':127 'references/setup-typescript.md':138 'references/span-':455 'references/span-agent.md':231 'references/span-chain.md':205 'references/span-embedding.md':240 'references/span-evaluator.md':260 'references/span-guardrail.md':254 'references/span-llm.md':194 'references/span-reranker.md':246 'references/span-retriever.md':215 'references/span-tool.md':223 'requir':346,349 'rerank':245 'retriev':214,217 'rule':369 'safeti':255 'schema':190,383 'score':219 'see':513 'session':98,100,278,282,419,421,460 'session.id':362 'sessions-python':277 'sessions-typescript':281 'set':39 'setup':25,73,77,121,125,136,401,411,486 'setup-python':124 'setup-typescript':135 'skill':5,439 'source-github' 'span':27,48,86,89,93,172,181,185,192,203,213,221,229,238,244,252,258,333,341,352,410,417,456,504 'span-ag':228 'span-chain':202 'span-embed':237 'span-evalu':257 'span-guardrail':251 'span-llm':191 'span-rerank':243 'span-retriev':212 'span-tool':220 'spec':528 'specif':458,470,510,518 'start':122,400,484 'step':208,234 'support':164 'token':199 'tool':222 'trace':2,9,18,42,58,64,83,274,340,454 'track':285,396,420,461 'type':28,87,186,353,418,457,505 'typescript':45,137,159,178,271,283,295,308,328,479,559,562,571 'typescript.md':478 'univers':356 'use':437 'user.id':361 'vector':241 'workflow':209,389,398 'wrapper':183","prices":[{"id":"63d6c09a-7d47-4d01-9100-7ac5210bac5e","listingId":"7febe91c-d1e1-4e70-bc53-9adafb2cb257","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"github","category":"awesome-copilot","install_from":"skills.sh"},"createdAt":"2026-04-18T20:36:19.503Z"}],"sources":[{"listingId":"7febe91c-d1e1-4e70-bc53-9adafb2cb257","source":"github","sourceId":"github/awesome-copilot/phoenix-tracing","sourceUrl":"https://github.com/github/awesome-copilot/tree/main/skills/phoenix-tracing","isPrimary":false,"firstSeenAt":"2026-04-18T21:50:27.815Z","lastSeenAt":"2026-04-22T00:52:13.922Z"},{"listingId":"7febe91c-d1e1-4e70-bc53-9adafb2cb257","source":"skills_sh","sourceId":"github/awesome-copilot/phoenix-tracing","sourceUrl":"https://skills.sh/github/awesome-copilot/phoenix-tracing","isPrimary":true,"firstSeenAt":"2026-04-18T20:36:19.503Z","lastSeenAt":"2026-04-22T02:40:28.776Z"}],"details":{"listingId":"7febe91c-d1e1-4e70-bc53-9adafb2cb257","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"github","slug":"phoenix-tracing","source":"skills_sh","category":"awesome-copilot","skills_sh_url":"https://skills.sh/github/awesome-copilot/phoenix-tracing"},"updatedAt":"2026-04-22T02:40:28.776Z"}}