

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

# Amazon CloudWatch를 사용한 지표 모니터링
<a name="monitoring-cloudwatch"></a>

Amazon EFS에서 원시 데이터를 수집하여 읽기 가능하며 실시간에 가까운 지표로 처리하는 Amazon CloudWatch를 통해 파일 시스템을 모니터링할 수 있습니다. 이러한 통계는 15개월간 기록되므로 웹 애플리케이션이나 서비스가 어떻게 실행되고 있는지 전체적으로 더 잘 파악할 수 있습니다.

기본적으로 Amazon EFS 지표 데이터는 일부 개별 지표에 대해 별도로 명시되지 않는 한 1분 간격으로 CloudWatch로 자동 전송됩니다. Amazon EFS 콘솔에는 Amazon CloudWatch의 원시 데이터를 기초로 하는 일련의 그래프가 표시됩니다. 필요에 따라 콘솔의 그래프 대신에 Amazon CloudWatch에서 파일 시스템의 데이터를 얻는 것을 선호할 수도 있습니다.

Amazon CloudWatch에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*의 [Amazon CloudWatch란 무엇입니까?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)를 참조하세요.

아마존 EFS CloudWatch 지표는 원시 바이트**로 보고됩니다. 바이트는 단위의 십진수나 이진수에 반올림되지 않습니다.

**Topics**
+ [Amazon EFS에 대한 CloudWatch 지표](efs-metrics.md)
+ [Amazon EFS용 CloudWatch 지표 액세스](accessingmetrics.md)
+ [Amazon EFS용 CloudWatch 지표 사용](how_to_use_metrics.md)
+ [CloudWatch 지표와 함께 지표 수식 사용](monitoring-metric-math.md)
+ [탑재 시도 성공 또는 실패 모니터링](how-to-monitor-mount-status.md)
+ [Amazon EFS 모니터링을 위한 CloudWatch 경보 생성](creating_alarms.md)

# Amazon EFS에 대한 CloudWatch 지표
<a name="efs-metrics"></a>

Amazon EFS 지표에는 `EFS` 네임스페이스가 사용됩니다. `AWS/EFS` 네임스페이스에는 다음과 같은 지표가 포함됩니다. `TimeSinceLastSync`를 제외한 모든 지표는 단일 차원 `FileSystemId`에 대한 것입니다. 파일 시스템의 ID는 Amazon EFS 콘솔에서 찾아볼 수 있으며, 그 형식은 `fs-abcdef0123456789a`를 따릅니다.



**`TimeSinceLastSync`**  
복제 구성에서 대상 파일 시스템에 마지막으로 성공적으로 동기화한 이후 경과된 시간을 표시합니다. `TimeSinceLastSync` 값이 성공적으로 복제되기 전에 발생한 소스 파일 시스템의 모든 데이터 변경은 성공적으로 복제되었습니다. `TimeSinceLastSync` 이후에 발생한 소스의 모든 변경 사항은 완전히 복제되지 않을 수 있습니다.  
이 지표에는 다음 두 가지 차원이 사용됩니다.  
+ `FileSystemId` 차원 - 복제 구성에서 소스 파일 시스템의 ID입니다.
+ `DestinationFileSystemId` 차원 - 복제 구성에서 대상 파일 시스템의 ID입니다.
단위: 초  
유효한 통계: `Minimum`, `Maximum`, `Average` 

**`PercentIOLimit`**  
파일 시스템이 범용 성능 모드의 I/O 제한에 얼마나 가깝게 도달해있는지 나타냅니다.  
단위: 백분율  
유효한 통계: `Minimum`, `Maximum`, `Average` 

**`BurstCreditBalance`**  
파일 시스템의 버스트 크레딧 수 파일 시스템은 버스트 크레딧을 사용하여 일정 시간 파일 시스템의 기준 레벨을 넘는 처리량 레벨까지 버스팅할 수 있습니다.  
`Minimum` 통계는 해당 기간을 통틀어서 가장 작은 버스트 크레딧 밸런스를 말합니다. `Maximum` 통계는 해당 기간을 통틀어서 가장 큰 버스트 크레딧 밸런스를 말합니다. 그리고 `Average` 통계는 해당 기간 중 평균 버스트 크레딧 밸런스를 말합니다.  
단위: 바이트  
유효한 통계: `Minimum`, `Maximum`, `Average` 

**`PermittedThroughput`**  
파일 시스템이 구동할 수 있는 최대 처리량입니다.  
+ 탄력적 처리량 모드를 사용하는 파일 시스템의 경우 이 값은 파일 시스템의 최대 쓰기 처리량을 반영합니다.
+ 프로비저닝된 처리량 모드를 사용하는 파일 시스템의 경우 EFS Standard 스토리지 클래스에 저장된 데이터의 양으로 인해 파일 시스템이 프로비저닝된 것보다 많은 양을 처리할 수 있는 경우 이 지표는 프로비저닝된 용량 대신 더 높은 처리량을 반영합니다.
+ 버스팅 처리량에서 파일 시스템의 경우, 이 값은 파일 시스템 크기 및 `BurstCreditBalance`에 따라 달라집니다.
`Minimum` 통계는 해당 기간을 통틀어서 최소 허용 처리량을 말합니다. `Maximum` 통계는 해당 기간을 통틀어서 최고 허용 처리량을 말합니다. 그리고 `Average` 통계는 해당 기간 중 평균 허용 처리량을 말합니다.  
읽기 작업은 다른 작업의 3분의 1 비율로 측정됩니다.
단위: 바이트/초  
유효한 통계: `Minimum`, `Maximum`, `Average` 

