23.2. Rsyslog의 기본 구성

규칙은 syslog 메시지의 하위 집합을 선택하는 필터 부분과 선택한 메시지로 수행할 작업을 지정하는 작업 부분에 의해 지정됩니다. /etc/journal.conf 구성 파일에 규칙을 정의하려면 한 줄에서 필터 및 작업을 모두 정의하고 하나 이상의 공백 또는 탭으로 구분합니다.

rsyslog 는 선택한 속성에 따라 syslog 메시지를 필터링하는 다양한 방법을 제공합니다. 사용 가능한 필터링 방법은 facilities /Priority-based ,Property-based , Expression 기반 필터로 나눌 수 있습니다.

다양한 표현식 기반 필터의 예제를 보려면 “온라인 문서” 를 참조하십시오. RainerScript는 rsyslog의 새로운 구성 형식을 기반으로합니다. 23.3절. “새 구성 형식 사용”

작업은 이미 정의된 선택기에서 필터링한 메시지로 수행할 작업을 지정합니다. 다음은 규칙에 정의할 수 있는 몇 가지 작업입니다.

여러 작업 지정

각 선택기에 대해 여러 작업을 지정할 수 있습니다. 하나의 선택기에 대해 여러 작업을 지정하려면 각 작업을 별도의 줄에 작성하고 앞에 (&) 문자를 추가합니다.

FILTER ACTION
& ACTION
& ACTION

여러 작업을 지정하면 지정된 선택기를 한 번만 평가해야 하므로 원하는 결과의 전체 성능이 향상됩니다.

kern.=crit user1
& ^test-program;temp
& @192.168.0.1

모든 작업 뒤에 메시지를 포맷하는 템플릿이 올 수 있습니다. 템플릿을 지정하려면 별칭(; )이 있는 작업 접미사를 지정하고 템플릿 이름을 지정합니다. 템플릿에 대한 자세한 내용은 23.2.3절. “템플릿” 을 참조하십시오.

rsyslog 에 의해 생성된 모든 출력은 템플릿을 사용하여 필요에 따라 수정하고 포맷할 수 있습니다. 템플릿을 생성하려면 /etc/journal.conf에서 다음 구문을 사용합니다.

template(name=”TEMPLATE_NAME” type=”string” string="text %PROPERTY% more text" [option.OPTION="on"])

다음과 같습니다.

동적 파일 이름 생성

템플릿을 사용하여 동적 파일 이름을 생성할 수 있습니다. 파일 경로의 일부로 속성을 지정하면 syslog 메시지를 분류하는 편리한 방법인 각 고유 속성에 대해 새 파일이 생성됩니다.

예를 들어 메시지에서 타임스탬프를 추출하는 timegenerated 속성을 사용하여 각 syslog 메시지에 고유한 파일 이름을 생성합니다.

  template(name=”DynamicFile” type=”list”) {
  constant(value=”/var/log/test_logs/”)
  property(name=”timegenerated”)
  constant(value”-test.log”)
}

$template 지시문은 템플릿만 지정합니다. 이를 적용하려면 규칙 내에서 사용해야 합니다. /etc/octets.conf 에서 질문 표시(?)를 작업 정의에서 사용하여 동적 파일 이름 템플릿을 표시합니다.

. ?DynamicFile

속성

템플릿 내에 정의된 속성(두%기호(%))을 사용하면 속성 교체 기를 사용하여 syslog 메시지의 다양한 콘텐츠에 액세스할 수 있습니다. 템플릿 내부에 속성을 정의하려면 두 개의 따옴표("…") 사이에 속성을 정의하려면 다음 구문을 사용합니다.

%PROPERTY_NAME:FROM_CHAR:TO_CHAR:OPTION%

다음과 같습니다.

다음은 간단한 속성의 몇 가지 예입니다.

템플릿 예

이 섹션에서는 rsyslog 템플릿의 몇 가지 예를 보여줍니다.

