2.8 이벤트 통지

다음 절에서는 가상화 환경에서 이벤트를 모니터링하도록 이벤트 통지를 설정하는 방법에 대해 설명합니다. 특정 이벤트가 발생할 때 지정된 사용자에게 경보를 보내도록 전자메일로 이벤트 통지를 전송하거나 SNMP(Simple Network Management Protocol) 트랩이 가상화 환경을 모니터링하도록 Manager를 구성할 수 있습니다.

2.8.1 엔진에서 이벤트 통지 서비스 구성

전자메일 수신자에게 이벤트 통지가 제대로 전송되도록 하려면 엔진에서 메일 서버를 구성하고 ovirt-engine-notifier 서비스를 사용으로 설정해야 합니다. 관리 포털에서 이벤트 통지를 만드는 것과 관련된 자세한 내용은 2.8.2절. “관리 포털에서 이벤트 통지 만들기”를 참조하십시오.

엔진에서 통지 서비스를 구성하려면 다음과 같이 하십시오.

Manager를 실행 중인 호스트에 로그인합니다.

이름이 90-email-notify.conf인 새 파일에 ovirt-engine-notifier.conf를 복사합니다.

# cp /usr/share/ovirt-engine/services/ovirt-engine-notifier/ovirt-engine-notifier.conf /etc/ovirt-engine/notifier/notifier.conf.d/90-email-notify.conf

EMAIL Notifications 섹션을 제외한 모든 섹션을 삭제하여 90-email-notify.conf 파일을 편집합니다.
주
가상화 환경에서 SNMP 트랩을 구성하려는 경우 이름이 20-snmp.conf인 파일에 ovirt-notifier.conf 파일의 SNMP_TRAP Notifications 섹션에 있는 값을 복사할 수 있습니다. 자세한 내용은 2.8.4절. “SNMP 트랩을 전송하도록 엔진 구성”을 참조하십시오.

올바른 전자메일 변수를 입력합니다. 이 파일은 원래 ovirt-engine-notifier.conf 파일의 값을 대체합니다.

---------------------
# EMAIL Notifications #
---------------------

# The SMTP mail server address. Required.
MAIL_SERVER=myemailserver.mycompany.com

# The SMTP port (usually 25 for plain SMTP, 465 for SMTP with SSL, 587 for SMTP with TLS)
MAIL_PORT=25

# Required if SSL or TLS enabled to authenticate the user. Used also to specify 'from' user address if mail server
# supports, when MAIL_FROM is not set. Address is in RFC822 format
MAIL_USER=email.example.com

# Required to authenticate the user if mail server requires authentication or if SSL or TLS is enabled
SENSITIVE_KEYS="${SENSITIVE_KEYS},MAIL_PASSWORD"
MAIL_PASSWORD=

# Indicates type of encryption (none, ssl or tls) should be used to communicate with mail server.
MAIL_SMTP_ENCRYPTION=none

# If set to true, sends a message in HTML format.
HTML_MESSAGE_FORMAT=false

# Specifies 'from' address on sent mail in RFC822 format, if supported by mail server.
MAIL_FROM=myovirtengine@mycompany.com

# Specifies 'reply-to' address on sent mail in RFC822 format.
MAIL_REPLY_TO=myusername@mycompany.com

# Interval to send smtp messages per # of IDLE_INTERVAL
MAIL_SEND_INTERVAL=1

# Amount of times to attempt sending an email before failing.
MAIL_RETRIES=4

주

ovirt-engine-notifier.conf 파일의 이벤트 통지에 사용 가능한 다른 매개변수에 대한 자세한 내용은 oVirt Documentation을 참조하십시오.

ovirt-engine-notifier 서비스를 사용으로 설정하고 다시 시작하여 변경사항을 활성화합니다.
```
# systemctl daemon-reload
# systemctl enable ovirt-engine-notifier.service
# systemctl restart ovirt-engine-notifier.service
```

2.8.2 관리 포털에서 이벤트 통지 만들기

이벤트 통지를 만들려면 들어오는 자동 메시지를 처리하고 해당 메시지를 배포 목록으로 전달할 수 있는 전자메일 서버에 대한 액세스 권한이 있어야 합니다. 또한 엔진에서 이벤트 통지 서비스를 구성해야 합니다. 자세한 내용은 2.8.1절. “엔진에서 이벤트 통지 서비스 구성”을 참조하십시오.

관리 포털에서 이벤트 통지를 만들려면 다음과 같이 하십시오.

