Облачная платформаEvolution

Клиентские логи сервиса Managed ClickHouse

Эта статья полезна?

Клиентские логи сервиса Managed ClickHouse содержат детальную техническую информацию о событиях управления кластером. Они позволяют отслеживать ошибки в работе сервисов и приложений, находить узкие места и быстро реагировать на инциденты.

Примечание

Клиентские логи не содержат информации о пользователе, который совершил действие. Для получения этой информации используйте аудитные логи.

Включение логирования

Сервис Managed ClickHouse передает логи по умолчанию в лог-группу default.

Вы можете выбрать лог-группу при создании кластера.

Просмотр и фильтрация логов

Логи передаются и хранятся централизованно в сервисе «Клиентское логирование».

Для просмотра логов перейдите в раздел личного кабинета Мониторинг → Логирование → Просмотр логов и выберите лог-группу, указанную при создании кластера.

По умолчанию отображаются логи всех сервисов и ресурсов.

Для точной выборки логов используйте язык фильтрующих выражений. Это позволяет найти записи логов по определенным параметрам и их комбинациям. Например, по тексту сообщения в записи лога, важности лога и метке.

Ниже описаны уровни лога и метки, которые передает сервис Managed ClickHouse.

Уровни логов

Фильтрация по уровням логов позволяет классифицировать логи по важности и срочности реагирования.

Сервис Managed ClickHouse передает логи следующих уровней:

  • TRACE

  • DEBUG

  • INFO

  • NOTICE

  • WARN

  • ERROR

  • CRITICAL

  • FATAL

Метки сервиса

Метки передаются в поле labels и позволяют детализировать запрос. Формат обращения к метке в выражении: labels.<label_name>="value".

Для фильтрации записей сервиса Managed ClickHouse применяются следующие метки.

Название метки

Описание

Значение

product_type

Название сервиса

clickhouse

cluster_id

Идентификатор кластера

—

cluster_name

Название кластера

—

clickhouse_component

Компонент кластера

  • database — база данных.

  • keeper — ClickHouse Keeper.

clickhouse_thread_id

Идентификатор потока, в котором создана запись лога

Строка.

clickhouse_query_id

Идентификатор запроса, к которому относится запись лога

Строка.

Примеры запросов

Примеры запросов к логам для решения частых задач Managed ClickHouse:

  • Логи кластера по идентификатору:

    labels.product_type="clickhouse" AND labels.cluster_id="<cluster_id>"

    Где <cluster_id> — идентификатор кластера.

  • Логи кластера по названию:

    labels.product_type="clickhouse" AND labels.cluster_name="<cluster_name>"

    Где <cluster_name> — название кластера.

  • Потенциальные проблемы кластера:

    labels.product_type="clickhouse" AND labels.cluster_id="<cluster_id>" AND level in ["WARN", "ERROR", "CRITICAL", "FATAL"]

    Где <cluster_id> — идентификатор кластера.

  • Логи ClickHouse Keeper:

    labels.product_type="clickhouse" AND labels.cluster_id="<cluster_id>" AND labels.clickhouse_component="keeper"
  • Логи конкретного запроса:

    labels.product_type="clickhouse" AND labels.cluster_id="<cluster_id>" AND labels.clickhouse_query_id="<query_id>"

    Где <query_id> — идентификатор запроса.

Отправка уведомлений о событиях в логах

На основе логов вы можете настроить уведомление о событиях или отклонениях в работе сервиса. Это позволит оперативно реагировать на инциденты, сбои и ошибки, а также снизить время простоя.

Чтобы настроить уведомления:

  1. Настройте правила алертов.

  2. Настройте рассылки уведомлений в случае срабатывания правил.