예 23.8. “자세한 syslog 메시지 템플릿” 메시지의 심각도, 기능, 메시지가 수신될 때의 타임스탬프, 호스트 이름, 메시지 텍스트, 메시지 텍스트 등을 출력하도록 syslog 메시지를 포맷하는 템플릿을 표시합니다.

  template(name=”verbose” type=”list”) {
  property(name="syslogseverity”)
  property(name="syslogfacility”)
  property(name="timegenerated”)
  property(name="HOSTNAME”)
  property(name="syslogtag”)
  property(name="msg”)
  constant(value=”\n")
}

예 23.9. “월경 메시지 템플릿” 기존 wall 메시지와 유사한 템플릿을 표시합니다(로그인되어 있고 mesg(1) 권한이 yes로 설정된 모든 사용자에게 전송됨). 이 템플릿은 새 줄에 호스트 이름, 메시지 태그 및 타임스탬프와 함께 메시지 텍스트를 출력하고( \r 및 \n을 사용하여) 벨( \7사용)을 사용하여 메시지를 출력합니다.

  template(name=”wallmsg” type=”list”) {
  constant(value="\r\n\7Message from syslogd@”)
  property(name="HOSTNAME”)
  constant(value=” at ")
  property(name="timegenerated”)
  constant(value=" ...\r\n ”)
  property(name="syslogtag”)
  constant(value=” “)
  property(name="msg”)
  constant(value=”\r\n”)
}

예 23.10. “데이터베이스 형식 메시지 템플릿” 데이터베이스 쿼리로 사용할 수 있도록 syslog 메시지를 포맷하는 템플릿을 표시합니다. template 옵션으로 지정된 템플릿 끝에 sql 옵션을 사용합니다. 데이터베이스 작성자가 메시지를 MySQL SQL 쿼리로 포맷하도록 지시합니다.

template(name="dbFormat" type="list" option.sql="on") {
constant(value="insert into SystemEvents (Message, Facility, FromHost, Priority, DeviceReportedTime, ReceivedAt, InfoUnitID, SysLogTag)")
constant(value=" values ('")
property(name="msg")
constant(value="', ")
property(name="syslogfacility")
constant(value=", '")
property(name="hostname")
constant(value="', ")
property(name="syslogpriority")
constant(value=", '")
property(name="timereported" dateFormat="mysql")
constant(value="', '")
property(name="timegenerated" dateFormat="mysql")
constant(value="', ")
property(name="iut")
constant(value=", '")
property(name="syslogtag")
constant(value="')")
}

rsyslog 에는 RSYSLOG_ 접두사로 식별되는 사전 정의된 템플릿 세트도 포함되어 있습니다. 이는 syslog 사용을 위해 예약되어 있으며 충돌을 피하기 위해 이 접두사를 사용하여 템플릿을 생성하지 않는 것이 좋습니다. 다음 목록은 이러한 사전 정의된 템플릿을 정의와 함께 보여줍니다.

글로벌 지시문은 rsyslogd 데몬에 적용되는 구성 옵션입니다. 일반적으로 rsyslogd 데몬 또는 다음 규칙의 동작에 영향을 미치는 특정 사전 정의된 변수의 값을 지정합니다. 모든 글로벌 지시문은 글로벌 구성 블록으로 묶습니다. 다음은 로그 메시지에 대한 로컬 호스트 이름을 재정의하는 global 지시문의 예입니다.

global(localHostname=”machineXY”)

/etc/journal.conf 구성 파일에 여러 지시문을 정의할 수 있습니다. 지시문은 동일한 지시문이 다시 발생할 때까지 모든 구성 옵션의 동작에 영향을 미칩니다. 전역 지시문을 사용하여 작업, 큐 및 디버깅을 구성할 수 있습니다. 사용 가능한 모든 구성 지시문의 포괄적인 목록은 “온라인 문서” 에서 확인할 수 있습니다. 현재 $ 기반 구문을 대체하는 새로운 구성 형식이 개발되었습니다( 23.3절. “새 구성 형식 사용”참조). 그러나 클래식 글로벌 지시문은 레거시 형식으로 계속 지원됩니다.

다음은 샘플 /etc/logrotate.conf 구성 파일입니다.

# rotate log files weekly
weekly
# keep 4 weeks worth of backlogs
rotate 4
# uncomment this if you want your log files compressed
compress

샘플 구성 파일의 모든 행은 모든 로그 파일에 적용되는 전역 옵션을 정의합니다. 이 예에서는 매주 로그 파일이 순환되고 순환된 로그 파일은 4주 동안 보관되며, 순환된 모든 로그 파일은 gzip 에 의해 .gz 형식으로 압축됩니다. 해시 기호(#)로 시작하는 행은 주석이며 처리되지 않습니다.

특정 로그 파일에 대한 구성 옵션을 정의하고 글로벌 옵션에 배치할 수 있습니다. 그러나 /etc/logrotate.d/ 디렉토리에 있는 특정 로그 파일에 대해 별도의 구성 파일을 생성하고 여기에 구성 옵션을 정의하는 것이 좋습니다.

다음은 /etc/logrotate.d/ 디렉토리에 배치된 구성 파일의 예입니다.

/var/log/messages {
  rotate 5
  weekly
  postrotate
  /usr/bin/killall -HUP syslogd
  endscript
}

이 파일의 구성 옵션은 /var/log/message 로그 파일에 만 적용됩니다. 여기에서 지정한 설정은 가능한 경우 전역 설정을 재정의합니다. 따라서 순환된 /var/log/ catalog 로그 파일은 글로벌 옵션에 정의된 4주가 아닌 5주 동안 유지됩니다.

다음은 logrotate 구성 파일에 지정할 수 있는 일부 지시문 목록입니다.

지시문 및 다양한 구성 옵션의 전체 목록은 logrotate(5) 매뉴얼 페이지를 참조하십시오.

특정 상황에서 rsyslog 는 열린 파일의 최대 수에 대한 제한을 초과합니다. 따라서 rsyslog 가 새 파일을 열 수 없습니다.

rsyslog 에서 열린 파일의 제한을 늘리려면 다음을 수행합니다.

다음 콘텐츠를 사용하여 /etc/systemd/system/rsylog.service.d/increase_nofile_limit.conf 파일을 만듭니다.

[Service]
LimitNOFILE=16384