Administration(관리)으로 이동한 다음 Users(사용자)를 누릅니다.
Users(사용자) 창이 열립니다.
User Name(사용자 이름) 열에서 사용자 이름을 눌러 사용자에 대한 상세 뷰를 표시합니다.
주
사용자가 만들어지고 사용자에게 적절한 권한이 지정될 때까지는 사용자가 관리 포털에 나타나지 않습니다. 자세한 내용은 1.2.1절. “새 사용자 계정 만들기”를 참조하십시오.
Event Notifier(이벤트 통지자) 탭을 누릅니다.
Manage Events(이벤트 관리)를 누릅니다.
Add Event Notification(이벤트 통지 추가) 대화 상자가 열립니다.
통지에 대한 개별 이벤트 또는 이벤트 주제 영역 옆에 있는 확인란을 선택하여 통지를 만들 이벤트를 선택합니다.
통지에 사용 가능한 이벤트가 주제 영역 아래에 그룹화됩니다. 기본적으로 General Host Events(일반 호스트 이벤트)와 같은 최상위 레벨 주제 영역에 대한 확인란을 선택하면 해당 주제 영역 아래의 모든 이벤트가 선택됩니다. 선택적으로 Expand All(모두 확장) 또는 Collapse All(모두 축소)을 눌러 모든 이벤트 주제 영역을 확장하거나 축소할 수 있습니다. 또한 특정 최상위 레벨 주제 영역 옆에 있는 화살표 아이콘을 눌러 특정 주제 영역과 연관된 이벤트를 확장하거나 축소할 수 있습니다.
Mail Recipient(메일 수신자) 필드에서 전자메일 주소를 입력합니다.
OK(확인)를 눌러 변경사항을 저장합니다.

2.8.3 관리 포털에서 이벤트 통지 취소

관리 포털에서 이벤트 통지를 취소하려면 다음과 같이 하십시오.

Administration(관리)으로 이동한 다음 Users(사용자)를 누릅니다.
Users(사용자) 창이 열립니다.
User Name(사용자 이름) 열에서 사용자 이름을 눌러 사용자에 대한 상세 뷰를 표시합니다.
Event Notifier(이벤트 통지자) 탭을 누릅니다.
Manage Events(이벤트 관리)를 누릅니다.
Add Event Notification(이벤트 통지 추가) 대화 상자가 열립니다.
Expand All(모두 확장) 또는 주제별 확장 옵션을 눌러 이벤트를 표시합니다.
적절한 확인란을 지워 해당 이벤트에 대한 통지를 취소합니다.
OK(확인)를 눌러 변경사항을 저장합니다.

2.8.4 SNMP 트랩을 전송하도록 엔진 구성

하나 이상의 외부 SNMP 관리자에 SNMP 트랩을 전송하도록 Manager을 구성할 수 있습니다. SNMP 트랩에는 가상화 환경 모니터링에 사용되는 시스템 이벤트 정보가 포함됩니다. SNMP 관리자에 전송되는 트랩 수와 유형은 엔진 내에서 정의할 수 있습니다.

이 작업을 수행하려면 트랩을 수신할 하나 이상의 외부 SNMP 관리자를 구성하고 다음 세부정보를 파악하고 있어야 합니다.

SNMP 관리자로 사용할 머신의 IP 주소 또는 정규화된 도메인 이름. 선택적으로 SNMP 관리자가 트랩 통지를 수신하는 데 사용할 포트를 결정합니다. 기본 UDP 포트는 162입니다.
SNMP 커뮤니티. 다중 SNMP 관리자가 단일 커뮤니티에 속할 수 있습니다. 관리 시스템 및 에이전트는 동일한 커뮤니티에 있는 경우에만 통신할 수 있습니다. 기본 커뮤니티는 public입니다.
경보에 대한 트랩 객체 식별자. 엔진에서는 기본 OID인 1.3.6.1.4.1.2312.13.1.1을 제공합니다. 이 OID가 정의된 경우 이벤트 정보가 추가된 모든 트랩 유형이 SNMP 관리자에 전송됩니다.
주
- 기본 트랩을 변경하면 생성되는 트랩이 엔진의 Management Information Base를 준수하지 못하게 됩니다.
- 엔진에서는 /usr/share/doc/ovirt-engine/mibs/OVIRT-MIB.txt 및 /usr/share/doc/ovirt-engine/mibs/REDHAT-MIB.txt에서 Management Information Base를 제공합니다. 계속하기 전에 SNMP 관리자에서 MIB를 로드하십시오.

엔진에서 SNMP 트랩을 구성하려면 다음과 같이 하십시오.

