Платформа 3V/Логирование: различия между версиями

Материал из 3v-wiki
Перейти к навигации Перейти к поиску
Строка 1: Строка 1:
 +
== Общие сведения ==
 
Логирование в 3v-platform осуществляется через [https://nlog-project.org/ Nlog], который позволяет сохранять логи в различные места: БД, файлы, Elastic Search, Graylog и проч. Подробнее см. [https://nlog-project.org/config/ здесь].
 
Логирование в 3v-platform осуществляется через [https://nlog-project.org/ Nlog], который позволяет сохранять логи в различные места: БД, файлы, Elastic Search, Graylog и проч. Подробнее см. [https://nlog-project.org/config/ здесь].
 
</br>
 
</br>
 
</br>
 
</br>
Cхема логирования через nlog на примере записи в graylog:
+
Cхема логирования через nlog на примере записи в [https://www.graylog.org/ graylog]:
[[Файл:graylog.png|слева|схема логирования через nlog на примере записи в graylog.]]
+
[[Файл:graylog.png|без|схема логирования через nlog на примере записи в graylog.]]
 +
 
 +
== Graylog ==
 +
Основная работа с Graylog происходит на вкладке Search. Здесь задаются поисковые запросы, время и выводятся сообщения (логи).
 +
 
 +
=== Область поиска ===
 +
[[Файл:image2021-11-24 15-52-22.png|без|Graylog: область поиска]]
 +
*Здесь задается интервал времени: абсолютный или относительный, - за который мы хотим найти сообщения.<br>
 +
*Для поиска необходимо использовать синтаксис поискового запроса graylog (в котором важен регистр к примеру: and и AND, statuscode и StatusCode для грейлога это разные поля), к примеру если мы хотим найти логи которые приходят из сервиса cards-1, то должны указать в строку: source: cards-1 и нажать enter.<br>
 +
*Поисковый запрос строится по типу Поле : значение, поля можно посмотреть на вкладке Fields
 +
 
 +
=== Область сообщений ===
 +
*Область сообщений отображает все логи, удовлетворяющие критериям поиска. Если сообщений много, то они выводятся постранично.
 +
*Для каждого сообщения по умолчанию отображается поле Message
 +
*По умолчанию сообщения показываются от самых последних (свежих) к самым старым.
 +
*Кликом на сообщение можно открыть и увидеть детали сообщения.
 +
*В таблицу можно добавить столбцы. Это можно сделать, либо нажав на карандашик в правом верхнем углу окна, либо выбрав в деталях сообщения нужное поле и через контекстное меню выбрать Add to all tables.
 +
<br>
 +
На скриншоте ниже отображается область сообщений с выведенным временем сообщения, источником, пользователем, адресом запроса.
 +
[[Файл:2022-05-24-graylog-messages.png|без|Graylog: область сообщений]]
 +
 
 +
=== Поиск сообщений об ошибках ===
 +
==== Поиск по уровню ошибок ====
 +
Можно использовать поле level, его значения
 +
*0 - Emergency
 +
*1 - Alert
 +
*2 - Critical
 +
*3 - Error
 +
*4 - Warning
 +
*5 - Notice
 +
*6 - Informational
 +
*7 - Debug
 +
Если мы хотим найти все ошибки, то должны написать условие в строке поиска: level:<4
 +
==== Поиск по ошибок прав доступа ====
 +
Для поиска ошибок прав доступа удобно искать по http-статусу запроса. Для этого в строке поиска нужно написать: status:403<br>
 +
Пример поиска и отображения сообщений с нарушением прав доступа с детализацией сообщения:
 +
[[Файл:2022-05-24-graylog-status.png|без]]

Версия 12:32, 24 мая 2022

Общие сведения

Логирование в 3v-platform осуществляется через Nlog, который позволяет сохранять логи в различные места: БД, файлы, Elastic Search, Graylog и проч. Подробнее см. здесь.

Cхема логирования через nlog на примере записи в graylog:

схема логирования через nlog на примере записи в graylog.

Graylog

Основная работа с Graylog происходит на вкладке Search. Здесь задаются поисковые запросы, время и выводятся сообщения (логи).

Область поиска

Graylog: область поиска
  • Здесь задается интервал времени: абсолютный или относительный, - за который мы хотим найти сообщения.
  • Для поиска необходимо использовать синтаксис поискового запроса graylog (в котором важен регистр к примеру: and и AND, statuscode и StatusCode для грейлога это разные поля), к примеру если мы хотим найти логи которые приходят из сервиса cards-1, то должны указать в строку: source: cards-1 и нажать enter.
  • Поисковый запрос строится по типу Поле : значение, поля можно посмотреть на вкладке Fields

Область сообщений

  • Область сообщений отображает все логи, удовлетворяющие критериям поиска. Если сообщений много, то они выводятся постранично.
  • Для каждого сообщения по умолчанию отображается поле Message
  • По умолчанию сообщения показываются от самых последних (свежих) к самым старым.
  • Кликом на сообщение можно открыть и увидеть детали сообщения.
  • В таблицу можно добавить столбцы. Это можно сделать, либо нажав на карандашик в правом верхнем углу окна, либо выбрав в деталях сообщения нужное поле и через контекстное меню выбрать Add to all tables.


На скриншоте ниже отображается область сообщений с выведенным временем сообщения, источником, пользователем, адресом запроса.

Graylog: область сообщений

Поиск сообщений об ошибках

Поиск по уровню ошибок

Можно использовать поле level, его значения

  • 0 - Emergency
  • 1 - Alert
  • 2 - Critical
  • 3 - Error
  • 4 - Warning
  • 5 - Notice
  • 6 - Informational
  • 7 - Debug

Если мы хотим найти все ошибки, то должны написать условие в строке поиска: level:<4

Поиск по ошибок прав доступа

Для поиска ошибок прав доступа удобно искать по http-статусу запроса. Для этого в строке поиска нужно написать: status:403
Пример поиска и отображения сообщений с нарушением прав доступа с детализацией сообщения:

2022-05-24-graylog-status.png