Создание метрики лога

Создание метрики лога

Управление логами и аналитика Ключ-АСТРОМ даёт возможность не только просматривать и анализировать логи, но и создавать метрики на основе данных логов и использовать их в Ключ-АСТРОМ как любые другие метрики. Вы можете добавлять их на дашборд, включать в анализ и даже создавать пользовательские оповещения.

Создание метрики «connections refused»

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

Построение запроса DQL

Чтобы построить и запустить запрос:

• Перейдите в Логи и события Classic.
• На странице Логи и события включите Расширенный режим.
• Выберите Копировать для приведённого ниже примера кода.

fetch logs
| filter matchesPhrase(content, "Connection refused")
| sort timestamp desc

• Вставьте запрос в поле редактирования запроса и выберите Запустить запрос.

Этот запрос выполняет следующие действия:

• Извлекает логи, содержащие фразу Connection refused в содержимом лога.
• Сортирует результат в порядке убывания по временной метке.

Создание метрики

• Перейдите в Настройки > Мониторинг логов > Извлечение метрик и выберите Добавить метрику лога.
• В поле Ключ добавьте имя метрики к префиксу log.. Ключ метрики: log.conn_refused_count.
• Добавьте Сопоставление. Используйте функцию DQL matchesPhrase для сопоставления фраз, которая является частью Языка запросов Ключ-АСТРОМ (DQL): matchesPhrase(content, "Connection refused"). Это фильтрует данные логов, содержащие фразу Connection refused.
• Для опции Измерение метрики выберите Количество записей логов. Метрика представляет собой количество вхождений записей логов, содержащих фразу Connection refused.
• Выберите Сохранить изменения, чтобы создать метрику лога.

Просмотр метрики

Чтобы просмотреть результат в Визуализации данных:

• Перейдите в Визуализацию данных.
• Выберите ключ метрики log.conn_refused_count.
• Выберите Запустить запрос.

Создание метрики атрибута лога

Вам нужно отслеживать атрибут ваших логов, и вы хотите следить за уровнями ошибок, сообщаемыми в логах из вашего кластера K8s. Найдите правильные логи из хранилища данных и используйте фильтры, чтобы создать новую метрику для них. Добавьте статус лога (error/warning/info) к вашей метрике, что упрощает отслеживание этих данных с помощью метрик.

Построение запроса DQL

Чтобы построить и запустить запрос:

• Перейдите в Логи и события Classic.
• На странице Логи и события включите Расширенный режим.
• Выберите Копировать для приведённого ниже примера кода.

fetch logs
| filter matchesValue(dt.entity.kubernetes_cluster, "KUBERNETES_CLUSTER-92233333")
| summarize count(), by:status

• Вставьте запрос в поле редактирования запроса и выберите Запустить запрос.

Этот запрос выполняет следующие действия:

• Извлекает записи логов с атрибутом dt.entity.kubernetes_cluster, содержащим фразу KUBERNETES_CLUSTER-92233333 в содержимом лога.
• Подсчитывает количество таких записей логов и упорядочивает их по атрибуту status.

Метрики из событий Kubernetes

События Kubernetes не хранятся как записи логов в хранилище данных. Если ваша метрика лога соответствует событиям Kubernetes, используйте fetch events вместо fetch logs, чтобы найти совпадающие записи. Сопоставление атрибутов между сопоставлением и событиями хранилища данных см. в разделе Метрики логов.

Создание метрики

• Перейдите в Настройки > Мониторинг логов > Извлечение метрик и выберите Добавить метрику лога.
• В поле Ключ добавьте имя метрики к префиксу log.. Ключ метрики: K8-92233333.
• Добавьте Сопоставление. Используйте функцию DQL matchesValue для сопоставления значений, которая является частью Языка запросов Ключ-АСТРОМ (DQL): matchesValue(dt.entity.kubernetes_cluster, "KUBERNETES_CLUSTER-92233333").
• Для опции Измерение метрики выберите Количество записей логов. Метрика представляет собой количество вхождений записей логов, содержащих фразу KUBERNETES_CLUSTER-92233333.
• Добавьте измерение status.
• Выберите Сохранить изменения, чтобы создать метрику лога.

Просмотр метрики

Чтобы просмотреть результат в Визуализации данных:

• Перейдите в Визуализацию данных.
• Выберите ключ метрики log.K8-92233333 и в разделе Разбить по добавьте status.
• Выберите Запустить запрос.