[Документация Yandex Cloud](../../index.md) > [Monium](../index.md) > Логи > Работа с логами > Поиск и анализ логов # Поиск и анализ логов Интерфейс для работы с логами позволяет: * составлять запросы для поиска и фильтрации логов; * просматривать графики по логам с разными статусами запроса; * просматривать содержимое строк лога; * переходить от логов к исследованию связанных трейсов и спанов через их идентификаторы (если настроена передача трейсов). Чтобы просматривать логи, настройте их доставку: * Для вашего приложения или сервиса организуйте передачу данных в формате OpenTelemetry. Например, с помощью [OTel Collector](../collector/opentelemetry.md) или [Fluent Bit](../collector/fluentbit.md). * Для ресурсов Yandex Cloud включите логирование. Обычно логирование можно настроить при создании или изменении ресурса. Подробнее в документации нужного сервиса. Список сервисов, которые поддерживают автоматический сбор логов, приведен в разделе [Observability-инструменты мониторинга и логирования](../../overview/concepts/monitoring-logging-tools.md). ## Поиск логов {#logs-search} {% list tabs group=instructions %} - Интерфейс Monium {#console} 1. На главной странице [Monium](https://kz.monium.yandex.cloud) слева выберите **Логи**. 1. Вверху задайте промежуток поиска данных одним из способов: * выберите варианты интервалов: `5m`, `30m` и так далее — будут показаны данные за последние 5, 30 минут; * введите интервал времени вручную; * в поле с точным временным промежутком укажите границы **От** и **До**; * на шкале времени перетащите границы промежутка. 1. В строке запроса выберите метки для поиска логов. Телеметрия в Monium организована в иерархии «проект → кластер → сервис». Поэтому сначала в строке запроса выбираются параметры `project`, `cluster` и `service`. * Для поиска логов приложения укажите: * `project = <идентификатор_проекта>` — выберите проект, заданный в параметре `x-monium-project` в конфигурации передачи телеметрии приложения. Это может быть проект облака (`cloud__<идентификатор_облака>`), каталога (`folder__<идентификатор_каталога>`) или другой [проект](../collector/project.md#project-create). * `cluster = <имя_кластера>` — выберите имя инсталляции, в которой запущено ваше приложение. Если кластер не задан, то по умолчанию `cluster = default`. * `service = <имя_сервиса>` — имя вашего приложения или сервиса. Может передаваться в переменной окружения `OTEL_SERVICE_NAME`. Если нужных меток нет в подсказках, их можно ввести вручную. Но, скорее всего, в систему не поступали данные с такими метками. Решение возможных проблем описано в разделе [Устранение неполадок при поставке данных](../collector/troubleshooting.md). * Для поиска логов ресурса Yandex Cloud укажите: * `project = folder__<идентификатор_каталога>` — идентификатор каталога, в котором находится ресурс Yandex Cloud. * `service = <лог_группа>` — имя или идентификатор [лог-группы](../../logging/concepts/log-group.md), в которую передаются логи. Например, `default`. * `resource_type = <тип_ресурса>` — тип ресурса Yandex Cloud, который передает логи. Например, `managed-airflow.cluster`, `k8s.cluster`, `alb.loadBalancer`. * `resource_id = <идентификатор_ресурса>` — идентификатор ресурса Yandex Cloud, который передает логи. Например, идентификатор кластера. Если не указать тип ресурса, будут показаны все логи, которые передаются в лог-группу. Если не указать идентификатор ресурса, будут показаны все логи для ресурсов заданного типа. Запрос можно вводить в режиме токенов, выбирая метки из списка, или в текстовом режиме. Чтобы переключиться в текстовый режим, нажмите ![raw](../../_assets/console-icons/code.svg) и введите запрос в формате: ``` { ="", ="", ... } ``` Составление запросов описано в разделах [Модель данных в Monium](../concepts/data-model.md) и [Язык запросов в Monium](../concepts/querying.md). Пример запроса для поиска логов приложения: ``` {project = "market", cluster = "production", service = "basket"} ``` Пример запроса для поиска логов с ошибками от L7-балансировщика Application Load Balancer: ``` {project = "folder__b1g86q4m5vej********", service = "default", resource_type = "alb.loadBalancer", level = "ERROR"} ``` 1. Нажмите **Выполнить запрос**. {% endlist %} {% cut "Пример страницы с логами приложения" %} ![image](../../_assets/monium/petclinic-logs.png) {% endcut %} {% cut "Пример страницы с логами кластера Apache Airflow™" %} ![image](../../_assets/monium/af-cluster-logs.png) {% endcut %} ## Анализ логов {#logs-analysis} Для анализа логов вы можете работать с фильтрацией логов в строке запроса, с записями логов и их визуализацией. ### Фильтрация и группировка {#filtering} * Для поиска конкретной части логов выберите нужные метки из списка. Например, метка `level = WARN` покажет все логи с уровнем WARNING (предупреждение). Составление запросов описано в разделах [Модель данных в Monium](../concepts/data-model.md) и [Язык запросов в Monium](../concepts/querying.md). * Чтобы одновременно показать логи разных приложений или ресурсов, нажмите **Добавить запрос** и укажите параметры другого запроса. ### Визуализация {#visualization} На графике отображается количество записей логов во времени. График автоматически обновляется при изменении запроса или временного диапазона. При работе с графиком доступны возможности: * **Окно информации**: * Чтобы открыть окно с информацией о логах, поступивших в конкретный момент времени, подведите курсор к нужной части графика. * Чтобы зафиксировать окно информации, нажмите на нужную часть графика. * Чтобы перейти к записям логов, напротив нужной строки нажмите ![image](../../_assets/console-icons/ellipsis.svg) → **Перейти к логам**. ![image](../../_assets/monium/tooltip-go-to-logs.png) * **Легенда** — показывает значения меток для каждой серии данных на графике. * **Тип графика** позволяет выбрать вид графика с количеством логов: * **Линия** — линии. * **Область** — закрашенные области. * **Столбец** (по умолчанию) — столбцы. * **Группировка логов** — выберите параметр группировки в списке **Группировать по**. Например, группировка по `level` покажет распределение логов по уровням важности. * При работе с несколькими запросами можно для каждого построить собственный график. Для этого включите **Один график на запрос** или выберите, сколько графиков разместить в одном ряду. * Чтобы детально изучить график или поделиться им, в правом верхнем углу графика нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите: * **Показать график на весь экран**. * **Скопировать ссылку на скриншот**. * **Скопировать скриншот в буфер**. * **Выгрузить логи в файл** — позволяет сохранить логи в форматах `CSV`, `JSON` и `TXT`. Можно сохранить не более 1 000 строк лога. Если строк больше, уменьшите временной диапазон. Если визуализация не нужна, нажмите **Скрыть график**. Чтобы отобразить график, нажмите **Показать график**. ### Работа с записями логов {#log-records} * Если описания логов не помещаются в ширину экрана, включите **Перенос строк**. * Для исследования определенной записи лога разверните ее и напротив нужной строки лога выберите одно из действий: * **=** — добавить в запрос метку ключа из строки; * **!=** — исключить из запроса метку ключа из строки; * ![eye](../../_assets/console-icons/eye.svg) — скрыть строку лога; * ![copy](../../_assets/console-icons/copy.svg) — скопировать строку лога. Если вы работаете с [трейсами](../traces/index.md), то с помощью полей `trace.id` и `span.id` вы можете перейти к связанным данным трейсов. * Чтобы настроить таблицу со строками логов, вверху справа таблицы нажмите ![image](../../_assets/console-icons/gear.svg) и выберите нужные колонки и контекст. ## Сервисный дашборд для логов {#logs-service-dashboard} Система автоматически собирает [метрики о поступающих логах](logs-metrics.md) — объем данных, задержки доставки, количество ошибок по уровням и так далее. Графики о поступивших логах доступны на сервисном дашборде.