log_name

Переопределяет имя логгера, используемого для запроса при записи логов доступа с помощью директивы log.

Эта директива полезна, когда вы хотите регистрировать запросы в разные файлы на основе какого-либо условия, например, пути запроса или метода.

Можно указать более одного имени логгера, чтобы лог запроса попадал в несколько соответствующих логгеров.

Это часто используется вместе с опцией no_hostname директивы log, которая предотвращает ассоциацию логгера с какими-либо именами хостов блока сайта, таким образом, что только запросы, которые устанавливают log_name, будут отправлять логи в этот логгер.

Синтаксис

log_name [<matcher>] <names...>

Примеры

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

Использование no_hostname в log предотвращает ассоциацию логгера с какими-либо именами хостов сайта (т.е. localhost здесь), чтобы только запросы, у которых log_name установлено в имя логгера, получали логи.

localhost {
	log {
		output file ./caddy.access.log
	}
	log health_check_log {
		output file ./caddy.access.health.log
		no_hostname
	}
	handle /healthz* {
		log_name health_check_log
		respond "Healthy"
	}
	handle {
		respond "Hello World"
	}
}