**`MeteredIOBytes`**  
데이터 읽기, 데이터 쓰기 및 메타데이터 작업을 포함하여 각 파일 시스템 작업에 대해 측정된 바이트 수로, 처리량 제한에 따라 읽기 작업이 할인됩니다.  
`MeteredIOBytes`를 `PermittedThroughput`와 비교하는 [CloudWatch 지표 수식 표현식](monitoring-metric-math.md#metric-math-throughput-utilization)을 생성할 수 있습니다. 이 값이 같으면 파일 시스템에 할당된 전체 처리량을 소비하게 됩니다. 이 경우 처리량을 높이기 위해 파일 시스템의 처리량 모드를 변경하는 것을 고려할 수 있습니다.  
`Sum` 통계는 모든 파일 시스템 작업과 연결되어 측정된 총 바이트 수입니다. `Minimum` 통계는 해당 기간 중 가장 작은 작업의 크기입니다. `Maximum` 통계는 해당 기간 중 가장 큰 작업의 크기입니다. `Average` 통계는 해당 기간 중 작업의 평균 크기입니다. `SampleCount` 통계는 모든 작업의 수를 제공합니다.  
단위:  
+ `Minimum`, `Maximum`, `Average` 및 `Sum` 통계일 때 바이트
+ `SampleCount` 통계일 때 수
유효한 통계: `Minimum`, `Maximum`, `Average`, `Sum`, `SampleCount` 

** TotalIOBytes **  
읽기 할인 없이 Amazon EFS에서 처리하는 각 파일 시스템 작업의 실제 바이트 수입니다. 이 숫자에는 최소값이 포함되어 있으므로 애플리케이션에서 요청한 실제 금액과 다를 수 있습니다. 이 숫자는 `PermittedThroughput`에 표시된 숫자보다 높을 수도 있습니다.  
데이터 작업은 32KiB에서 측정되고 다른 작업은 4KiB에서 측정됩니다. 최소값이 지나면 모든 작업이 KiB당 측정됩니다.  
`Sum` 통계는 모든 파일 시스템 작업과 연결된 총 바이트 수입니다. `Minimum` 통계는 해당 기간 중 가장 작은 작업의 크기입니다. `Maximum` 통계는 해당 기간 중 가장 큰 작업의 크기입니다. `Average` 통계는 해당 기간 중 작업의 평균 크기입니다. `SampleCount` 통계는 모든 작업의 수를 제공합니다.  
일정 기간 초당 평균 작업 수를 계산하려면 `SampleCount` 통계를 초 단위의 해당 기간으로 나누면 됩니다. 일정 기간 평균 처리량(바이트/초)을 계산하려면 `Sum` 통계를 초 단위의 해당 기간으로 나누면 됩니다.
단위:  
+ `Minimum`, `Maximum`, `Average` 및 `Sum` 통계일 때 바이트
+ `SampleCount` 통계일 때 수
유효한 통계: `Minimum`, `Maximum`, `Average`, `Sum`, `SampleCount` 

**`DataReadIOBytes`**  
각 파일 시스템 읽기 작업의 실제 바이트 수입니다.  
`Sum` 통계는 읽기 작업과 연결된 총 바이트 수입니다. `Minimum` 통계는 해당 기간 중 가장 작은 읽기 작업의 크기입니다. `Maximum` 통계는 해당 기간 중 가장 큰 읽기 작업의 크기입니다. `Average` 통계는 해당 기간 중 읽기 작업의 평균 크기입니다. 그리고 `SampleCount` 통계는 읽기 작업의 수를 제공합니다.  
단위:  
+ `Minimum`, `Maximum`, `Average` 및 `Sum` 통계일 때 바이트
+ `SampleCount` 통계일 때 수
유효한 통계: `Minimum`, `Maximum`, `Average`, `Sum`, `SampleCount` 

**`DataWriteIOBytes`**  
각 파일 시스템 쓰기 작업의 실제 바이트 수입니다.  
`Sum` 통계는 쓰기 작업과 연결된 총 바이트 수입니다. `Minimum` 통계는 해당 기간 중 가장 작은 쓰기 작업의 크기입니다. `Maximum` 통계는 해당 기간 중 가장 큰 쓰기 작업의 크기입니다. `Average` 통계는 해당 기간 중 쓰기 작업의 평균 크기입니다. 그리고 `SampleCount` 통계는 쓰기 작업의 수를 제공합니다.  
단위:  
+ `Minimum`, `Maximum`, `Average` 및 `Sum` 통계일 때 바이트
+ `SampleCount` 통계일 때 수
유효한 통계: `Minimum`, `Maximum`, `Average`, `Sum`, `SampleCount` 

**`MetadataIOBytes`**  
각 메타데이터 작업의 실제 바이트 수입니다.  
`Sum` 통계는 메타데이터 작업과 연결된 총 바이트 수입니다. `Minimum` 통계는 해당 기간 중 가장 작은 메타데이터 작업의 크기입니다. `Maximum` 통계는 해당 기간 중 가장 큰 메타데이터 작업의 크기입니다. `Average` 통계는 해당 기간 중 평균 메타데이터 작업의 크기입니다. 그리고 `SampleCount` 통계는 메타데이터 작업의 수를 제공합니다.  
단위:  
+ `Minimum`, `Maximum`, `Average` 및 `Sum` 통계일 때 바이트
+ `SampleCount` 통계일 때 수
유효한 통계: `Minimum`, `Maximum`, `Average`, `Sum`, `SampleCount` 

**`MetadataReadIOBytes`**  
각 메타데이터 읽기 작업의 실제 바이트 수입니다.  
`Sum` 통계는 메타데이터 읽기 작업과 관련된 총 바이트 수입니다. `Minimum` 통계는 해당 기간 중 가장 작은 메타데이터 읽기 작업의 크기입니다. `Maximum` 통계는 해당 기간 중 가장 큰 메타데이터 읽기 작업의 크기입니다. `Average` 통계는 해당 기간 중 메타데이터 읽기 작업의 평균 크기입니다. `SampleCount` 통계는 메타데이터 읽기 작업의 수를 제공합니다.  
단위:  
+ `Minimum`, `Maximum`, `Average` 및 `Sum` 통계일 때 바이트
+ `SampleCount` 통계일 때 수
유효한 통계: `Minimum`, `Maximum`, `Average`, `Sum`, `SampleCount` 

**`MetadataWriteIOBytes`**  
각 메타데이터 쓰기 작업의 실제 바이트 수입니다.  
`Sum` 통계는 메타데이터 쓰기 작업과 관련된 총 바이트 수입니다. `Minimum` 통계는 해당 기간 중 가장 작은 메타데이터 쓰기 작업의 크기입니다. `Maximum` 통계는 해당 기간 중 가장 큰 메타데이터 쓰기 작업의 크기입니다. `Average` 통계는 해당 기간 중 메타데이터 쓰기 작업의 평균 크기입니다. `SampleCount` 통계는 메타데이터 쓰기 작업의 수를 제공합니다.  
단위:  
+ `Minimum`, `Maximum`, `Average` 및 `Sum` 통계일 때 바이트
+ `SampleCount` 통계일 때 수
유효한 통계: `Minimum`, `Maximum`, `Average`, `Sum`, `SampleCount` 

**`ClientConnections`**  
파일 시스템에 연결된 클라이언트 수 표준 클라이언트를 사용할 경우 탑재된 Amazon EC2 인스턴스마다 하나씩 연결됩니다.  
1분 이상의 기간에 대한 평균 `ClientConnections`를 계산하려면 `Sum` 통계를 기간(분 단위)으로 나눕니다.
단위: 클라이언트 연결 수  
유효한 통계: `Sum`

**`StorageBytes`**  
EFS 스토리지 클래스에 저장된 데이터 양을 포함한 파일 시스템의 크기(바이트)입니다. 이 지표는 15분마다 CloudWatch로 전송됩니다.  
이 `StorageBytes` 지표에는 다음과 같은 차원이 있습니다.  
+ `Total`은 모든 스토리지 클래스에서 파일 시스템에 저장된 데이터의 측정된 크기(바이트)입니다. EFS Infrequent Access(IA) 및 EFS Archive 스토리지 클래스의 경우 128KiB보다 작은 파일은 128KiB 반올림됩니다.
+  `Standard`는 EFS Standard 스토리지 클래스에 저장된 데이터의 측정된 크기(바이트)입니다.
+  `IA`는 EFS Infrequent Access 스토리지 클래스에 저장된 데이터의 실제 크기(바이트)입니다.
+ `IASizeOverhead`는 EFS Infrequent Access 스토리지 클래스의 실제 데이터 크기(`IA` 차원에 표시됨)와 스토리지 클래스의 측정된 크기 사이의 차이(바이트)로, 작은 파일은 128KiB로 반올림한 후 계산합니다.
+ `Archive`는 EFS Archive 스토리지 클래스에 저장된 데이터의 실제 크기(바이트)입니다.
+ `ArchiveSizeOverhead`는 EFS Archive 스토리지 클래스의 실제 데이터 크기(`Archive` 차원에 표시됨)와 스토리지 클래스의 측정된 크기 사이의 차이(바이트)로, 작은 파일은 128KiB로 반올림한 후 계산합니다.
단위: 바이트  
유효한 통계: `Minimum`, `Maximum`, `Average`   
`StorageBytes`는 기본 1024 단위(키비바이트, 메비바이트, 기가바이트, 테비바이트)를 사용하여 Amazon EFS 콘솔 **파일 시스템 지표** 페이지에 표시됩니다.

# Amazon EFS용 CloudWatch 지표 액세스
<a name="accessingmetrics"></a>

다음과 같은 여러 가지 방법으로 CloudWatch에 대한 Amazon EFS 지표를 볼 수 있습니다.
+ Amazon EFS 콘솔에서
+ CloudWatch 콘솔에서
+ CloudWatch CLI 사용
+ CloudWatch API 사용

## CloudWatch 지표 및 경보를 보려면(Amazon EFS 콘솔)
<a name="view-metrics-console"></a>

1. 에 로그인 AWS Management Console 하고 [ https://console.aws.amazon.com/efs/](https://console.aws.amazon.com/efs/) Amazon EFS 콘솔을 엽니다.

1. **파일 시스템**을 선택합니다.

1. CloudWatch 지표를 확인하고자 하는 파일 시스템을 선택합니다.

1. **모니터링을** 선택하여 **파일 시스템 지표** 페이지를 표시합니다.

   **파일 시스템 지표** 페이지에는 파일 시스템에 대한 기본 CloudWatch 지표 세트가 표시됩니다. 구성한 모든 CloudWatch 경보도 이러한 지표와 함께 표시됩니다. 최대 I/O 성능 모드를 사용하는 파일 시스템의 경우 기본 지표 세트에는 입출력 비율 제한 대신 버스트 크레딧 밸런스가 포함됩니다. 설정을 열면 액세스할 수 있는 **지표 설정** 대화 상자를 사용하여 기본 설정을 재정의할 수 있습니다.
**참고**  
처리량 사용률(%) 지표는 CloudWatch 지표가 아니라 CloudWatch 측정치 계산을 사용하여 도출됩니다.

1. 다음과 같이 **파일 시스템 지표** 페이지의 컨트롤을 사용하여 지표와 경보가 표시되는 방식을 조정할 수 있습니다.
   + **디스플레이 모드**를 **시계열** 또는 **단일 값** 사이에서 전환합니다.
   + 파일 시스템에 구성된 CloudWatch 경보를 표시하거나 숨깁니다.
   + **CloudWatch에서 더 보기**를 선택하여 CloudWatch에서 지표를 확인하세요.
   + **대시보드에 추가**를 선택하여 CloudWatch 대시보드를 열고 표시된 지표를 추가합니다.
   + 표시된 지표 시간 창을 1시간에서 1주일로 조정합니다.

## CloudWatch 지표 및 경보를 보려면(CloudWatch 콘솔)
<a name="view-metrics-cw-console"></a>

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **지표**를 선택합니다.

1. **EFS** 네임스페이스를 선택합니다.

1. (선택 사항)지표를 보려면 검색 필드에 이름을 입력합니다.

1. (선택 사항)차원을 기준으로 필터링하려면 **FileSystemId**를 선택합니다.

## 에서 지표에 액세스하려면 AWS CLI
<a name="view-metrics-cli"></a>
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/list-metrics.html) 명령과 `--namespace "AWS/EFS"` 네임스페이스를 사용합니다. 자세한 내용은 [AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/)를 참조하세요.

## CloudWatch API에서 지표에 액세스하려면
<a name="view-metrics-cli"></a>
+ `[https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_GetMetricStatistics.html)`를 호출합니다. 자세한 내용은 [CloudWatch API 참조](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)를 참조하세요.

# Amazon EFS용 CloudWatch 지표 사용
<a name="how_to_use_metrics"></a>

Amazon EFS에서 보고하는 지표는 다양한 방법으로 분석이 기능한 정보를 제공합니다. 다음 목록은 몇 가지 일반적인 지표 사용 사례를 보여 줍니다. 모든 사용 사례를 망라한 것은 아니지만 시작하는 데 참고가 될 것입니다.


| 방법 | 관련 지표 | 
| --- | --- | 
| 처리량은 어떻게 확인할 수 있습니까? | 매일 `TotalIOBytes` 지표의 `Sum` 통계를 모니터링하여 처리량을 확인할 수 있습니다.  | 
|  전송된 총 데이터 양을 확인하려면 어떻게 해야 하나요?  | MeteredIOBytes의 일일 Sum 통계를 모니터링하여 전송된 총 데이터를 볼 수 있습니다. | 
| 파일 시스템에 연결된 Amazon EC2 인스턴스 개수는 어떻게 추적할 수 있습니까? | `ClientConnections` 지표의 `Sum` 통계를 모니터링할 수 있습니다. 1분 이상의 기간에 대한 평균 `ClientConnections`를 계산하려면 합계를 기간(분 단위)으로 나눕니다. | 
| 버스트 크레딧 잔고는 어떻게 확인할 수 있나요? | 파일 시스템의 `BurstCreditBalance` 지표를 모니터링하여 잔고를 확인할 수 있습니다. 버스팅 및 버스트 크레딧에 대한 자세한 내용은 [버스팅 처리량](performance.md#bursting) 단원을 참조하세요.  | 

## 처리량 성능 모니터링
<a name="monitor-throughput-performance"></a>

처리량 모니터링을 위한 CloudWatch 지표(`TotalIOBytes`, `ReadIOBytes`, `WriteIOBytes`, `MetadataIOBytes`)는 파일 시스템에서 발생하는 실제 처리량을 나타냅니다. 지표 `MeteredIOBytes`는 구동 중인 전체 측정된 처리량의 계산을 나타냅니다. Amazon EFS 콘솔 **모니터링** 섹션의 **처리량 사용률(%)** 그래프를 사용하여 처리량 사용률을 모니터링할 수 있습니다. 사용자 지정 Amazon CloudWatch 대시보드 또는 다른 모니터링 도구를 사용하는 경우 `MeteredIOBytes`를 `PermittedThroughput`과 비교하는 [CloudWatch 지표 수식](monitoring-metric-math.md#metric-math-throughput-utilization)을 생성할 수 있습니다.

`PermittedThroughput`은 파일 시스템에 허용되는 처리량을 측정합니다. 이 값은 다음 방법 중 하나를 기반으로 합니다.
+ 탄력적 처리량을 사용하는 파일 시스템의 경우 이 값은 파일 시스템의 최대 쓰기 처리량을 반영합니다.
+ 프로비저닝된 처리량 모드를 사용하는 파일 시스템의 경우 EFS Standard 스토리지 클래스에 저장된 데이터의 양으로 인해 파일 시스템이 프로비저닝된 것보다 많은 양을 처리할 수 있는 경우 이 지표는 프로비저닝된 용량 대신 더 높은 처리량을 반영합니다.
+ 버스팅 처리량을 사용하는 파일 시스템의 경우 이 값은 파일 시스템 크기 및 `BurstCreditBalance`의 함수입니다. `BurstCreditBalance`를 모니터링하여 파일 시스템이 기본 속도가 아닌 버스트 속도로 작동하고 있는지 확인하세요. 잔고가 지속적으로 0이거나 0에 가까운 경우 추가 처리량을 확보하려면 탄력적 처리량 또는 프로비저닝된 처리량으로 전환하는 것이 좋습니다.

`MeteredIOBytes`과 `PermittedThroughput` 값이 같으면 파일 시스템이 사용 가능한 모든 처리량을 소비하게 됩니다. 프로비저닝된 처리량을 사용하는 파일 시스템의 경우 추가 처리량을 프로비저닝할 수 있습니다.

# CloudWatch 지표와 함께 지표 수식 사용
<a name="monitoring-metric-math"></a>

지표 수식을 사용하면 여러 Amazon CloudWatch 지표를 쿼리하고 수식을 사용하여 이러한 지표를 기반으로 새로운 시계열을 생성할 수 있습니다. CloudWatch 콘솔에서 결과 시계열을 시각화하고 대시보드에 추가할 수 있습니다. 예를 들어, Amazon EFS 지표를 사용해 60으로 나눈 `DataRead` 작업의 샘플 수를 가져올 수 있습니다. 1분 동안 파일 시스템의 초당 읽기 수(평균)입니다. 지표 수학에 대한 자세한 내용은 *Amazon CloudWatch 사용 설명서*에서 [CloudWatch 지표에 수학 표현식 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html)을 참조하세요.

다음은 Amazon EFS에 유용하게 사용할 수 있는 지표 수식 표현식입니다.

**Topics**
+ [지표 수식: 처리량(MiB/초)](#metric-math-throughput-mib)
+ [지표 수식: 처리량(%)](#metric-math-throughput-percent)
+ [지표 수식: 허용 처리량 사용률 백분율](#metric-math-throughput-utilization)
+ [지표 수식: 처리량 IOPS](#metric-math-throughput-iops)
+ [지표 수식: IOPS(%)](#metric-math-iops-percent)
+ [지표 수식: 평균 I/O 크기(KiB)](#metric-math-average-io)
+ [Amazon EFS용 CloudFormation 템플릿을 통한 지표 수학 사용](#metric-math-cloudformation-template)

## 지표 수식: 처리량(MiB/초)
<a name="metric-math-throughput-mib"></a>

특정 기간에 대한 평균 처리량(MiB/초)을 계산하려면, 먼저 합계 통계(`DataReadIOBytes`, `DataWriteIOBytes`, `MetadataIOBytes` 또는 `TotalIOBytes`)를 선택합니다. 그런 다음 MiB로 값을 변환한 후 기간을 초로 계산한 수로 나눕니다.

예가 되는 로직이 '`TotalIOBytes` 합계 ÷ 1048576(MiB로 변환) ÷ 초(기간을 초로 계산)'이라고 가정하겠습니다.

이 경우, CloudWatch 지표 정보는 다음과 같습니다.


| ID | 사용 가능한 지표 | 통계 | Period | 
| --- | --- | --- | --- | 
| m1 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 합계 | 1분 | 

지표 수식 ID와 표현식은 다음과 같습니다.


| ID | 표현식 | 
| --- | --- | 
| e1 | (m1/1048576)/PERIOD(m1) | 

## 지표 수식: 처리량(%)
<a name="metric-math-throughput-percent"></a>

이 지표 수식 표현식은 다양한 I/O 유형에 사용되는 전체 처리량 중 백분율(예: 총 처리량 중 읽기 요청으로 구동되는 비율)을 계산합니다. 특정 기간의 여러 I/O 유형(`DataReadIOBytes`, `DataWriteIOBytes` 또는 `MetadataIOBytes`) 중 하나가 사용하는 전체 처리량(%)을 계산하려면 먼저 각 합계 통계에 100을 곱합니다. 그런 다음 같은 기간 동안 `TotalIOBytes`의 합계 통계로 결과를 나눕니다.

예가 되는 로직이 '(`DataReadIOBytes` 합계 x 100 (퍼센트로 변환)) ÷ `TotalIOBytes` 합계'라고 가정하겠습니다.

이 경우, CloudWatch 지표 정보는 다음과 같습니다.


| ID | 사용 가능한 지표 | 통계 | Period | 
| --- | --- | --- | --- | 
| m1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 합계 | 1분 | 
| m2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 합계 | 1분 | 

지표 수식 ID와 표현식은 다음과 같습니다.


| ID | 표현식 | 
| --- | --- | 
| e1 | (m2\$1100)/m1 | 

## 지표 수식: 허용 처리량 사용률 백분율
<a name="metric-math-throughput-utilization"></a>

특정 기간의 허용 처리량 사용률(`MeteredIOBytes`)의 비율(%)을 계산하려면 먼저 처리량(MiB/초)에 100을 곱합니다. 그런 다음 같은 기간 동안 MiB로 변환한 `PermittedThroughput`의 평균 통계로 결과를 나눕니다.

예시가 되는 로직이 '(처리량(Mib/초)에 대한 지표 수식 표현식 x 100(퍼센트로 변환)) ÷ (`PermittedThroughput`의 합계 ÷ 1,048,576(바이트를 MiB로 변환))'이라고 가정하겠습니다.

이 경우, CloudWatch 지표 정보는 다음과 같습니다.


| ID | 사용 가능한 지표 | 통계 | Period | 
| --- | --- | --- | --- | 
| m1 |  `MeteredIOBytes`  | 합계 | 1분 | 
| m2 | `PermittedThroughput` | 평균 | 1분 | 

지표 수식 ID와 표현식은 다음과 같습니다.


| ID | 표현식 | 
| --- | --- | 
| e1 |   (m1/1048576)/PERIOD(m1)  | 
| e2 | m2/1048576 | 
| e3 | ((e1)\$1100)/(e2) | 

## 지표 수식: 처리량 IOPS
<a name="metric-math-throughput-iops"></a>

특정 기간에 대한 초당 평균 작업(IOPS)를 계산하려면 샘플 수 통계(`DataReadIOBytes`, `DataWriteIOBytes`, `MetadataIOBytes`, `TotalIOBytes`)를 해당 기간의 초로 나눕니다.

예가 되는 로직이 '`DataWriteIOBytes` 샘플 수 ÷ 초(기간을 초로 계산)'이라고 가정하겠습니다.

이 경우, CloudWatch 지표 정보는 다음과 같습니다.


| ID | 사용 가능한 지표 | 통계 | Period | 
| --- | --- | --- | --- | 
| m1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 샘플 수 | 1분 | 

지표 수식 ID와 표현식은 다음과 같습니다.


| ID | 표현식 | 
| --- | --- | 
| e1 | m1/PERIOD(m1) | 

## 지표 수식: IOPS(%)
<a name="metric-math-iops-percent"></a>

특정 기간의 여러 I/O 유형(`DataReadIOBytes`, `DataWriteIOBytes`, `MetadataIOBytes`)의 초당 IOPS(%)를 계산하려면 먼저 샘플 수 통계에 100을 곱합니다. 그런 다음 같은 기간에 해당 값을 `TotalIOBytes`의 샘플 수 통계로 나눕니다.

예가 되는 로직이 '(`MetadataIOBytes` 샘플 수 x 100 (퍼센트로 변환)) ÷ `TotalIOBytes` 샘플 수'라고 가정하겠습니다.

이 경우, CloudWatch 지표 정보는 다음과 같습니다.


| ID | 사용 가능한 지표 | 통계 | Period | 
| --- | --- | --- | --- | 
| m1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 샘플 수 | 1분 | 
| m2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 샘플 수 | 1분 | 

지표 수식 ID와 표현식은 다음과 같습니다.


| ID | 표현식 | 
| --- | --- | 
| e1 | (m2\$1100)/m1 | 

## 지표 수식: 평균 I/O 크기(KiB)
<a name="metric-math-average-io"></a>

특정 기간에 대한 평균 I/O 크기(KiB)를 계산하려면 `DataReadIOBytes`, `DataWriteIOBytes`, `MetadataIOBytes` 지표의 합계 통계를 해당 지표의 샘플 수 통계로 나눕니다.

예가 되는 로직이 '(`DataReadIOBytes` 합계 ÷ 1024 (KiB로 변환)) ÷ `DataReadIOBytes` 샘플 수'라고 가정하겠습니다.

이 경우, CloudWatch 지표 정보는 다음과 같습니다.


| ID | 사용 가능한 지표 | 통계 | Period | 
| --- | --- | --- | --- | 
| m1 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 합계 | 1분 | 
| m2 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/efs/latest/ug/monitoring-metric-math.html)  | 샘플 수 | 1분 | 

지표 수식 ID와 표현식은 다음과 같습니다.


| ID | 표현식 | 
| --- | --- | 
| e1 | (m1/1024)/m2 | 

## Amazon EFS용 CloudFormation 템플릿을 통한 지표 수학 사용
<a name="metric-math-cloudformation-template"></a>

 CloudFormation 템플릿을 통해 지표 수학 표현식을 생성할 수도 있습니다. GitHub의 [Amazon EFS 자습서](https://github.com/aws-samples/amazon-efs-tutorial)에서 사용할 템플릿을 다운로드 받아 사용자 지정할 수 있습니다. CloudFormation 템플릿 사용에 대한 자세한 내용은 사용 설명서의 [CloudFormation 템플릿 작업을](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html) 참조하세요. *AWS CloudFormation * 

# 탑재 시도 성공 또는 실패 모니터링
<a name="how-to-monitor-mount-status"></a>

Amazon CloudWatch Logs를 사용하면 클라이언트에 로그인하지 않고도 EFS 파일 시스템에 대한 탑재 시도의 성공 또는 실패를 원격으로 모니터링하고 보고할 수 있습니다. 다음 절차를 사용하여 CloudWatch Logs를 사용하여 파일 시스템 탑재 시도의 성공 또는 실패를 모니터링하도록 EC2 인스턴스를 구성합니다.

**CloudWatch 로그에서 탑재 시도 성공 또는 실패 알림을 활성화하려면**

1. EC2 인스턴스에 `amazon-efs-utils`를 설치하여 파일 시스템을 탑재합니다. 자세한 내용은 [를 사용하여 Amazon EFS 클라이언트 자동 설치 또는 업데이트 AWS Systems Manager](manage-efs-utils-with-aws-sys-manager.md) 또는 [Amazon EFS 클라이언트 수동 설치](installing-amazon-efs-utils.md)을 참조하세요.

1. 파일 시스템을 탑재할 EC2 인스턴스에 `botocore` 설치합니다. 자세한 내용은 [`botocore` 설치 및 업그레이드](install-botocore.md) 단원을 참조하십시오.

1. `amazon-efs-utils`에서 CloudWatch Logs 기능을 활성화합니다. AWS Systems Manager 를 사용하여를 설치하고 구성하면 `amazon-efs-utils` CloudWatch 로깅이 자동으로 수행됩니다. `amazon-efs-utils` 패키지를 수동으로 설치하는 경우 `cloudwatch-log` 섹션에서 해당 `# enabled = true` 줄의 주석을 제거하여 `/etc/amazon/efs/efs-utils.conf` 구성 파일을 수동으로 업데이트해야 합니다. 다음 명령 중 하나를 사용하여 CloudWatch Logs를 수동으로 활성화합니다.

   Linux 인스턴스의 경우:

   ```
   sudo sed -i -e '/\[cloudwatch-log\]/{N;s/# enabled = true/enabled = true/}' /etc/amazon/efs/efs-utils.conf
   ```

   macOS 인스턴스의 경우:

   ```
   EFS_UTILS_VERSION= efs-utils-version
   sudo sed -i -e '/\[cloudwatch-log\]/{N;s/# enabled = true/enabled = true/;}' /usr/local/Cellar/amazon-efs-utils/${EFS_UTILS_VERSION}/libexec/etc/amazon/efs/efs-utils.conf
   ```

   Mac2 인스턴스의 경우:

   ```
   EFS_UTILS_VERSION= efs-utils-version
   sudo sed -i -e '/\[cloudwatch-log\]/{N;s/# enabled = true/enabled = true/;}' /opt/homebrew/Cellar/amazon-efs-utils/${EFS_UTILS_VERSION}/libexec/etc/amazon/efs/efs-utils.conf
   ```

1. 선택적으로 CloudWatch Logs 그룹 이름을 구성하고 `efs-utils.conf` 파일에 로그 보존 일수를 설정할 수 있습니다. CloudWatch에서 탑재된 각 파일 시스템에 대해 별도의 로그 그룹을 만들려면 다음과 같이 `efs-utils.conf` 파일의 `log_group_name` 필드 끝에 `/{fs_id}`를 추가하세요.

   ```
   [cloudwatch-log]
   log_group_name = /aws/efs/utils/{fs_id}
   ```

1. `AmazonElasticFileSystemsUtils` AWS 관리형 정책을 EC2 인스턴스에 연결한 IAM 역할 또는 인스턴스에 구성된 AWS 자격 증명에 연결합니다. Systems Manager를 사용하여 이를 수행할 수 있습니다. 자세한 내용은 [1단계: 필요한 권한으로 IAM 인스턴스 프로파일 구성](setting-up-aws-sys-mgr.md#configure-sys-mgr-iam-instance-profile) 섹션을 참조하세요.

다음은 탑재 시도 상태 로그 항목의 예입니다.

```
Successfully mounted fs-12345678.efs.us-east-1.amazonaws.com at /home/ec2-user/efs
Mount failed, Failed to resolve "fs-01234567.efs.us-east-1.amazonaws.com"
```

**CloudWatch Logs에서 탑재 상태를 보려면**

1. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.

1. 탐색 창에서 **로그 그룹**을 선택합니다.

1. **/aws/efs/utils** 로그 그룹을 선택합니다. 각 Amazon EC2 인스턴스 및 EFS 파일 시스템 조합에 대한 로그 스트림이 표시됩니다.

1. 로그 스트림을 선택하면 탑재 시도 성공 또는 실패 상태를 비롯한 특정 로그 이벤트를 볼 수 있습니다.

# Amazon EFS 모니터링을 위한 CloudWatch 경보 생성
<a name="creating_alarms"></a>

경보로 인해 상태가 변경되면 Amazon SNS 메시지를 보내는 CloudWatch 경보를 생성할 수 있습니다. 경보는 지정한 기간 동안 단일 지표를 감시합니다. 이 경보는 여러 기간에 대해 주어진 임계값과 지표 값을 비교하여 하나 이상의 작업을 수행합니다. 이 작업은 Amazon SNS 주제 또는 Auto Scaling 정책으로 전송되는 알림입니다.

경보는 지속적인 상태 변경에 대해서만 작업을 호출합니다. CloudWatch 경보는 특정 상태에 있다는 이유만으로는 작업을 호출하지 않습니다. 상태가 변경되고 지정한 기간 동안 유지되어야 합니다.

Amazon EFS에 CloudWatch 경보를 사용하는 중요한 용도 중 하나는 파일 시스템에 유휴 암호화를 적용하는 것입니다. 생성할 때 Amazon EFS 파일 시스템에 유휴 상태의 암호화를 활성화할 수 있습니다. Amazon EFS 파일 시스템에 유휴 데이터 암호화 정책을 적용하려면 Amazon CloudWatch 및 AWS CloudTrail 을 사용해 파일 시스템 생성을 감지하고, 유휴 암호화가 활성화되어 있는지 확인합니다.

**참고**  
현재는 전송 중 암호화를 적용할 수 없습니다.

다음 절차에서는 Amazon EFS에 대한 경보를 만드는 방법을 간략하게 설명합니다.

## 콘솔 사용
<a name="set-alarms-console"></a>

**CloudWatch 콘솔을 사용하여 경보를 설정하려면**

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) CloudWatch 콘솔을 엽니다.

1.  **경보 생성**을 선택합니다. 그러면 **Create Alarm Wizard**가 시작됩니다.

1. **EFS 지표**를 선택하고 Amazon EFS 지표를 스크롤하여 경보를 생성할 지표를 찾습니다. 이 대화 상자에서 Amazon EFS 지표를 표시하려면 파일 시스템의 파일 시스템 ID를 검색합니다. 경보를 생성할 지표를 선택하고 **다음**을 선택합니다.

1.  지표에 대한 **이름**, **설명**, **다음 경우 항상** 값을 입력합니다.

1. 경보 상태 도달 시 CloudWatch에서 이메일을 보내게 하려면, **이 경우 언제든 경보:** 필드에서 **경보 상태**를 선택합니다. **알림 보내기:** 필드에서 기존 SNS 주제를 선택합니다. **주제 생성**을 선택한 경우 새 이메일 구독 목록에 대한 명칭 및 이메일 주소를 설정할 수 있습니다. 이 목록은 향후 경보를 위해 필드에 저장되고 표시됩니다.
**참고**  
 새 Amazon SNS 주제를 생성하기 위해 **주제 생성**을 사용할 경우 이메일 주소는 알림을 받기 전에 검증되어야 합니다. 이메일은 경보가 경보 상태에 입력될 때만 전송됩니다. 이러한 경보 상태 변경이 이메일이 검증되기 전에 발생할 경우에는 알림을 받지 못합니다.

1.  이제 **경보 미리 보기** 영역에서 생성할 경보를 미리 볼 수 있습니다. **경보 생성**을 선택합니다.

## 사용 AWS CLI
<a name="set-alarms-cli"></a>

**를 사용하여 경보를 설정하려면 AWS CLI**
+ `[https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html](https://docs.aws.amazon.com/cli/latest/reference/cloudwatch/put-metric-alarm.html)`를 호출합니다. 자세한 내용은 [AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/)를 참조하세요.

## CloudWatch API 사용
<a name="set-alarms-api"></a>

**CloudWatch API를 사용하여 경보 설정**
+ `[https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html)`을 호출합니다. 자세한 내용은 [CloudWatch API 참조](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/)를 참조하세요.