Создание метрики лога: различия между версиями

Материал из Документация Ключ-АСТРОМ
ВизуальныйВики-текст
Новая страница: « = Создание метрики лога = Управление логами и аналитика Ключ-АСТРОМ даёт возможность не только просматривать и анализировать логи, но и создавать метрики на основе данных логов и использовать их в Ключ-АСТРОМ как любые другие метрики. Вы можете добавля...»
 
Нет описания правки
 
Строка 5: Строка 5:
== Создание метрики «connections refused» ==
== Создание метрики «connections refused» ==
Вам нужно подсчитать, сколько отказов соединений зафиксировано в ваших данных логов. Для этого отфильтруйте нужные логи и превратите количество вхождений в метрику лога. Отслеживая метрику, вы можете отслеживать возможные проблемы с межсетевым экраном, сетевым подключением или конфигурацией сервера.
Вам нужно подсчитать, сколько отказов соединений зафиксировано в ваших данных логов. Для этого отфильтруйте нужные логи и превратите количество вхождений в метрику лога. Отслеживая метрику, вы можете отслеживать возможные проблемы с межсетевым экраном, сетевым подключением или конфигурацией сервера.
=== Построение запроса DQL ===
Чтобы построить и запустить запрос:
* Перейдите в '''Логи и события Classic'''.
* На странице '''Логи и события''' включите '''Расширенный режим'''.
* Выберите '''Копировать''' для приведённого ниже примера кода.
<pre>fetch logs
| filter matchesPhrase(content, "Connection refused")
| sort timestamp desc</pre>
* Вставьте запрос в поле редактирования запроса и выберите '''Запустить запрос'''.
Этот запрос выполняет следующие действия:
* Извлекает логи, содержащие фразу <code>Connection refused</code> в содержимом лога.
* Сортирует результат в порядке убывания по временной метке.


=== Создание метрики ===
=== Создание метрики ===
Строка 27: Строка 10:
* Перейдите в '''Настройки > Мониторинг логов > Извлечение метрик''' и выберите '''Добавить метрику лога'''.
* Перейдите в '''Настройки > Мониторинг логов > Извлечение метрик''' и выберите '''Добавить метрику лога'''.
* В поле '''Ключ''' добавьте имя метрики к префиксу <code>log.</code>. Ключ метрики: <code>log.conn_refused_count</code>.
* В поле '''Ключ''' добавьте имя метрики к префиксу <code>log.</code>. Ключ метрики: <code>log.conn_refused_count</code>.
* Добавьте '''Сопоставление'''. Используйте функцию '''DQL''' <code>matchesPhrase</code> для сопоставления фраз, которая является частью '''Языка запросов Ключ-АСТРОМ (DQL)''': <code>matchesPhrase(content, "Connection refused")</code>. Это фильтрует данные логов, содержащие фразу <code>Connection refused</code>.
* Добавьте '''Сопоставление'''.  
* Для опции '''Измерение метрики''' выберите '''Количество записей логов'''. Метрика представляет собой количество вхождений записей логов, содержащих фразу <code>Connection refused</code>.
* Для опции '''Измерение метрики''' выберите '''Количество записей логов'''. Метрика представляет собой количество вхождений записей логов, содержащих фразу <code>Connection refused</code>.
* Выберите '''Сохранить изменения''', чтобы создать метрику лога.
* Выберите '''Сохранить изменения''', чтобы создать метрику лога.
Строка 40: Строка 23:
== Создание метрики атрибута лога ==
== Создание метрики атрибута лога ==
Вам нужно отслеживать атрибут ваших логов, и вы хотите следить за уровнями ошибок, сообщаемыми в логах из вашего кластера K8s. Найдите правильные логи из хранилища данных и используйте фильтры, чтобы создать новую метрику для них. Добавьте статус лога (error/warning/info) к вашей метрике, что упрощает отслеживание этих данных с помощью метрик.
Вам нужно отслеживать атрибут ваших логов, и вы хотите следить за уровнями ошибок, сообщаемыми в логах из вашего кластера K8s. Найдите правильные логи из хранилища данных и используйте фильтры, чтобы создать новую метрику для них. Добавьте статус лога (error/warning/info) к вашей метрике, что упрощает отслеживание этих данных с помощью метрик.
=== Построение запроса DQL ===
Чтобы построить и запустить запрос:
* Перейдите в '''Логи и события Classic'''.
* На странице '''Логи и события''' включите '''Расширенный режим'''.
* Выберите '''Копировать''' для приведённого ниже примера кода.
<pre>fetch logs
| filter matchesValue(dt.entity.kubernetes_cluster, "KUBERNETES_CLUSTER-92233333")
| summarize count(), by:status</pre>
* Вставьте запрос в поле редактирования запроса и выберите '''Запустить запрос'''.
Этот запрос выполняет следующие действия:
* Извлекает записи логов с атрибутом <code>dt.entity.kubernetes_cluster</code>, содержащим фразу <code>KUBERNETES_CLUSTER-92233333</code> в содержимом лога.
* Подсчитывает количество таких записей логов и упорядочивает их по атрибуту <code>status</code>.


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

Текущая версия от 17:45, 22 октября 2026

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

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

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

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

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

  • Перейдите в Настройки > Мониторинг логов > Извлечение метрик и выберите Добавить метрику лога.
  • В поле Ключ добавьте имя метрики к префиксу log.. Ключ метрики: log.conn_refused_count.
  • Добавьте Сопоставление.
  • Для опции Измерение метрики выберите Количество записей логов. Метрика представляет собой количество вхождений записей логов, содержащих фразу Connection refused.
  • Выберите Сохранить изменения, чтобы создать метрику лога.

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

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

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

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

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

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

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

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

  • Перейдите в Настройки > Мониторинг логов > Извлечение метрик и выберите Добавить метрику лога.
  • В поле Ключ добавьте имя метрики к префиксу log.. Ключ метрики: K8-92233333.
  • Добавьте Сопоставление.
  • Для опции Измерение метрики выберите Количество записей логов. Метрика представляет собой количество вхождений записей логов, содержащих фразу KUBERNETES_CLUSTER-92233333.
  • Добавьте измерение status.
  • Выберите Сохранить изменения, чтобы создать метрику лога.

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

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

  • Перейдите в Визуализацию данных.
  • Выберите ключ метрики log.K8-92233333 и в разделе Разбить по добавьте status.
  • Выберите Запустить запрос.
Источник — https://doc.ruscomtech.ru/index.php?title=Создание_метрики_лога&oldid=7214