# Журналирование

Лог (log) - это хронологическая запись наиболее значимой информации о работе системы.

Подобная фиксация событий дает представление и том, что происходило в системе, в какой именно момент, какой пользователь спровоцировал то или иное событие, какие ошибки возникли и т.д.

Запись оформляется в особый файл, который еще называют лог-файлом или журналом логов.

В зависимости от того, информация какого типа фиксируется системой, формируются разные типы записей.

Xray имеет два типа логов: логи доступа и логи ошибок. Вы можете настроить метод вывода для каждого типа логов отдельно.

Пример конфигурации:

{
  "log": {
    "access": "/var/lib/marzban/access.log", 
    "error": "/var/lib/marzban/error.log",
    "loglevel": "warning",
    "dnsLog": true
  }
}

access: строка

Путь к файлу для логов доступа. Значение должно быть допустимым путем к файлу, например, "/var/lib/marzban/access.log".

Если этот элемент не указан или является пустым значением, логи выводятся в stdout.

• значение none отключает логи доступа.

error: строка

Путь к файлу для логов ошибок. Значение должно быть допустимым путем к файлу, например, "/var/lib/marzban/error.log".

Если этот элемент не указан или является пустым значением, логи выводятся в stdout.

• значение none отключает логи ошибок.

loglevel: строка

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

• "debug": Информация, используемая для отладки программы. Включает в себя все содержимое "info".
• "info": Информация о статусе выполнения и т.д., которая не влияет на нормальное использование. Включает в себя все содержимое "warning".
• "warning": Информация, выводимая при наличии некоторых проблем, которые не влияют на нормальную работу, но могут повлиять на пользовательский опыт. Включает в себя все содержимое "error".
• "error": Xray столкнулся с проблемой, которая не позволяет ему нормально работать и требует немедленного решения.
• "none": Не записывать никакое содержимое.

dnsLog: логический тип

Определяет, нужно ли включить логи запросов DNS, например: DOH//doh.server got answer: gayporn.ru -> [ip1, ip2] 2.333ms.