Skip to content

docs: update LlamaIndex observability code to use current Arize Phoenix API#680

Open
octo-patch wants to merge 1 commit into
huggingface:mainfrom
octo-patch:fix/issue-617-llamatrace-endpoint
Open

docs: update LlamaIndex observability code to use current Arize Phoenix API#680
octo-patch wants to merge 1 commit into
huggingface:mainfrom
octo-patch:fix/issue-617-llamatrace-endpoint

Conversation

@octo-patch
Copy link
Copy Markdown

Fixes #617

Problem

The Unit 2.2 (LlamaIndex components) observability section used the old llamatrace.com endpoint and the deprecated llama-index-callbacks-arize-phoenix callback package. The LlamaTrace service has since migrated to app.phoenix.arize.com, and the old authentication method no longer works, causing 401 errors for all users who try to run the tracing code.

Solution

Replace the deprecated callback-based approach with the current OpenTelemetry-based instrumentation:

  • Package: llama-index-callbacks-arize-phoenixopeninference-instrumentation-llama-index arize-phoenix-otel
  • Endpoint: https://llamatrace.com/v1/traceshttps://app.phoenix.arize.com/v1/traces
  • Sign-up URL: https://llamatrace.com/loginhttps://app.phoenix.arize.com
  • API: set_global_handler("arize_phoenix", ...)LlamaIndexInstrumentor().instrument(...) via OpenTelemetry

The new approach uses phoenix.otel.register + LlamaIndexInstrumentor, which is the officially recommended method in the current Arize Phoenix docs.

Testing

Code example verified against the Arize-ai/phoenix tracing tutorial and current Phoenix documentation.

…ix API (fixes huggingface#617)

The old LlamaTrace endpoint (llamatrace.com) has migrated to
app.phoenix.arize.com and the authentication approach changed, causing
401 errors for users following the Unit 2.2 course material.

Replace the deprecated llama-index-callbacks-arize-phoenix callback
approach with the current openinference-instrumentation-llama-index +
arize-phoenix-otel package, which uses the OpenTelemetry-based
LlamaIndexInstrumentor and the updated endpoint.

Co-Authored-By: Octopus <liyuan851277048@icloud.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[HANDS-ON BUG] Unit 2.2 Error 401 because the LlamaTrace's api has changed

1 participant