{"record":{"id":"b328d994c2b51c67","repo":"run-llama/llama_index","slug":"arizephoenixcallbackhandler-is-not-installed-plea","errorCode":null,"errorMessage":"ArizePhoenixCallbackHandler is not installed. Please install it using `pip install llama-index-callbacks-arize-phoenix`","messagePattern":"ArizePhoenixCallbackHandler is not installed\\. Please install it using `pip install llama-index-callbacks-arize-phoenix`","errorType":"exception","errorClass":"ImportError","httpStatus":null,"severity":"error","filePath":"llama-index-core/llama_index/core/callbacks/global_handlers.py","lineNumber":50,"sourceCode":"    elif eval_mode == \"openinference\":\n        try:\n            from llama_index.callbacks.openinference import (\n                OpenInferenceCallbackHandler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"OpenInferenceCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-openinference`\"\n            )\n\n        handler = OpenInferenceCallbackHandler(**eval_params)\n    elif eval_mode == \"arize_phoenix\":\n        try:\n            from llama_index.callbacks.arize_phoenix import (\n                arize_phoenix_callback_handler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"ArizePhoenixCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-arize-phoenix`\"\n            )\n\n        handler = arize_phoenix_callback_handler(**eval_params)\n    elif eval_mode == \"honeyhive\":\n        try:\n            from llama_index.callbacks.honeyhive import (\n                honeyhive_callback_handler,\n            )  # pants: no-infer-dep\n        except ImportError:\n            raise ImportError(\n                \"HoneyHiveCallbackHandler is not installed. \"\n                \"Please install it using `pip install llama-index-callbacks-honeyhive`\"\n            )\n        handler = honeyhive_callback_handler(**eval_params)\n    elif eval_mode == \"promptlayer\":\n        try:","sourceCodeStart":32,"sourceCodeEnd":68,"githubUrl":"https://github.com/run-llama/llama_index/blob/afd0fef371831f9bda13e5af7167cf4e981278ab/llama-index-core/llama_index/core/callbacks/global_handlers.py#L32-L68","documentation":"Raised by create_global_handler() when eval_mode is 'arize_phoenix' but llama-index-callbacks-arize-phoenix is absent. The Arize Phoenix tracing integration is optional; the lazy import of arize_phoenix_callback_handler is wrapped in try/except ImportError and re-raised with the exact install command.","triggerScenarios":"create_global_handler('arize_phoenix', ...) or set_global_handler('arize_phoenix') in an environment lacking the wheel; the inner `from llama_index.callbacks.arize_phoenix import arize_phoenix_callback_handler` import fails.","commonSituations":"Following Phoenix quickstarts that assume pip install arize-phoenix also installed the LlamaIndex integration (it did not); new environments provisioned from a bare llama-index-core requirement.","solutions":["pip install llama-index-callbacks-arize-phoenix","Verify: python -c \"from llama_index.callbacks.arize_phoenix import arize_phoenix_callback_handler\"","Also run a Phoenix server/endpoint if you actually want trace collection","Remove the arize_phoenix eval mode if unused"],"exampleFix":"# before\nset_global_handler('arize_phoenix')  # ImportError\n\n# after\n# pip install llama-index-callbacks-arize-phoenix\nset_global_handler('arize_phoenix')","handlingStrategy":"validation","validationCode":"import importlib.util\nif importlib.util.find_spec('llama_index.callbacks.arize_phoenix') is None:\n    raise SystemExit('pip install llama-index-callbacks-arize-phoenix')","typeGuard":null,"tryCatchPattern":"try:\n    handler = create_global_handler('arize_phoenix')\nexcept ImportError as e:\n    logger.warning('Phoenix tracing off: %s', e)\n    handler = None","preventionTips":["Treat observability integrations as first-class dependencies in deployment manifests","Verify optional imports in a pre-deploy check script"],"tags":["llama-index","callbacks","import-error","optional-dependency","arize-phoenix"],"backgroundTag":null,"analyzedSha":"afd0fef371831f9bda13e5af7167cf4e981278ab","analyzedAt":"2026-08-15T05:42:58.429Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}