Диагностика

На этой странице описаны расширенные диагностические процедуры для исследования проблем PRX, которые не удалось решить базовыми шагами по устранению неполадок.

Диагностические команды

prx doctor

Комплексная проверка состояния:

prx doctor

Вывод включает:

• Результаты валидации конфигурации
• Тесты подключения к провайдерам
• Проверку системных зависимостей
• Сводку по использованию ресурсов

prx debug

Включение журналирования уровня debug для подробной трассировки операций:

PRX_LOG=debug prx daemon

Или через конфигурацию:

[observability]
log_level = "debug"

prx info

Отображение системной информации:

prx info

Показывает:

• Версию PRX и информацию о сборке
• ОС и архитектуру
• Настроенные провайдеры и их статус
• Тип и размер бэкенда памяти
• Количество и статус плагинов

Анализ журналов

Журналы PRX имеют структурированный формат JSON (при log_format = "json"). Ключевые поля для анализа:

Поле	Описание
level	Уровень журнала (debug, info, warn, error)
target	Путь модуля Rust
session_id	Связанный идентификатор сессии
provider	Задействованный LLM-провайдер
duration_ms	Длительность операции
error	Детали ошибки (при наличии)

Сетевая диагностика

Проверка подключения к провайдерам:

# Тест API Anthropic
prx provider test anthropic

# Тест всех настроенных провайдеров
prx provider test --all

# Проверка сети из песочницы
prx sandbox test-network

Профилирование производительности

Включите эндпоинт метрик и используйте Prometheus/Grafana для анализа производительности:

[observability.metrics]
enabled = true
bind = "127.0.0.1:9090"

Ключевые метрики для мониторинга:

• prx_llm_request_duration_seconds -- задержка LLM
• prx_sessions_active -- параллельные сессии
• prx_memory_usage_bytes -- потребление памяти

Связанные страницы

• Обзор устранения неполадок
• Наблюдаемость
• Метрики Prometheus