phoenix-cli

Debug LLM applications using the Phoenix CLI. Fetch traces, analyze errors, review experiments, and inspect datasets. Use when debugging AI/LLM applications, analyzing trace data, working with Phoenix observability, or investigating LLM performance issues.

1. Zainstaluj Phoenix CLI globalnie za pomocą npm lub użyj go bez instalacji poprzez npx @arizeai/phoenix-cli. Jeśli wolisz instalację globalną, uruchom npm install -g @arizeai/phoenix-cli, a następnie używaj polecenia px. W przeciwnym razie poprzedź każde polecenie prefiksem npx @arizeai/phoenix-cli.

2. Skonfiguruj zmienne środowiskowe, aby połączyć się z instancją Phoenix. Ustaw PHOENIX_HOST na adres serwera (np. http://localhost:6006), PHOENIX_PROJECT na nazwę projektu oraz PHOENIX_API_KEY, jeśli autoryzacja jest włączona. Eksportuj te zmienne w swoim terminalu lub dodaj je do pliku konfiguracyjnego.

3. Pobierz listę śladów wykonania za pomocą px trace list, dodając filtry takie jak --limit dla liczby wyników, --last-n-minutes dla zakresu czasu lub --format raw dla surowego JSON. Na przykład px trace list --limit 20 --format raw --no-progress wyświetli 20 ostatnich śladów.

4. Filtruj ślady po statusie błędu, aby znaleźć problematyczne wykonania. Użyj px trace list --format raw --no-progress | jq '.[] | select(.status == "ERROR")' aby wyświetlić tylko ślady ze statusem ERROR, lub sortuj po czasie trwania: px trace list --format raw --no-progress | jq 'sort_by(-.duration) | .[0:5]' dla pięciu najwolniejszych operacji.

5. Zbadaj szczegóły konkretnego śladu za pomocą px trace get --format raw, a następnie przeanalizuj poszczególne operacje (spany) wewnątrz niego. Filtruj spany po rodzaju (np. --span-kind LLM), statusie (--status-code ERROR) lub nazwie (--name chat_completion) aby szybko zlokalizować problemy.

6. Łącz wyniki z narzędziem jq do zaawansowanej analizy. Zawsze używaj flag --format raw --no-progress podczas piping do jq, aby uniknąć problemów z formatowaniem. Na przykład px span list --trace-id --format raw --no-progress | jq . wyświetli wszystkie operacje dla danego śladu w strukturze JSON.