{"id":"7febe91c-d1e1-4e70-bc53-9adafb2cb257","shortId":"qgkG4n","kind":"skill","title":"phoenix-tracing","tagline":"OpenInference semantic conventions and instrumentation for Phoenix AI observability. Use when implementing LLM tracing, creating custom spans, or deploying to production.","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","agent-skills","agents","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"capabilities":["skill","source-github","skill-phoenix-tracing","topic-agent-skills","topic-agents","topic-awesome","topic-custom-agents","topic-github-copilot","topic-hacktoberfest","topic-prompt-engineering"],"categories":["awesome-copilot"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/github/awesome-copilot/phoenix-tracing","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add github/awesome-copilot","source_repo":"https://github.com/github/awesome-copilot","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 33270 github stars · SKILL.md body (6,309 chars)","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-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:52:19.498Z","embedding":null,"createdAt":"2026-04-18T20:36:19.503Z","updatedAt":"2026-05-18T18:52:19.498Z","lastSeenAt":"2026-05-18T18:52:19.498Z","tsv":"'/arize-ai/openinference/tree/main/spec)':548 '/phoenix)':543 '/phoenix/)':583 '/projects/client/en/latest/)':569 '/projects/otel/en/latest/)':557 '1':89,137,500 '2':95,160,508 '3':102,201,519 '4':111,280,529 '5':118,304 '6':123,316 '7':129,331 '9':105 'ad':69 'add':347 'agent':247,253,405 'ai':11 'analyz':80 'annot':131,134,334,340,344 'annotations-overview':333 'annotations-python':339 'annotations-typescript':343 'api':213,550,562,574,577 'appli':51 'applic':32,293 'ariz':147,559,571 'arize-ai.github.io':582 'arize-ai.github.io/phoenix/)':581 'arize-phoenix-cli':570 'arize-phoenix-otel':146,558 'arize-phoenix.readthedocs.io':556,568 'arize-phoenix.readthedocs.io/projects/client/en/latest/)':567 'arize-phoenix.readthedocs.io/projects/otel/en/latest/)':555 'arizeai/phoenix-client':585 'arizeai/phoenix-otel':157,584 'attribut':70,109,206,315,359,364,374,377,388,395,402,407,409,486,534 'attributes-except':408 'attributes-graph':401 'attributes-messag':387 'attributes-metadata':394 'auto':97,164,168,175,179,422,468,512 'auto-instru':167,178 'bash':459 'basic':360 'batch':125,327,448 'call':214,242 'categori':84,86,461 'chain':221 'chat':391 'check':273,424 'choos':509 'client':565,573 'common':376,414 'comprehens':27 'concept':338,484 'configur':93,150,158,466 'contain':38 'convent':6,73 'convers':303,441 'core':483 'cost':218 'cover':41 'creat':18,63 'critic':318 'custom':19,64,120,188,197,314,398,426 'data':82 'decor':191 'deploy':22,48,74,451,481 'descript':87 'docs.arize.com':542 'docs.arize.com/phoenix)':541 'document':233,235,264,538,540,551,578 'embed':256 'endpoint':151,159 'enrich':119,305 'error':412 'etc':172 'evalu':133,276,279 'except':410 'feedback':130,332,337,348 'field':367 'file':40,352,523,532 'flatten':382,385 'follow':71 'format':393 'framework':182 'full':205 'function/api':241 'fundament':354,362,372,381,531 'fundamentals-flatten':380 'fundamentals-overview':353 'fundamentals-required-attribut':361 'fundamentals-universal-attribut':371 'generat':259 'github.com':547 'github.com/arize-ai/openinference/tree/main/spec)':546 'graph':403 'group':290,442 'guardrail':270 'guid':28 'guidelin':54 'implement':15,493,497 'instal':91,145,156,464 'instrument':8,30,43,96,101,161,163,169,174,180,184,193,421,431,511,516 'instrumentation-auto':420,510 'instrumentation-auto-python':162 'instrumentation-auto-typescript':173 'instrumentation-manu':430,515 'instrumentation-manual-python':183 'instrumentation-manual-typescript':192 'json':384 'kind':107 'lang':419,423,429,433,439,446,504,513,518 'langchain':171 'languag':489,507 'llm':16,31,67,210,212,278 'manual':99,185,194,432,470,517 'mask':127,330,449 'messag':217,389,392 'metadata':121,122,307,311,396,399 'metadata-python':306 'metadata-typescript':310 'model':215 'multi':224,250 'multi-step':223,249 'name':243 'navig':457 'need':525 'observ':12 'openai':170 'openinfer':4,34,72,544 'oper':68,528 'order':499 'organ':112,281 'otel':149,553,561 'overview':335,355 'packag':554,566,580,589 'paramet':244 'pattern':443,458 'per':368 'phoenix':2,10,25,37,58,148,425,537,539,560,572 'phoenix-trac':1 'pii':329 'pipelin':228 'prefix':88,462 'prioriti':85 'process':126,328 'product':24,47,77,124,128,317,320,324,444,445,480 'production-python':319 'production-typescript':323 'project':113,116,283,287 'projects-python':282 'projects-typescript':286 'python':60,143,165,186,284,296,308,321,341,492,549,552,564 'python.md':491 'queri':78 'quick':135,416 'rank':267 're':266 're-rank':265 'read':498 'reason':252 'refer':39,52,83,136,351,490,494,520,536,563,575 'references/annotations-overview.md':336 'references/annotations-python.md':342 'references/annotations-typescript.md':346 'references/attributes-':485 'references/attributes-exceptions.md':411 'references/attributes-graph.md':404 'references/attributes-messages.md':390 'references/attributes-metadata.md':397 'references/fundamentals-':482 'references/fundamentals-flattening.md':383 'references/fundamentals-overview.md':356 'references/fundamentals-required-attributes.md':365 'references/fundamentals-universal-attributes.md':375 'references/instrumentation-':467 'references/instrumentation-auto-python.md':166 'references/instrumentation-auto-typescript.md':177 'references/instrumentation-manual-python.md':187 'references/instrumentation-manual-typescript.md':196 'references/metadata-python.md':309 'references/metadata-typescript.md':313 'references/production-':479 'references/production-python.md':322 'references/production-typescript.md':326 'references/projects-python.md':285 'references/projects-typescript.md':289 'references/sessions-':476 'references/sessions-python.md':297 'references/sessions-typescript.md':301 'references/setup-':463 'references/setup-python.md':144 'references/setup-typescript.md':155 'references/span-':472 'references/span-agent.md':248 'references/span-chain.md':222 'references/span-embedding.md':257 'references/span-evaluator.md':277 'references/span-guardrail.md':271 'references/span-llm.md':211 'references/span-reranker.md':263 'references/span-retriever.md':232 'references/span-tool.md':240 'requir':363,366 'rerank':262 'retriev':231,234 'rule':386 'safeti':272 'schema':207,400 'score':236 'see':530 'semant':5 'session':115,117,295,299,436,438,477 'session.id':379 'sessions-python':294 'sessions-typescript':298 'set':56 'setup':42,90,94,138,142,153,418,428,503 'setup-python':141 'setup-typescript':152 'skill':456 'skill-phoenix-tracing' 'source-github' 'span':20,44,65,103,106,110,189,198,202,209,220,230,238,246,255,261,269,275,350,358,369,427,434,473,521 'span-ag':245 'span-chain':219 'span-embed':254 'span-evalu':274 'span-guardrail':268 'span-llm':208 'span-rerank':260 'span-retriev':229 'span-tool':237 'spec':545 'specif':475,487,527,535 'start':139,417,501 'step':225,251 'support':181 'token':216 'tool':239 'topic-agent-skills' 'topic-agents' 'topic-awesome' 'topic-custom-agents' 'topic-github-copilot' 'topic-hacktoberfest' 'topic-prompt-engineering' 'trace':3,17,26,35,59,75,81,100,291,357,471 'track':302,413,437,478 'type':45,104,203,370,435,474,522 'typescript':62,154,176,195,288,300,312,325,345,496,576,579,588 'typescript.md':495 'univers':373 'use':13,454 'user.id':378 'vector':258 'workflow':226,406,415 'wrapper':200","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-05-18T18:52:19.498Z"},{"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-05-07T22:40:43.756Z"}],"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","github":{"repo":"github/awesome-copilot","stars":33270,"topics":["agent-skills","agents","ai","awesome","custom-agents","github-copilot","hacktoberfest","prompt-engineering"],"license":"mit","html_url":"https://github.com/github/awesome-copilot","pushed_at":"2026-05-18T01:26:59Z","description":"Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.","skill_md_sha":"8330ef3b95dad9a04908ef4a5a718c926274bd45","skill_md_path":"skills/phoenix-tracing/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/github/awesome-copilot/tree/main/skills/phoenix-tracing"},"layout":"multi","source":"github","category":"awesome-copilot","frontmatter":{"name":"phoenix-tracing","license":"Apache-2.0","description":"OpenInference semantic conventions and instrumentation for Phoenix AI observability. Use when implementing LLM tracing, creating custom spans, or deploying to production.","compatibility":"Requires Phoenix server. Python skills need arize-phoenix-otel; TypeScript skills need @arizeai/phoenix-otel."},"skills_sh_url":"https://skills.sh/github/awesome-copilot/phoenix-tracing"},"updatedAt":"2026-05-18T18:52:19.498Z"}}