Устранение неполадок при поставке данных
Этот раздел поможет самостоятельно диагностировать и устранить большинство проблем, которые могут возникнуть при поставке данных в Monium.
Monium поддерживает данные в формате OTLP без дополнительной конвертации, поэтому сначала ознакомьтесь с требованиями к конфигурации OTLP и настройкой OTel Collector.
Общие рекомендации по диагностике
При возникновении проблем с отправкой данных в Monium выполните базовые шаги диагностики:
-
Включите логирование. Убедитесь, что в вашем OTLP-клиенте включено подробное логирование для просмотра деталей ошибок. Способ включения логов зависит от конкретной реализации.
-
Проверьте переменные окружения. Убедитесь, что переменные окружения
MONIUM_PROJECTиMONIUM_API_KEYправильно определены и доступны для вашего приложения или OTel Collector.Если вы используете проекты облака или каталога
cloud__<идентификатор_облака>илиfolder__<идентификатор_каталога>, учитывайте, что послеfolderиcloudследуют два нижних подчеркивания. -
Проверьте API-ключ:
- API-ключ действителен и не истек.
- API-ключ имеет область действия
yc.monium.telemetry.write. - Сервисный аккаунт, связанный с API-ключом, имеет роль
monium.telemetry.writer. - Заголовок
Authorizationимеет верный формат:Authorization: Api-Key <API-ключ>.
-
Проверьте конфигурацию проекта в OTEL-экспортере:
- Переменная
MONIUM_PROJECTзадана и имеет верный формат. Проект должен совпадать с именем в URL на главной странице проекта. - В заголовке
x-monium-projectпередается значение переменнойMONIUM_PROJECT. - У API-ключа и сервисного аккаунта есть права на запись в проект.
- Переменная
-
Проверьте сетевую доступность. Для работы с Monium может потребоваться настройка межсетевого экрана в зависимости от вашей сетевой конфигурации. Если соединения по протоколу gRPC блокируются из вашей сети, сконфигурируйте отправку по протоколу
http/protobuf.
Каталог ошибок
В таблице перечислены распространенные ошибки, которые могут возникать при работе с Monium через протокол gRPC.
|
Код gRPC |
Тип ошибки |
Сообщение об ошибке |
Решение |
Примечания |
|
rpc code 3 - InvalidArgument |
Отсутствует заголовок проекта |
|
Добавьте заголовок |
Убедитесь, что переменная |
|
rpc code 7 - Unauthenticated |
Отсутствует заголовок проекта (альтернативное сообщение) |
|
Добавьте заголовок |
Убедитесь, что переменная |
|
rpc code 7 - Unauthenticated |
Отсутствует авторизация |
|
Проверьте, что заголовок |
Добавьте заголовок |
|
rpc code 7 - Unauthenticated |
Отсутствует авторизация |
|
Заголовок |
Убедитесь, что переменная |
|
rpc code 16 - PermissionDenied |
Устаревший API-ключ |
|
Истек срок действия ключа |
Сгенерируйте новый API-ключ и обновите |
|
rpc code 16 - PermissionDenied |
Неизвестный API-ключ |
|
Неизвестный API ключ |
Сгенерируйте новый API-ключ и обновите |
|
rpc code 16 - PermissionDenied |
Невалидный API-ключ |
|
Проверьте корректность API-ключа и формат заголовка |
API-ключ должен передаваться как |
|
rpc code 16 - PermissionDenied |
Недостаточно прав |
|
Проверьте права API-ключа на каталог |
Убедитесь, что указан правильный проект, API-ключ имеет область действия |
|
rpc code 16 - PermissionDenied |
Не найден проект |
|
Проверьте формат имени проекта |
Скопируйте имя проекта из URL на главной странице проекта |
|
rpc code 8 - ResourceExhausted |
Превышена квота на количество хранимых метрик |
|
Увеличьте квоту на количество хранимых метрик |
Обратитесь в техническую поддержку для увеличения лимита метрик в шарде |
|
transport |
Отсутствует сетевой доступ |
|
Убедитесь в сетевой доступности |
В случае блокировки протокола gRPC настройте экспорт по протоколу |
Дополнительная информация
В случае ошибок конфигурации OTel Collector обратитесь к официальной документации OpenTelemetry.
Проверить конфигурацию можно с помощью команды:
otelcol validate --config=otel-collector.yaml