[Документация Yandex Cloud](../../index.md) > [Monium](../index.md) > Логи > Начало работы с логами приложений

# Начало работы с логами приложений

Monium Logs — распределенная и высокодоступная система для хранения, поиска, визуализации и анализа логов. Система входит в платформу Monium и использует ее базовые компоненты — управление доступом, модель данных и единый интерфейс.

Этот раздел содержит общие сведения о передаче и просмотре логов из вашего приложения в Monium.

Сведения о ресурсах Yandex Cloud приведены в разделе [Начало работы с логами ресурсов Yandex Cloud](quickstart-resources.md).

## Поставка логов {#data-send}

Если вы еще не работали с облаком Yandex Cloud или у вас нет приложения, на котором можно проверить отправку логов, перейдите к разделу [Как начать работать с Monium](../quickstart.md). Там описана базовая настройка окружения и поставка телеметрии с помощью Otel Collector.

Поставка логов в Monium настраивается так же, как и другие виды телеметрии. Данные принимаются в формате OpenTelemetry, поэтому для отправки логов можно использовать любой агент или коллектор, который его поддерживает, либо передавать данные напрямую из приложения.

Если облако и приложение уже настроены и вы работали с поставкой телеметрии ранее, настройте отправку логов по параметрам ниже.

### Параметры Cloud Logging {#main-parameters}

* Формат поставки данных в Monium — [OpenTelemetry (OTLP)](https://opentelemetry.io/docs/).

* Адрес для записи логов: `ingest.monium.yacloudkz.tech:443`.

* Аутентификация:
  * [Сервисный аккаунт](../../iam/operations/sa/create.md) с ролью `monium.logs.writer` или общей ролью `monium.telemetry.writer`.
  * [API-ключ](../../iam/operations/iam-token/create-for-sa.md) с областью действия `yc.monium.logs.write` или `yc.monium.telemetry.write`.

* В заголовке: параметр `x-monium-project=<идентификатор_проекта>`.

    Это может быть проект облака (`cloud__<идентификатор_облака>`), каталога (`folder__<идентификатор_каталога>`) или другой [проект](../collector/project.md#project-create).

* В атрибутах ресурса `OTEL_RESOURCE_ATTRIBUTES`: `cluster` или `deployment.name` и `service` или `service.name`.

    Если кластер не указан, то по умолчанию `cluster = default`.


## Просмотр логов {#view-logs}

{% list tabs group=instructions %}

- Интерфейс Monium {#console}

  1. На главной странице [Monium](https://kz.monium.yandex.cloud) слева выберите **Логи**.
  1. Вверху на шкале времени задайте промежуток поиска данных.
  1. В строке поиска введите запрос для поиска логов приложения:
     
     * `project = <идентификатор_проекта>` — выберите проект, заданный в параметре `x-monium-project` в конфигурации передачи телеметрии приложения.
     
         Это может быть проект облака (`cloud__<идентификатор_облака>`), каталога (`folder__<идентификатор_каталога>`) или другой [проект](../collector/project.md#project-create).
     * `cluster = <имя_кластера>` — выберите имя инсталляции, в которой запущено ваше приложение. Если кластер не задан, то по умолчанию `cluster = default`.
     * `service = <имя_сервиса>` — имя вашего приложения или сервиса. Может передаваться в переменной окружения `OTEL_SERVICE_NAME`.
     
       Если нужных меток нет в подсказках, их можно ввести вручную. Но, скорее всего, в систему не поступали данные с такими метками. Решение возможных проблем описано в разделе [Устранение неполадок при поставке данных](../collector/troubleshooting.md).

  1. Нажмите **Выполнить запрос**.
  1. Чтобы посмотреть логи для определенной записи, раскройте ее.

{% endlist %}

Работа с логами описана в разделе [Поиск и анализ логов](logs-explorer.md).

## Сервисный дашборд для логов {#logs-service-dashboard}

Система автоматически собирает [метрики о поступающих логах](logs-metrics.md) — объем данных, задержки доставки, количество ошибок по уровням и так далее.

Графики о поступивших логах доступны на сервисном дашборде.

#### Полезные ссылки {#see-also}

* [Monium Traces](../traces/index.md)
* [Начало работы с метриками ресурсов Yandex Cloud](../metrics/quickstart.md)