Manager를 실행 중인 호스트에 로그인합니다.
엔진에서 SNMP 구성 파일을 만듭니다.
```
# vi /etc/ovirt-engine/notifier/notifier.conf.d/20-snmp.conf
```
이벤트 통지 구성 파일(ovirt-engine-notifier.conf)에서 엔진에 기본 SNMP 구성 값이 있습니다. 이 파일은 디렉토리 경로 /usr/share/ovirt-engine/services/ovirt-engine-notifier/ovirt-engine-notifier.conf에서 확인할 수 있습니다. 이 단계에서 제공된 값은 기본값 또는 해당 파일에서 제공된 값 예를 기반으로 합니다. 재부트 후에도 구성 설정이 지속적으로 저장되도록 하려면 ovirt-engine-notifier.conf 파일을 편집하는 대신 SNMP 구성(20-snmp.conf)에 대한 대체 파일을 정의합니다. 2.8.1절. “엔진에서 이벤트 통지 서비스 구성”을 참조하십시오.

다음 형식으로 SNMP 관리자, SNMP 커뮤니티 및 OID를 지정합니다.

SNMP_MANAGERS="manager1.example.com manager2.example.com:162"
 SNMP_COMMUNITY=public
 SNMP_OID=1.3.6.1.4.1.2312.13.1.1

20-snmp.conf 파일에서 다음 값을 구성할 수 있습니다.

#-------------------------#
# SNMP_TRAP Notifications #
#-------------------------#
# Send v2c snmp notifications

# Minimum SNMP configuration
#
# Create /etc/ovirt-engine/notifier/notifier.conf.d/20-snmp.conf with:
# SNMP_MANAGERS="host"
# FILTER="include:*(snmp:) ${FILTER}"

# Default whitespace separated IPv4/[IPv6]/DNS list with optional port, default is 162.
# SNMP_MANAGERS="manager1.example.com manager2.example.com:164"
SNMP_MANAGERS=


# Default SNMP Community String.
SNMP_COMMUNITY=public

# SNMP Trap Object Identifier for outgoing notifications.
# { iso(1) org(3) dod(6) internet(1) private(4) enterprises(1) redhat(2312) ovirt(13) engine(1) notifier(1) }
#
# Note: changing the default will prevent generated traps from complying with OVIRT-MIB.txt.
SNMP_OID=1.3.6.1.4.1.2312.13.1.1

# Default SNMP Version. SNMP version 2 and version 3 traps are supported
# 2 = SNMPv2
# 3 = SNMPv3
SNMP_VERSION=2

# The engine id used for SNMPv3 traps
SNMP_ENGINE_ID=

# The user name used for SNMPv3 traps
SNMP_USERNAME=

# The SNMPv3 auth protocol. Supported values are MD5 and SHA.
SNMP_AUTH_PROTOCOL=

# The SNMPv3 auth passphrase, used when SNMP_SECURITY_LEVEL is set to AUTH_NOPRIV and AUTH_PRIV
SNMP_AUTH_PASSPHRASE=

# The SNMPv3 privacy protocol. Supported values are AES128, AES192 and AES256.
# Be aware that AES192 and AES256 are not defined in RFC3826, so please verify
# that your SNMP server supports those protocols before enabling them.
SNMP_PRIVACY_PROTOCOL=

# The SNMPv3 privacy passphrase, used when SNMP_SECURITY_LEVEL is set to AUTH_PRIV
SNMP_PRIVACY_PASSPHRASE=

# The SNMPv3 security level.
# 1 = NOAUTH_NOPRIV
# 2 = AUTH_NOPRIV
# 3 = AUTH_PRIV
SNMP_SECURITY_LEVEL=1

#
# SNMP profile support
#
# Multiple SNMP profiles are supported.
# Specify profile settings by using _profile suffix,
# for example, to define a profile to sent specific
# message to host3, specify:
# SNMP_MANAGERS_profile1=host3
# FILTER="include:VDC_START(snmp:profile1) ${FILTER}"
#

SNMP 관리자로 전송할 이벤트를 정의합니다.
기본적으로 다음 기본 필터가 ovirt-engine-notifier.conf 파일에 정의되어 있습니다. 이 필터를 대체하거나 대체 필터를 적용하지 않으면 통지가 전송되지 않습니다.
```
 FILTER="exclude:\*"
```
이벤트 필터의 다른 일반적인 예는 다음과 같습니다.
- 모든 이벤트를 기본 SNMP 프로파일로 전송합니다.
```
FILTER="include:\*(snmp:) ${FILTER}"
```
- 심각도가 ERROR 또는 ALERT인 모든 이벤트를 기본 SNMP 프로파일로 전송합니다.
```
FILTER="include:\*:ERROR(snmp:) ${FILTER}"
 FILTER="include:\*:ALERT(snmp:) ${FILTER}"
```
파일을 저장합니다.
ovirt-engine-notifier 서비스를 시작하고 이 서비스가 부트 시 시작되는지 확인합니다.
```
 # systemctl start ovirt-engine-notifier.service
 # systemctl enable ovirt-engine-notifier.service
```
(선택사항) 트랩이 SNMP 관리자로 전송되고 있는지 검증합니다.