crank/docs/observability.md

Журналы и использование

Crank сохраняет данные о тестовых запусках и вызовах опубликованных MCP-инструментов.

Журналы

В журнал попадают:

• операция;
• агент, если вызов пришел через MCP;
• request id;
• статус;
• HTTP status code внешнего API;
• время выполнения;
• краткий preview запроса и ответа;
• категория ошибки, если вызов завершился ошибкой.

При обновлении опубликованного MCP-каталога отдельное событие published agent catalog analyzed содержит tool_count, serialized_bytes, estimated_context_tokens, largest_tool_estimated_context_tokens, recommended_context_tokens, exceeds_recommended_budget и число предупреждений качества. По этим полям можно заметить рост цены tools/list до того, как он ухудшит выбор инструментов моделью.

Использование

Раздел использования агрегирует:

• количество вызовов;
• успешные и ошибочные вызовы;
• долю ошибок;
• задержки p50, p95 и p99;
• распределение вызовов по операциям.

Для чего это нужно

• проверить, вызывают ли агенты нужные инструменты;
• увидеть ошибки маппинга или внешнего API;
• найти медленные endpoint-ы;
• понять, какие инструменты реально используются.