Начало работы с логами приложений
Monium Logs — распределенная и высокодоступная система для хранения, поиска, визуализации и анализа логов. Система входит в платформу Monium и использует ее базовые компоненты — управление доступом, модель данных и единый интерфейс.
Этот раздел содержит общие сведения о передаче и просмотре логов из вашего приложения в Monium.
Для ресурсов Yandex Cloud см. раздел Начало работы с логами ресурсов Yandex Cloud.
Поставка логов
Если вы еще не работали с облаком Yandex Cloud или у вас нет приложения, на котором можно проверить отправку логов, перейдите к разделу Как начать работать с Monium. Там описана базовая настройка окружения и поставка телеметрии с помощью Otel Collector.
Поставка логов в Monium настраивается так же, как и другие виды телеметрии. Данные принимаются в формате OpenTelemetry, поэтому для отправки логов можно использовать любой агент или коллектор, который его поддерживает, либо передавать данные напрямую из приложения.
Если облако и приложение уже настроены и вы работали с поставкой телеметрии ранее, настройте отправку логов по параметрам ниже.
Параметры Monium Logs
-
Формат поставки данных в Monium — OpenTelemetry (OTLP)
. -
Адрес для записи логов:
ingest.monium.yandex.cloud:443. -
Аутентификация:
- Сервисный аккаунт с ролью
monium.logs.writerили общей рольюmonium.telemetry.writer. - API-ключ с областью действия
yc.monium.logs.writeилиyc.monium.telemetry.write.
- Сервисный аккаунт с ролью
-
В заголовке: параметр
x-monium-project=<идентификатор_проекта>.Это может быть проект облака (
cloud__<идентификатор_облака>), каталога (folder__<идентификатор_каталога>) или другой проект. -
В атрибутах ресурса
OTEL_RESOURCE_ATTRIBUTES:clusterилиdeployment.nameиserviceилиservice.name.Если кластер не указан, то по умолчанию
cluster = default.
Просмотр логов
-
На главной странице сервиса Monium
слева выберите Логи. -
Вверху на шкале времени задайте промежуток поиска данных.
-
В строке поиска введите запрос для поиска логов приложения:
-
project = <идентификатор_проекта>— выберите проект, заданный в параметреx-monium-projectв конфигурации передачи телеметрии приложения.Это может быть проект облака (
cloud__<идентификатор_облака>), каталога (folder__<идентификатор_каталога>) или другой проект. -
cluster = <имя_кластера>— выберите имя инсталляции, в которой запущено ваше приложение. Если кластер не задан, то по умолчаниюcluster = default. -
service = <имя_сервиса>— имя вашего приложения или сервиса. Может передаваться в переменной окруженияOTEL_SERVICE_NAME.Если нужных меток нет в подсказках, их можно ввести вручную. Но, скорее всего, в систему не поступали данные с такими метками. Решение возможных проблем см. в разделе Устранение неполадок при поставке данных.
-
-
Нажмите Выполнить запрос.
-
Чтобы посмотреть логи для определенной записи, раскройте ее.
Подробнее о работе с логами см. раздел Поиск и анализ логов.
Сервисный дашборд для логов
Система автоматически собирает метрики о поступающих логах — объем данных, задержки доставки, количество ошибок по уровням и так далее.
Графики о поступивших логах доступны на сервисном дашборде.