

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# FSx for ONTAP EMS 이벤트 모니터링
<a name="ems-events"></a>

NetApp ONTAP의 네이티브 이벤트 관리 시스템(EMS)을 사용하여 FSx for ONTAP 파일 시스템 이벤트를 모니터링할 수 있습니다. NetApp ONTAP CLI를 사용하여 이러한 이벤트를 볼 수 있습니다.

**Topics**
+ [EMS 이벤트 개요](#ems-events-overview)
+ [EMS 이벤트 보기](#view-ems-events)
+ [Syslog 서버로 EMS 이벤트 전달](#ems-log-forwarding)

## EMS 이벤트 개요
<a name="ems-events-overview"></a>

EMS 이벤트는 미리 정의된 조건이 FSx for ONTAP 파일 시스템에서 발생하면 자동으로 생성되는 알림입니다. 이러한 알림은 스토리지 가상 머신(SVM) 인증 문제 또는 전체 볼륨과 같은 더 큰 문제로 이어질 수 있는 문제를 예방하거나 수정할 수 있도록 지속적으로 정보를 제공합니다.

기본적으로 이벤트는 이벤트 관리 시스템 로그에 기록됩니다. EMS를 사용하면 사용자 암호 변경, FlexGroup 내 구성 요소가 최대 용량에 가까워진 경우, Logical Unit Number(LUN)를 수동으로 온라인 또는 오프라인으로 전환한 경우 또는 볼륨의 자동 크기 조정과 같은 이벤트를 모니터링할 수 있습니다.

ONTAP EMS 이벤트에 대한 자세한 내용은 NetApp ONTAP 설명서 센터의 [ONTAP EMS 참조](https://docs.netapp.com/us-en/ontap-ems-9121/index.html)를 참조하세요. 이벤트 범주를 표시하려면 문서의 왼쪽 탐색 창을 사용합니다.

**참고**  
FSx for ONTAP 파일 시스템에는 일부 ONTAP EMS 메시지만 사용할 수 있습니다. 사용 가능한 ONTAP EMS 메시지 목록을 보려면 NetApp ONTAP CLI [이벤트 카탈로그 표시](https://docs.netapp.com/us-en/ontap-cli-9131/event-catalog-show.html) 명령을 사용합니다.

EMS 이벤트 설명에는 이벤트 이름, 심각도, 가능한 원인, 로그 메시지, 대응 방법을 결정하는 데 도움이 되는 해결 조치가 포함됩니다. 예를 들어, [wafl.vol.autoSize.fail](https://docs.netapp.com/us-en/ontap-ems-9121/wafl-vol-events.html#wafl-vol-autosize-fail) 이벤트는 볼륨의 자동 크기 조정이 실패할 때 발생합니다. 이벤트 설명에 따르면 수정 조치는 자동 크기 조정을 설정하는 동안 볼륨의 최대 크기를 늘리는 것입니다.

## EMS 이벤트 보기
<a name="view-ems-events"></a>

이벤트 로그의 내용을 표시하려면 NetApp ONTAP CLI [이벤트 로그 show](https://docs.netapp.com/us-en/ontap-cli-9131/event-log-show.html) 명령을 사용합니다. 이 명령은 파일 시스템에 `fsxadmin` 역할이 있는 경우 사용할 수 있습니다. 명령 구문은 다음과 같습니다.

```
event log show [event_options]
```

가장 최근 이벤트가 먼저 나열됩니다. 기본적으로 이 명령은 다음 정보가 포함된 `EMERGENCY`, `ALERT`, 및 `ERROR` 심각도 수준 이벤트를 표시합니다.
+ **시간** - 이벤트 시간입니다.
+ **노드** - 이벤트가 발생한 노드입니다.
+ **심각도** - 이벤트의 심각도 수준입니다. `NOTICE`, `INFORMATIONAL` 또는 `DEBUG` 심각도 수준 이벤트를 표시하려면 `-severity` 옵션을 사용합니다.
+ **이벤트** - 이벤트 이름 및 메시지입니다.

이벤트에 대한 자세한 정보를 표시하려면 다음 표에 나열된 이벤트 옵션 중 하나 이상을 사용합니다.


| 이벤트 옵션 | 설명 | 
| --- | --- | 
|  `-detail`  |  추가 이벤트 정보를 표시합니다.  | 
|  `-detailtime`  |  역순으로 자세한 이벤트 정보를 표시합니다.  | 
|  `-instance`  |  모든 필드에 대한 세부 정보를 표시합니다.  | 
|  `-node nodename\|local`  |  지정한 노드의 이벤트 목록을 표시합니다. 이 옵션을 `-seqnum`과 함께 사용하면 자세한 정보를 표시할 수 있습니다.  | 
| `-seqnum sequence_number` | 시퀀스에서 이 번호와 일치하는 이벤트를 선택합니다. `-node`와 함께 사용하면 자세한 정보를 표시할 수 있습니다. | 
| `-time MM/DD/YYYY HH:MM:SS` | 이 특정 시간에 발생한 이벤트를 선택합니다. MM/DD/YYYY HH:MM:SS [\$1- HH:MM] 형식을 사용합니다. 두 시간 문 사이에 `..` 연산자를 사용하여 시간 범위를 지정할 수 있습니다. <pre>event log show -time "04/17/2023 05:55:00".."04/17/2023 06:10:00"</pre> 비교 시간 값은 명령을 실행할 때의 현재 시간을 기준으로 합니다. 다음 예제에서는 최근 1분 내에 발생한 이벤트만 표시하는 방법을 보여줍니다. <pre>event log show -time >1m</pre> 이 옵션의 월 및 날짜 필드는 0으로 채워지지 않습니다. 이러한 필드는 한 자리 숫자일 수 있습니다(예:`4/1/2023 06:45:00`).  | 
|  `-severity sev_level`  |  *sev\$1level* 값과 일치하는 이벤트를 선택합니다. 이 값은 다음 중 하나여야 합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/fsx/latest/ONTAPGuide/ems-events.html) 모든 이벤트를 표시하려면 다음과 같이 심각도를 지정합니다. <pre>event log show -severity <=DEBUG</pre>  | 
|  `-ems-severity ems_sev_level`  |  *ems\$1sev\$1level* 값과 일치하는 이벤트를 선택합니다. 이 값은 다음 중 하나여야 합니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/fsx/latest/ONTAPGuide/ems-events.html) 모든 이벤트를 표시하려면 다음과 같이 심각도를 지정합니다. <pre>event log show -ems-severity <=DEBUG</pre>  | 
|  `-source text`  |  *text* 값과 일치하는 이벤트를 선택합니다. 소스는 일반적으로 소프트웨어 모듈입니다.  | 
|  `-message-name message_name`  |  *message\$1name* 값과 일치하는 이벤트를 선택합니다. 메시지 이름은 설명적이므로 메시지 이름별로 출력을 필터링하면 특정 유형의 메시지가 표시됩니다.  | 
|  `-event text`  |  *text* 값과 일치하는 이벤트를 선택합니다. `event` 필드에는 파라미터를 비롯한 이벤트의 전체 텍스트가 포함됩니다.  | 
|  `-kernel-generation-num integer`  |  *integer* 값과 일치하는 이벤트를 선택합니다. 커널에서 오는 이벤트에만 커널 생성 번호가 있습니다.  | 
|  `-kernel-sequence-num integer`  |  *integer* 값과 일치하는 이벤트를 선택합니다. 커널에서 오는 이벤트에만 커널 시퀀스 번호가 있습니다.  | 
|  `-action text`  |  *text* 값과 일치하는 이벤트를 선택합니다. `action` 필드는 상황을 해결하기 위해 취해야 하는 수정 조치(있는 경우)를 설명합니다.  | 
|  `-description text`  |  *text* 값과 일치하는 이벤트를 선택합니다. `description` 필드는 이벤트가 발생한 이유와 그 의미를 설명합니다.  | 
|  `-filter-name filter_name`  |  *filter\$1name* 값과 일치하는 이벤트를 선택합니다. 기존 필터에 의해 포함된 이벤트 중 이 값과 일치하는 이벤트만 표시됩니다.  | 
|  `-fields fieldname,...`  |  지정된 필드도 명령 출력에 포함됨을 나타냅니다. `-fields ?`를 사용하여 지정하려는 필드를 선택할 수 있습니다.  | 

**EMS 이벤트 보기**

1. 파일 시스템의 NetApp ONTAP CLI에 SSH를 설정하려면 *Amazon FSx for NetApp ONTAP 사용 설명서*의 [NetApp ONTAP CLI 사용](managing-resources-ontap-apps.md#netapp-ontap-cli) 섹션에 설명된 단계를 따릅니다.

   ```
   ssh fsxadmin@file-system-management-endpoint-ip-address
   ```

1. `event log show` 명령을 사용하여 이벤트 로그의 내용을 표시합니다.

   ```
   ::> event log show
   Time                Node          Severity      Event
   ------------------- ------------- ------------- ------------------------
   6/30/2023 13:54:19  node1         NOTICE        vifmgr.portup: A link up event was received on node node1, port e0a.
   6/30/2023 13:54:19  node1         NOTICE        vifmgr.portup: A link up event was received on node node1, port e0d.
   ```

`event log show` 명령에 의해 반환되는 EMS 이벤트에 대한 자세한 내용은 NetApp ONTAP 설명서 센터의 [ONTAP EMS 참조](https://docs.netapp.com/us-en/ontap-ems-9121/index.html)를 참조하세요.

## Syslog 서버로 EMS 이벤트 전달
<a name="ems-log-forwarding"></a>

알림을 Syslog 서버에 전달하도록 EMS 이벤트를 구성할 수 있습니다. EMS 이벤트 전달은 파일 시스템을 실시간으로 모니터링하여 다양한 문제의 근본 원인을 파악하고 격리하는 데 사용됩니다. 환경에 이벤트 알림을 위한 Syslog 서버가 아직 포함되어 있지 않은 경우 먼저 서버를 생성해야 합니다. Syslog 서버 이름을 확인하려면 파일 시스템에 DNS를 구성해야 합니다.

**참고**  
Syslog 대상은 파일 시스템에서 사용하는 기본 서브넷에 있어야 합니다.

**알림을 Syslog 서버로 전달하도록 EMS 이벤트를 구성하려면**

1.  파일 시스템의 NetApp ONTAP CLI에 SSH를 설정하려면 *Amazon FSx for NetApp ONTAP 사용 설명서*의 [NetApp ONTAP CLI 사용](managing-resources-ontap-apps.md#netapp-ontap-cli) 섹션에 설명된 단계를 따릅니다.

   ```
   ssh fsxadmin@file-system-management-endpoint-ip-address
   ```

1. [이벤트 알림 대상 생성](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-destination-create.html) 명령을 사용하여 다음 속성을 지정하여 `syslog` 유형의 이벤트 알림 대상을 생성합니다.
   + `dest_name` - 생성할 알림 대상의 이름입니다(예: `syslog-ems`). 이벤트 알림 대상 이름은 2\$164자여야 합니다. 유효한 문자는 A-Z, a-z, 0-9, '\$1' 및 '-'와 같은 ASCII 문자입니다. 이름은 A-Z, a-z 또는 0-9로 시작하고 끝나야 합니다.
   + `syslog_name` - Syslog 메시지가 전송되는 Syslog 서버 호스트 이름 또는 IP 주소입니다.
   + `transport_protocol` – 이벤트를 보내는 데 사용되는 프로토콜.
     + `udp-unencrypted` - 보안이 없는 사용자 Datagram 프로토콜입니다. 이것이 기본 프로토콜입니다.
     + `tcp-unencrypted` - 보안이 없는 전송 제어 프로토콜.
     + `tcp-encrypted` – 전송 계층 보안(TLS)을 사용하는 전송 제어 프로토콜. 이 옵션을 지정하면 FSx for ONTAP는 인증서를 검증하여 대상 호스트의 ID를 확인합니다.
   + `port_number` - Syslog 메시지가 전송되는 Syslog 서버 포트입니다. 기본값 `syslog-port` 파라미터는 `syslog-transport` 파라미터 설정에 따라 달라집니다. `syslog-transport`가 `tcp-encrypted`로 설정된 경우 `syslog-port` 기본값은 `6514`입니다. `syslog-transport`가 `tcp-unencrypted`로 설정된 경우 `syslog-port`는 기본값 `601`를 갖습니다. 그렇지 않으면 기본 포트가 `514`로 설정됩니다.

   ```
   ::> event notification destination create -name dest_name -syslog syslog_name -syslog-transport transport_protocol -syslog-port port_number
   ```

1. [이벤트 알림 생성](https://docs.netapp.com/us-en/ontap-cli-9131/event-notification-create.html) 명령을 사용하여 이벤트 필터에 의해 정의된 이벤트 세트에 대해 다음 속성을 지정하여 이전 단계에서 생성된 알림 대상으로 새 알림을 생성합니다.
   + `node_name` - 이벤트 필터의 이름입니다. 이벤트 필터에 포함된 이벤트는 `-destinations` 파라미터에 지정된 대상으로 전달됩니다.
   + `dest_name` - 이벤트 알림이 전송되는 기존 알림 대상의 이름입니다.

   ```
   ::> event notification create -filter-name filter_name -destinations dest_name
   ```

1. TCP를 `transport_protocol`로 선택한 경우 `event notification destination check` 명령을 사용하여 테스트 메시지를 생성하고 설정이 작동하는지 확인할 수 있습니다. 명령으로 다음 속성을 지정합니다.
   + `node_name` - 노드의 이름(예: `FsxId07353f551e6b557b4-01`)입니다.
   + `dest_name` - 이벤트 알림이 전송되는 기존 알림 대상의 이름입니다.

   ```
   ::> set diag
   ::*> event notification destination check -node node_name -destination-name dest_name
   ```