기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Storage Gateway 모니터링
이 섹션의 주제에서는 게이트웨이와 관련된 리소스 모니터링하는 것을 포함하여 Amazon CloudWatch를 사용하여 게이트웨이를 모니터링하는 방법에 대해 설명합니다. Storage Gateway 콘솔을 사용하여 게이트웨이에 대한 지표와 경보를 볼 수 있습니다. 예를 들어 읽기 및 쓰기 작업에 사용된 바이트 수, 읽기 및 쓰기 작업에 소요된 시간, AWS 클라우드에서 데이터를 검색하는 데 걸린 시간을 볼 수 있습니다. 지표를 사용하여 게이트웨이의 상태를 추적하고 하나 이상의 지표가 정의한 임계값 범위를 벗어나는 경우 이를 알리도록 경보를 설정할 수 있습니다.
Storage Gateway는 추가 요금 없이 CloudWatch 지표를 제공합니다. Storage Gateway 지표는 2주 동안 기록됩니다. 이 지표를 사용하여 기록 정보에 액세스하고 게이트웨이가 어떻게 실행되고 있는지 더 잘 파악할 수 있습니다. 또한 Storage Gateway는 고해상도 경보를 제외한 CloudWatch 경보를 추가 비용 없이 제공합니다. CloudWatch 요금에 대한 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing/)을 참조하세요. CloudWatch에 대한 자세한 정보는 [Amazon CloudWatch 사용 설명서](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)를 참조하세요.
**주제**
+ [CloudWatch 경보 이해](cloudwatch-alarms.md) - 경보 상태 및 권장 구성을 포함하여 CloudWatch 경보에 대한 기본 정보를 알아봅니다.
+ [권장 CloudWatch 경보 생성](cloudwatch-alarms-create-recommended.md) - 초기 File Gateway 설정 프로세스의 일부로 모든 권장 CloudWatch 경보를 빠르게 자동으로 구성하는 방법을 알아봅니다.
+ [사용자 지정 CloudWatch 경보 생성](cloudwatch-alarms-create-alarm.md) - 특정 평가 기준을 사용하여 특정 지표를 모니터링하여 경보 상태를 트리거하고 알림을 전송하는 사용자 지정 CloudWatch 경보를 생성하는 방법을 알아봅니다.
+ [S3 File Gateway 모니터링](monitoring-file-gateway.md) - CloudWatch 로그 및 감사 로그를 보고 게이트웨이에서 보고하는 특정 게이트웨이 및 파일 공유파일 시스템 지표에 대한 정보를 찾는 방법을 알아봅니다.
# CloudWatch 경보 이해
CloudWatch 경보는 지표와 표현식을 기반으로 게이트웨이에 대한 정보를 모니터링합니다. Storage Gateway 콘솔에서 게이트웨이에 대한 CloudWatch 경보를 추가하고 상태를 확인할 수 있습니다. S3 File Gateway를 모니터링하는 데 사용되는 지표에 대한 자세한 내용은 [게이트웨이 지표 이해](https://docs.aws.amazon.com/filegateway/latest/files3/monitoring-file-gateway.html#understanding-file-gateway-metrics) 및 [파일 공유 지표 이해](https://docs.aws.amazon.com/filegateway/latest/files3/monitoring-file-gateway.html#monitoring-file-gateway-resources)를 참조하세요. 각 경보마다 ALARM 상태 활성화 조건을 지정합니다. ALARM 상태에서는 Storage Gateway 콘솔의 경보 상태 표시등이 빨간색으로 바뀌므로 상태를 사전 예방적으로 쉽게 모니터링할 수 있습니다. 지속적인 상태 변화에 따라 자동으로 작업을 호출하도록 경보를 구성할 수 있습니다. CloudWatch 경보에 대한 자세한 내용은 Amazon CloudWatch 사용 설명서에서 [Amazon CloudWatch 경보 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)을 참조하세요.**
**참고**
CloudWatch 보기 권한이 없으면 경보를 볼 수 없습니다.
활성화된 각 게이트웨이에 대해 다음과 같은 CloudWatch 경보를 생성하는 것이 좋습니다.
+ 높은 IO 대기: 15분 내에 3개의 데이터 포인트에 대해 `IoWaitpercent` >= 20
+ 캐시 더티 백분율: 20분 내에 4개의 데이터 포인트에 대해 `CachePercentDirty` > 80
+ 업로드에 실패한 파일: 5분 이내에 데이터 포인트 1개에 대해 `FilesFailingUpload` >= 1
+ 파일 공유 사용 불가: 5분 이내에 데이터 포인트 1개에 대해 `FileSharesUnavailable` >= 1
+ 상태 알림: 5분 이내에 1개의 데이터 포인트에 대해 `HealthNotifications` >= 1 이 경보를 구성할 때 **누락된 데이터 처리**를 **NotBreachin**g으로 설정합니다.
**참고**
CloudWatch에서 게이트웨이에 이전 상태 알림이 있는 경우에만 상태 알림 경보를 설정할 수 있습니다.
VMware 고가용성 클러스터의 일부인 VMware 호스트 플랫폼의 게이트웨이의 경우 이 추가 CloudWatch 경보도 사용하는 것이 좋습니다.
+ 가용성 알림: 5분 이내에 1개의 데이터 포인트에 대해 `AvailabilityNotifications` >= 1 이 경보를 구성할 때 **누락된 데이터 처리**를 **NotBreachin**g으로 설정합니다.
다음 표에서는 CloudWatch 경보 상태에 대해 설명합니다.
| State | 설명 |
| --- | --- |
| **정상** | 지표 또는 표현식이 정의된 임계값 내에 있습니다. |
| **경보** | 지표 또는 표현식이 정의된 임계값을 벗어났습니다. |
| **데이터 부족** | 경보가 방금 시작되었거나, 지표를 사용할 수 없거나, 지표를 통해 경보 상태를 결정하는 데 사용할 충분한 데이터가 없습니다. |
| **없음** | 게이트웨이에 대한 경보가 생성되지 않습니다. 새 경보를 생성하려면 [게이트웨이에 대한 사용자 지정 CloudWatch 경보 생성](cloudwatch-alarms-create-alarm.md) 섹션을 참조하세요. |
| **Unavailable** | 경보의 상태를 알 수 없습니다. **모니터링** 탭에서 오류 정보를 보려면 **사용할 수 없음**을 선택합니다. |
# 게이트웨이에 대한 권장 CloudWatch 경보 생성
Storage Gateway 콘솔을 사용하여 새 게이트웨이를 생성할 때 초기 설정 프로세스의 일부로 모든 권장 CloudWatch 경보를 자동으로 생성하도록 선택할 수 있습니다. 자세한 내용은 [Amazon S3 File Gateway 구성](https://docs.aws.amazon.com/filegateway/latest/files3/create-gateway-file.html#configure-gateway-s3-file)을 참조하세요. 첫 번째 설정을 완료한 후 기존 게이트웨이에 대해 권장 CloudWatch 경보를 추가하거나 업데이트하려면 다음 절차를 수행합니다.
**기존 게이트웨이에 대해 권장 CloudWatch 경보를 추가하거나 업데이트하려면**
**참고**
이 기능을 사용하려면 CloudWatch 정책 권한이 필요합니다. 이 권한은 사전 구성된 Storage Gateway 전체 액세스 정책의 일부로 자동 부여되지 않습니다.** 권장 CloudWatch 경보를 생성하기 전에 보안 정책이 다음 권한을 부여하는지 확인하세요.
`cloudwatch:PutMetricAlarm` - 경보 생성
`cloudwatch:DisableAlarmActions` - 경보 작업 끄기
`cloudwatch:EnableAlarmActions` - 경보 작업 켜기
`cloudwatch:DeleteAlarms` - 경보 삭제
1. Storage Gateway 콘솔([https://console.aws.amazon.com/storagegateway/home/](https://console.aws.amazon.com/storagegateway/home/))을 엽니다.
1. 페이지의 왼쪽에 있는 탐색 창에서 **게이트웨이**를 선택한 다음 권장 CloudWatch 경보를 생성할 게이트웨이를 선택합니다.
1. 게이트웨이 **세부 정보** 페이지에서 **모니터링** 탭을 선택합니다.
1. **경보**에서 **권장 경보 생성**을 선택합니다. 권장 경보는 자동으로 생성됩니다.
**경보** 섹션에 특정 게이트웨이에 대한 모든 CloudWatch 경보가 나열됩니다. 여기서 하나 이상의 경보를 선택 및 삭제하고, 경보 작업을 켜거나 끄고, 새 경보를 생성할 수 있습니다.
# 게이트웨이에 대한 사용자 지정 CloudWatch 경보 생성
CloudWatch는 경보 상태가 변경되면 Amazon Simple Notification Service(SNS)를 사용하여 경보 알림을 보냅니다. 경보는 지정한 기간 동안 단일 지표를 감시하고 여러 기간에 지정된 임계값에 대한 지표 값을 기준으로 작업을 하나 이상 수행합니다. 이 작업은 Amazon SNS 주제로 전송되는 알림입니다. CloudWatch 경보를 생성할 때 Amazon SNS 주제를 생성할 수 있습니다. Amazon SNS에 대한 자세한 내용은 *Amazon Simple Notification Service 개발자 설명서*의 [Amazon SNS란 무엇입니까?](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)를 참조하세요.
**Storage Gateway 콘솔에서 CloudWatch 경보를 생성하려면**
1. Storage Gateway 콘솔([https://console.aws.amazon.com/storagegateway/home/](https://console.aws.amazon.com/storagegateway/home/))을 엽니다.
1. 탐색 창에서 **게이트웨이**를 선택한 다음 경보를 생성할 게이트웨이를 선택합니다.
1. 게이트웨이 세부 정보 페이지에서 **모니터링** 탭을 선택합니다.
1. **경보**에서 **경보 생성**을 선택하여 CloudWatch 콘솔을 엽니다.
1. CloudWatch 콘솔을 사용하여 원하는 경보 유형을 생성합니다. 다음 유형의 경보를 생성할 수 있습니다.
+ 정적 임계값 경보: 선택한 지표에 대해 설정된 임계값을 기반으로 하는 경보입니다. 지표가 지정된 수의 평가 기간에 대한 임계값을 위반할 경우 경보가 ALARM 상태로 전환됩니다.
정적 임계값 경보를 생성하려면 Amazon CloudWatch 사용 설명서에서 [정적 임계값을 기반으로 CloudWatch 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)을 참조하세요.**
+ 이상 탐지 경보: 이상 탐지는 과거 지표 데이터를 마이닝하고 예상 값의 모델을 생성합니다. 이상 탐지 임곗값에 대한 값을 설정합니다. 그러면 CloudWatch는 모델과 함께 이 임곗값을 사용하여 지표 값의 ‘정상’ 범위를 결정합니다. 임곗값에 대한 값이 클수록 ‘정상’ 값의 밴드가 더 두꺼워집니다. 지표 값이 예상 값 범위보다 높을 때만 경보를 활성화하거나, 범위보다 낮을 때만 경보를 활성화하거나, 범위보다 높거나 낮을 때 경보를 활성화하도록 선택할 수 있습니다.
이상 탐지 경보를 생성하려면 Amazon CloudWatch 사용 설명서에서 [이상 탐지를 기반으로 CloudWatch 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html)을 참조하세요.**
+ 지표 수학 표현식 경보: 수학 표현식에 사용된 하나 이상의 지표에 기반한 경보입니다. 표현식, 임계값 및 평가 기간을 지정합니다.
지표 수학 표현식 경보를 생성하려면 Amazon CloudWatch 사용 설명서에서 [지표 수학 표현식을 기반으로 CloudWatch 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create-alarm-on-metric-math-expression.html)을 참조하세요.**
+ 복합 경보: 다른 경보의 경보 상태를 감시하여 경보 상태를 결정하는 경보입니다. 복합 경보를 사용하면 경보 노이즈를 줄이는 데 도움이 될 수 있습니다.
복합 경보를 생성하려면 Amazon CloudWatch 사용 설명서에서 [복합 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm.html)을 참조하세요.**
1. CloudWatch 콘솔에서 경보를 생성한 후 Storage Gateway 콘솔로 돌아갑니다. 다음 중 하나를 수행하여 경보를 볼 수 있습니다.
+ 탐색 창에서 **게이트웨이**를 선택한 다음 경보를 확인할 게이트웨이를 선택합니다. **세부 정보** 탭의 **경보**에서 **CloudWatch 경보**를 선택합니다.
+ 탐색 창에서 **게이트웨이**를 선택하고, 경보를 확인할 게이트웨이를 선택한 다음 **모니터링** 탭을 선택합니다.
**경보** 섹션에 특정 게이트웨이에 대한 모든 CloudWatch 경보가 나열됩니다. 여기서 하나 이상의 경보를 선택 및 삭제하고, 경보 작업을 켜거나 끄고, 새 경보를 생성할 수 있습니다.
+ 탐색 창에서 **게이트웨이**를 선택한 다음 경보를 확인할 게이트웨이의 경보 상태를 선택합니다.
경보를 편집하거나 삭제하는 방법에 대한 자세한 내용은 [CloudWatch 경보 편집 또는 삭제](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Edit-CloudWatch-Alarm.html)를 참조하세요.
**참고**
Storage Gateway 콘솔을 사용하여 게이트웨이를 삭제하면 게이트웨이와 관련된 CloudWatch 경보도 모두 자동으로 삭제됩니다.
# S3 File Gateway 모니터링
Amazon CloudWatch 지표 및 감사 로그 AWS Storage Gateway 를 사용하여에서 S3 File GatewayFSx 및 관련 리소스를 모니터링할 수 있습니다. CloudWatch Events를 사용하여 파일 작업이 완료되면 알림을 받을 수도 있습니다.
**Topics**
+ [
## CloudWatch 로그 그룹을 사용하여 S3 File Gateway 가져오기
](#cw-log-groups)
+ [
## Amazon CloudWatch 지표 사용
](#using-CloudWatch-metrics)
+ [
## 파일 작업에 대한 알림 받기
](#get-notification)
+ [
## 게이트웨이 지표 이해
](#understanding-file-gateway-metrics)
+ [
## 파일 공유 지표 이해
](#monitoring-file-gateway-resources)
+ [
## S3 File Gateway 감사 로그 이해
](#audit-logs)
## CloudWatch 로그 그룹을 사용하여 S3 File Gateway 가져오기
Amazon CloudWatch Logs를 사용하여 S3 File Gateway 및 관련 리소스 상태에 대한 정보를 가져올 수 있습니다. 로그를 사용하여 게이트웨이에 로그가 발생하는지 모니터링할 수 있습니다. 또한 Amazon CloudWatch 구독 필터를 사용하여 실시간으로 로그 정보 처리를 자동화할 수 있습니다. 자세한 내용은 Amazon CloudWatch 사용 설명서에서 [구독을 통한 로그 데이터 실시간 처리](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Subscriptions.html)를 참조하세요.**
예를 들어 게이트웨이를 모니터링하고, S3 File Gateway에서 Amazon S3 버킷에 파일을 업로드하는 데 실패하면 알림을 받도록 CloudWatch 로그 그룹을 구성할 수 있습니다. 게이트웨이를 활성화할 때나 게이트웨이가 활성화되어 실행된 후에 그룹을 구성할 수 있습니다. 게이트웨이를 활성화할 때 CloudWatch 로그 그룹을 구성하는 방법에 대한 자세한 내용은 [Amazon S3 File Gateway 구성](create-gateway-file.md#configure-gateway-s3-file) 섹션을 참조하세요. CloudWatch 로그 그룹에 대한 일반적인 정보는 *Amazon CloudWatch 사용 설명서*에서 [로그 그룹 및 로그 스트림 작업](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html)을 참조하세요.
다음은 S3 File Gateway에서 보고하는 오류의 예입니다.
```
{
"severity": "ERROR",
"bucket": "bucket-smb-share2",
"roleArn": "arn:aws:iam::123456789012:role/amzn-s3-demo-bucket",
"source": "share-E1A2B34C",
"type": "InaccessibleStorageClass",
"operation": "S3Upload",
"key": "myFolder/myFile.text",
"gateway": "sgw-B1D123D4",
"timestamp": "1565740862516"
}
```
이 오류는 S3 File Gateway가 Amazon S3 Standard 스토리지 클래스에서 S3 Glacier Flexible Retrieval 또는 S3 Glacier Deep Archive 스토리지 클래스로 전환되었으므로 `myFolder/myFile.text` 객체를 Amazon S3에 업로드할 수 없다는 의미입니다.
앞에 나온 게이트웨이 상태 로그에서는 다음 항목이 주어진 정보를 지정합니다.
+ `source: share-E1A2B34C` - 이 오류를 일으킨 파일 공유를 나타냅니다.
+ `"type": "InaccessibleStorageClass"` - 발생한 오류의 유형을 나타냅니다. 여기서는 게이트웨이가 지정된 객체를 Amazon S3에 업로드하거나 Amazon S3에서 읽으려고 할 때 이 오류가 발생했습니다. 하지만 이때 객체는 Amazon Glacier로 전환했습니다. `"type"`의 값은 S3 File Gateway가 일으키는 모든 오류일 수 있습니다. 가능한 오류 목록은 [문제 해결: File Gateway 문제](troubleshooting-file-gateway-issues.md) 섹션을 참조하세요.
+ `"operation": "S3Upload"`는 게이트웨이가 이 객체를 S3에 업로드하려고 할 때 이 오류가 발생했음을 나타냅니다.
+ `"key": "myFolder/myFile.text"` - 오류를 유발한 객체를 나타냅니다.
+ `gateway": "sgw-B1D123D4`는 이 오류를 일으킨 S3 File Gateway를 나타냅니다.
+ `"timestamp": "1565740862516"`은 오류가 발생한 시간을 나타냅니다.
S3 File Gateway에서 보고할 수 있는 오류를 해결하는 방법에 대한 자세한 내용은 [문제 해결: File Gateway 문제](troubleshooting-file-gateway-issues.md) 섹션을 참조하세요.
### 게이트웨이가 활성화된 후 CloudWatch 로그 그룹 구성
다음 절차에서는 게이트웨이가 활성화된 후 CloudWatch 로그 그룹을 구성하는 방법을 보여줍니다.
**S3 File Gateway와 함께 작동하도록 CloudWatch 로그 그룹을 구성하려면**
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/storagegateway/home](https://console.aws.amazon.com/storagegateway/) Storage Gateway 콘솔을 엽니다.
1. 탐색 창에서 **게이트웨이**를 선택한 후 CloudWatch 로그 그룹을 구성할 게이트웨이를 선택합니다.
1. **작업**에서 **게이트웨이 정보 편집**을 선택합니다.
1. **로그 그룹 설정 방법 선택**에서 다음 중 하나를 선택합니다.
+ 새 CloudWatch 로그 그룹을 생성하려면 **새 로그 그룹 생성**을 선택합니다.
+ 기존 CloudWatch 로그 그룹을 사용하려면 **기존 로그 그룹** 사용을 선택합니다.
**기존 로그 그룹 목록**에서 로그 그룹을 선택합니다.
+ CloudWatch 로그 그룹을 사용하여 게이트웨이를 모니터링하지 않으려면 **로깅을 비활성화**합니다.
1. **변경 사항 저장**을 선택합니다.
1. 게이트웨이의 상태 로그를 확인하려면 다음을 수행합니다.
1. 탐색 창에서 **게이트웨이**를 선택한 후 CloudWatch 로그 그룹을 구성한 게이트웨이를 선택합니다.
1. **세부 정보** 탭을 선택하고 **상태 로그**에서 **CloudWatch 로그**를 선택합니다. CloudWatch 콘솔에서 **로그 그룹 세부 정보** 페이지가 열립니다.
## Amazon CloudWatch 지표 사용
AWS Management Console 또는 CloudWatch API를 사용하여 S3 File GatewayFSx에 대한 모니터링 데이터를 가져올 수 있습니다. 콘솔에는 CloudWatch API의 원시 데이터를 기초로 하는 일련의 그래프가 표시됩니다. [AWS SDKs](https://aws.amazon.com/tools) 중 하나 또는 [Amazon CloudWatch API](https://aws.amazon.com/cloudwatch) 도구를 통해 CloudWatch API를 사용할 수도 있습니다. 필요에 따라 콘솔에 표시되거나 API에서 가져온 그래프를 사용하는 것이 더 나을 수 있습니다.
지표를 다룰 때 사용하는 방법에 관계 없이 다음 정보를 지정해야 합니다.
+ 작업할 지표 차원. *차원*은 지표를 고유하게 식별하는 데 도움이 되는 이름-값 페어입니다. Storage Gateway의 차원은 `GatewayId` 및 `GatewayName`입니다. CloudWatch 콘솔에서 `Gateway Metrics` 보기를 사용하여 게이트웨이별 차원을 쉽게 선택할 수 있습니다. 차원에 대한 자세한 내용은 Amazon CloudWatch 사용 설명서에서 [차원](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Dimension)을 참조하세요.**
+ `ReadBytes`와 같은 지표 이름.
다음 표에는 사용 가능한 Storage Gateway 지표 데이터의 유형이 요약되어 있습니다.
| Amazon CloudWatch 네임스페이스 | 차원 | 설명 |
| --- | --- | --- |
| AWS/StorageGateway | GatewayId, GatewayName | 이 차원은 게이트웨이의 여러 측면을 설명하는 지표 데이터를 필터링합니다. `GatewayId` 및 `GatewayName` 차원을 모두 지정하여 작업할 S3 File Gateway를 식별할 수 있습니다. 게이트웨이의 처리량 및 지연 시간 데이터는 게이트웨이의 모든 파일 공유를 기반으로 합니다. 자동으로 5분 기간 동안 데이터를 무료로 사용할 수 있습니다. |
게이트웨이 및 파일 지표 작업은 기타 서비스 지표 작업과 유사합니다. 가장 일반적인 지표 작업 중 몇 가지에 대한 설명은 다음에 나열된 CloudWatch 문서에서 확인할 수 있습니다.
+ [사용 가능한 지표 보기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/viewing_metrics_with_cloudwatch.html)
+ [지표에 대한 통계 가져오기](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/getting-metric-statistics.html)
+ [CloudWatch 경보 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)
## 파일 작업에 대한 알림 받기
Storage Gateway는 파일 작업이 완료되면 다음 CloudWatch Events를 시작할 수 있습니다.
+ 게이트웨이가 파일 공유에서 Amazon S3로 파일을 비동기 업로드하는 작업이 완료될 때 알림을 받을 수 있습니다. `NotificationPolicy` 파라미터를 사용하여 파일 업로드 알림을 요청합니다. 그러면 완료된 각 파일 업로드에 대한 알림이 Amazon S3로 전송됩니다. 자세한 내용은 [파일 업로드 알림 받기](#get-file-upload-notification) 단원을 참조하십시오.
+ 게이트웨이가 파일 공유에서 Amazon S3로 작업 파일 세트를 비동기 업로드하는 작업이 완료될 때 알림을 받을 수 있습니다. [NotifyWhenUploaded](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_NotifyWhenUploaded.html) API 작업을 사용하여 작업 파일 세트 업로드 알림을 요청할 수 있습니다. 그러면 작업 파일 세트의 모든 파일이 Amazon S3에 업로드되면 알림이 전송됩니다. 자세한 내용은 [작업 파일 세트 업로드 알림 받기](#get-working-file-set-upload-notification) 단원을 참조하십시오.
+ 게이트웨이가 S3 버킷에서 캐시 새로 고침을 완료하면 알림을 받을 수 있습니다. Storage Gateway 콘솔이나 API를 통해 [RefreshCache](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html) 작업을 호출할 경우, 작업 완료 시 알림을 받도록 구독합니다. 자세한 내용은 [캐시 새로 고침 알림 받기](#get-refresh-cache-notification) 단원을 참조하십시오.
요청한 파일 작업이 완료되면 Storage Gateway가 CloudWatch Events를 통해 알림을 전송합니다. Amazon SNS, Amazon SQS 또는 AWS Lambda 함수와 같은 이벤트 대상을 통해 알림을 보내도록 CloudWatch Events를 구성할 수 있습니다. 예를 들어 이메일 또는 문자 메시지 같은 알림을 Amazon SNS 소비자에게 전송하도록 Amazon SNS 대상을 구성할 수 있습니다. CloudWatch Events에 대한 자세한 내용은 [CloudWatch Events란 무엇입니까?](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html)를 참조하세요.
**CloudWatch Events 알림을 설정하려면**
1. Storage Gateway에서 요청한 이벤트가 발생할 때 간접 호출할 Amazon SNS 주제 또는 Lambda 함수와 같은 대상을 생성합니다.
1. CloudWatch Events 콘솔에서 Storage Gateway의 이벤트를 기반으로 대상을 호출하기 위한 규칙을 만듭니다.
1. 규칙에 따라 이벤트 유형에 대한 이벤트 패턴을 생성합니다. 이벤트가 이 규칙 패턴과 일치할 때 알림이 전송됩니다.
1. 대상을 선택하고 설정을 구성합니다.
다음 예제는 지정된 게이트웨이와 지정된 AWS 리전에서 지정된 이벤트 유형을 시작하는 규칙을 보여줍니다. 예를 들어 이벤트 유형으로 `Storage Gateway File Upload Event`를 지정할 수 있습니다.
```
{
"source":[
"aws.storagegateway"
],
"resources":[
"arn:aws:storagegateway:AWS Region:account-id
:gateway/gateway-id"
],
"detail-type":[
"Event type"
]
}
```
CloudWatch Events 규칙 사용 방법에 대한 자세한 내용은 *Amazon CloudWatch Events 사용 설명서*의 [이벤트에서 트리거되는 CloudWatch Events 규칙 생성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/Create-CloudWatch-Events-Rule.html)을 참조하세요.
### 파일 업로드 알림 받기
파일 업로드 알림은 다음과 같은 두 가지 사용 사례에서 사용할 수 있습니다.
+ 업로드된 파일의 클라우드 내 처리를 자동화하기 위해 `NotificationPolicy` 파라미터를 호출하고 알림 ID를 받을 수 있습니다. 파일이 업로드되면 발생하는 알림은 API가 반환한 것과 동일한 알림 ID를 갖습니다. 이 알림 ID를 매핑하여 업로드 중인 파일 목록을 추적할 경우, 동일한 ID의 이벤트가 생성될 때 AWS 에 업로드된 파일의 처리를 시작할 수 있습니다
+ 콘텐츠 배포 사용 사례의 경우 동일한 Amazon S3 버킷에 매핑되는 S3 File Gateway 두 개가 있을 수 있습니다. Gateway1용 파일 공유 클라이언트는 Amazon S3에 새 파일을 업로드할 수 있으며, Gateway2의 파일 공유 클라이언트는 이 파일을 읽습니다. 이 파일은 Amazon S3에 업로드되지만, Gateway2에서는 Amazon S3에서 로컬로 캐시된 버전의 파일을 사용하므로 새 파일이 표시되지 않습니다. Gateway2에 파일을 표시하려면 `NotificationPolicy` 파라미터를 사용하여 업로드가 완료될 때 알리도록 Gateway1의 파일 업로드 알림을 요청할 수 있습니다. 그런 다음 CloudWatch Events를 사용하여 Gateway2의 파일 공유에 대한 [RefreshCache](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html) 요청을 자동으로 발행할 수 있습니다. [RefreshCache](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html) 요청이 완료되면 새 파일이 Gateway2에 표시됩니다.
**Example 예제 - 파일 업로드 알림**
다음 예제는 사용자가 생성한 규칙과 이벤트가 일치할 때 CloudWatch를 통해 사용자에게 전송되는 파일 업로드 알림을 보여 줍니다. 이 알림은 JSON 형식입니다. 이 알림을 텍스트 메시지로 대상에게 전달되도록 구성할 수 있습니다. `detail-type`은 `Storage Gateway Object Upload Event`입니다.
```
{
"version": "0",
"id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
"detail-type": "Storage Gateway Object Upload Event",
"source": "aws.storagegateway",
"account": "123456789012",
"time": "2020-11-05T12:34:56Z",
"region": "us-east-1",
"resources": [
"arn:aws:storagegateway:us-east-1:123456789011:share/share-F123D451",
"arn:aws:storagegateway:us-east-1:123456789011:gateway/sgw-712345DA",
"arn:aws:s3:::do-not-delete-bucket"
],
"detail": {
"object-size": 1024,
"modification-time": "2020-01-05T12:30:00Z",
"object-key": "my-file.txt",
"event-type": "object-upload-complete",
"prefix": "prefix/",
"bucket-name": "amzn-s3-demo-bucket",
}
}
```
| 필드 이름 | 설명 |
| --- | --- |
| 버전 | IAM 정책의 현재 버전입니다. |
| id | IAM 정책을 식별하는 ID입니다. |
| detail-type | 전송된 알림을 시작한 이벤트 유형에 대한 설명입니다. |
| source | 요청 및 알림의 소스인 AWS 서비스입니다. |
| 계정 | 요청 및 알림이 생성된 AWS 계정의 ID입니다. |
| 시간 | Amazon S3에 파일을 업로드하는 요청이 이루어진 시간입니다. |
| 리전 | 요청 및 알림이 전송된 AWS 리전입니다. |
| 리소스 | 정책이 적용된 Storage Gateway 리소스입니다. |
| 객체 크기 | 객체의 크기(바이트)입니다. |
| 수정 시간 | 클라이언트가 파일을 수정한 시간입니다. |
| 객체 키 | 파일 경로입니다. |
| event-type | 알림을 시작한 CloudWatch Events입니다. |
| prefix | S3 버킷의 접두사 이름. |
| bucket-name | S3 버킷의 이름. |
### 작업 파일 세트 업로드 알림 받기
작업 파일 세트 업로드 알림은 다음과 같은 두 가지 사용 사례에서 사용할 수 있습니다.
+ 업로드된 파일의 클라우드 내 처리를 자동화하기 위해 `NotifyWhenUploaded` API를 호출하고 알림 ID를 받을 수 있습니다. 작업 파일 세트가 업로드되면 발생하는 알림은 API가 반환한 것과 동일한 알림 ID를 갖습니다. 이 알림 ID를 매핑하여 업로드 중인 파일 목록을 추적하는 경우 ID가 동일한 이벤트가 생성될 AWS 때에 업로드되는 작업 파일 세트의 처리를 시작할 수 있습니다.
+ 콘텐츠 배포 사용 사례의 경우 동일한 Amazon S3 버킷에 매핑되는 S3 File Gateway 두 개가 있을 수 있습니다. Gateway1용 파일 공유 클라이언트는 Amazon S3에 새 파일을 업로드할 수 있으며, Gateway2의 파일 공유 클라이언트는 이 파일을 읽습니다. 이 파일은 Amazon S3에 업로드되지만, Gateway2에서는 S3에서 로컬로 캐시된 버전의 파일을 사용하므로 새 파일이 표시되지 않습니다. Gateway2에 파일을 표시하려면 [NotifyWhenUploaded](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_NotifyWhenUploaded.html) API 작업을 사용하여 작업 파일 세트 업로드가 완료될 때 알리도록 Gateway1의 파일 업로드 알림을 요청할 수 있습니다. 그런 다음 CloudWatch Events를 사용하여 Gateway2의 파일 공유에 대한 [RefreshCache](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html) 요청을 자동으로 발행할 수 있습니다. [RefreshCache](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_RefreshCache.html) 요청이 완료되면 새 파일이 Gateway2에 표시됩니다. 이 작업은 파일을 게이트웨이 캐시 스토리지로 가져오지 않습니다. S3 버킷의 객체 인벤토리 변경 사항을 반영하도록 캐시된 인벤토리만 업데이트합니다.
**Example 예 - 작업 파일 세트 업로드 알림**
다음 예제는 사용자가 생성한 규칙과 이벤트가 일치할 때 CloudWatch를 통해 사용자에게 전송되는 작업 파일 세트 업로드 알림을 보여 줍니다. 이 알림은 JSON 형식입니다. 이 알림을 텍스트 메시지로 대상에게 전달되도록 구성할 수 있습니다. `detail-type`은 `Storage Gateway File Upload Event`입니다.
```
{
"version": "2012-10-17",
"id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
"detail-type": "Storage Gateway File Upload Event",
"source": "aws.storagegateway",
"account": "123456789012",
"time": "2017-11-06T21:34:42Z",
"region": "us-east-2",
"resources": [
"arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
"arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
],
"detail": {
"event-type": "upload-complete",
"notification-id": "11b3106b-a18a-4890-9d47-a1a755ef5e47",
"request-received": "2018-02-06T21:34:42Z",
"completed": "2018-02-06T21:34:53Z"
}
}
```
| 필드 이름 | 설명 |
| --- | --- |
| 버전 | IAM 정책의 현재 버전입니다. |
| id | IAM 정책을 식별하는 ID입니다. |
| detail-type | 전송된 알림을 시작한 이벤트 유형에 대한 설명입니다. |
| source | 요청 및 알림의 소스인 AWS 서비스입니다. |
| 계정 | 요청 및 알림이 생성된 AWS 계정의 ID입니다. |
| 시간 | Amazon S3에 파일을 업로드하는 요청이 이루어진 시간입니다. |
| 리전 | 요청 및 알림이 전송된 AWS 리전입니다. |
| 리소스 | 정책이 적용된 Storage Gateway 리소스입니다. |
| event-type | 알림을 시작한 CloudWatch Events입니다. |
| notification-id | 전송된 알림의 무작위 생성 ID입니다. 이 ID는 UUID 형식입니다. `NotifyWhenUploaded` 호출 시 반환된 알림 ID입니다. |
| request-received | 게이트웨이가 `NotifyWhenUploaded` 요청을 받은 시간입니다. |
| completed | 작업 세트의 모든 파일이 Amazon S3에 업로드된 시간입니다. |
### 캐시 새로 고침 알림 받기
캐시 새로 고침 알림 사용 사례의 경우 두 개의 S3 File Gateway를 동일한 Amazon S3 버킷에 매핑할 수 있으며, Gateway1용 NFS 클라이언트는 새 파일을 S3 버킷에 업로드합니다. 파일은 Amazon S3에 업로드되지만, 캐시를 새로 고칠 때까지 Gateway2에 나타나지 않습니다. 왜냐하면 Gateway2가 Amazon S3에서 로컬에 캐시된 버전의 파일을 사용하기 때문입니다. 캐시 새로 고침이 완료될 때 Gateway2에서 파일을 처리하고 싶을 수 있습니다. 대용량 파일은 Gateway2에 표시되는 데 시간이 걸릴 수 있으므로 캐시 새로 고침이 완료될 때 알림을 받고 싶을 수 있습니다. 모든 파일이 Gateway2에서 표시될 때 이를 알려주도록 Gateway2에서 캐시 새로 고침 알림을 요청할 수 있습니다.
**Example 예제 - 캐시 새로 고침 알림**
다음 예제에서는 사용자가 생성한 규칙과 이벤트가 일치할 때 CloudWatch를 통해 사용자에게 전송되는 캐시 새로 고침 알림을 보여줍니다. 이 알림은 JSON 형식입니다. 이 알림을 텍스트 메시지로 대상에게 전달되도록 구성할 수 있습니다. `detail-type`은 `Storage Gateway Refresh Cache Event`입니다.
```
{
"version": "2012-10-17",
"id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
"detail-type": "Storage Gateway Refresh Cache Event",
"source": "aws.storagegateway",
"account": "209870788375",
"time": "2017-11-06T21:34:42Z",
"region": "us-east-2",
"resources": [
"arn:aws:storagegateway:us-east-2:123456789011:share/share-F123D451",
"arn:aws:storagegateway:us-east-2:123456789011:gateway/sgw-712345DA"
],
"detail": {
"event-type": "refresh-complete",
"notification-id": "1c14106b-a18a-4890-9d47-a1a755ef5e47",
"started": "2018-02-06T21:34:42Z",
"completed": "2018-02-06T21:34:53Z",
"folderList": [
"/"
]
}
}
```
| 필드 이름 | 설명 |
| --- | --- |
| 버전 | IAM 정책의 현재 버전입니다. |
| id | IAM 정책을 식별하는 ID입니다. |
| detail-type | 전송된 알림을 시작한 이벤트 유형에 대한 설명입니다. |
| source | 요청 및 알림의 소스인 AWS 서비스입니다. |
| 계정 | 요청 및 알림이 생성된 AWS 계정의 ID입니다. |
| 시간 | 작업 세트에서 파일 새로 고침 요청이 이루어진 시간입니다. |
| 리전 | 요청 및 알림이 전송된 AWS 리전입니다. |
| 리소스 | 정책이 적용된 Storage Gateway 리소스입니다. |
| event-type | 알림을 시작한 CloudWatch Events입니다. |
| notification-id | 전송된 알림의 무작위 생성 ID입니다. 이 ID는 UUID 형식입니다. `RefreshCache` 호출 시 반환된 알림 ID입니다. |
| 하기 | 게이트웨이가 `RefreshCache` 요청을 받고 새로 고침이 시작된 시간입니다. |
| completed | 작업 세트의 새로 고침이 완료된 시간입니다. |
| folderList | 캐시에서 새로 고친 폴더 경로의 목록(쉼표 구분)입니다. 기본값은 ["/"]입니다. |
## 게이트웨이 지표 이해
다음 표에서는 S3 File Gateway를 포함하는 지표를 설명합니다. 각 게이트웨이에는 연관된 지표 집합이 있습니다. 일부 게이트웨이별 지표는 특정 파일 공유별 지표와 이름이 같습니다. 이러한 지표는 동일한 종류의 측정값을 나타내지만, 파일 공유가 아닌 게이트웨이로 범위가 한정됩니다.
특정 지표 관련 작업을 할 경우 항상 게이트웨이와 파일 공유 중 어느 것과 관련된 작업을 할 것인지 지정해야 합니다. 특히 게이트웨이 지표로 작업할 때는 지표 데이터를 보려는 게이트웨이에 대한 `Gateway Name`을 지정해야 합니다. 자세한 내용은 [Amazon CloudWatch 지표 사용](#using-CloudWatch-metrics) 단원을 참조하십시오.
**참고**
일부 지표는 가장 최근 모니터링 기간 동안 새 데이터가 생성된 경우에만 데이터 포인트를 반환합니다.
다음 표에서는 S3 File Gateway에 대한 정보를 얻는 데 사용할 수 있는 지표에 대해 설명합니다.
| 지표 | 설명 |
| --- | --- |
| AuditNotifications | 이 지표는 내보낸 감사 로그 수를 보고합니다. 단위: 개 |
| AvailabilityNotifications | 이 지표는 보고 기간 동안 게이트웨이에서 생성된 가용성 관련 상태 알림 수를 보고합니다. 단위: 개 |
| CacheFileSize | 이 지표는 게이트웨이 캐시의 파일 크기를 추적합니다. 이 지표를 `Average` 통계와 함께 사용하여 게이트웨이 캐시에 있는 파일의 평균 크기를 측정합니다. 이 지표를 `Max` 통계와 함께 사용하여 게이트웨이 캐시에 있는 파일의 최대 크기를 측정합니다. 단위: 바이트 |
| CacheFree | 이 지표는 게이트웨이 캐시에서 사용 가능한 바이트 수를 보고합니다. 단위: 바이트 |
| CacheHitPercent | 캐시로부터 읽는 게이트웨이의 애플리케이션 읽기 작업 백분율입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다. 게이트웨이로부터의 애플리케이션 읽기 작업이 없는 경우, 지표가 100%를 보고합니다. 단위: 백분율 |
| CachePercentDirty | 지속되지 않은 게이트웨이 캐시의 전체 백분율입니다 AWS. 보고 기간 종료 시점에서 샘플이 채취됩니다. `Sum` 통계와 함께 이 지표를 사용합니다. 이상적으로는 이 지표가 낮게 유지되어야 합니다. 단위: 백분율 |
| CachePercentUsed | 전체 게이트웨이에서 사용되는 데이터 캐시의 백분율입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다. 단위: 백분율 |
| CacheUsed | 이 지표는 게이트웨이 캐시에서 사용된 바이트 수를 보고합니다. 단위: 바이트 |
| CloudBytesDownloaded | 보고 기간 AWS 동안 게이트웨이가에서 다운로드한 총 바이트 수입니다. 이 지표를 `Sum` 통계와 함께 사용하면 처리량을 측정할 수 있으며 `Samples` 통계와 함께 사용하면 IOPS를 측정할 수 있습니다. 단위: 바이트 |
| CloudBytesUploaded | 보고 기간 AWS 동안 게이트웨이가에 업로드한 총 바이트 수입니다. 이 지표를 `Sum` 통계와 함께 사용하면 처리량을 측정할 수 있으며 `Samples` 통계와 함께 사용하면 초당 입력/출력 작업 수(IOPS)를 측정할 수 있습니다. 단위: 바이트 |
| FilesFailingUpload | 이 지표는 AWS에 업로드하지 못한 파일 수를 추적합니다. 이러한 파일은 문제에 대한 자세한 정보가 포함된 상태 알림을 생성합니다. 이 지표를 통계와 함께 사용하여 현재 `Sum`에 업로드하지 못한 파일 수를 표시합니다 AWS. 단위: 개 |
| FileSharesUnavailable | 이 지표는 **사용할 수 없음** 상태인 이 게이트웨이의 파일 공유 수를 제공합니다. 이 지표가 파일 공유를 사용할 수 없다고 보고하는 경우 게이트웨이에 문제가 발생하여 워크플로가 중단될 수 있습니다. 이 지표가 0이 아닌 값을 보고할 때에 대한 경보를 생성하는 것이 좋습니다. 단위: 개 |
| FilesRenamed | 이 지표는 보고 기간에 이름이 변경된 파일 수를 추적합니다. 단위: 개 |
| HealthNotifications | 이 지표는 보고 기간 동안 이 게이트웨이에서 생성된 상태 알림 수를 보고합니다. 단위: 개 |
| IndexEvictions | 이 지표는 새 항목을 위한 공간을 만들기 위해 파일 메타데이터의 캐시된 인덱스에서 메타데이터가 제거된 파일 수를 보고합니다. 게이트웨이는이 메타데이터 인덱스를 유지 관리합니다.이 메타데이터 인덱스는 온디맨드 AWS 클라우드에서 채워집니다. 단위: 개 |
| IndexFetches | 이 지표는 메타데이터를 가져온 파일의 수를 보고합니다. 게이트웨이는 요청 시 AWS 클라우드에서 채워지는 파일 메타데이터의 캐시된 인덱스를 유지합니다. 단위: 개 |
| IoWaitPercent | 이 지표는 CPU가 로컬 디스크의 응답을 기다리는 시간의 비율을 보고합니다. 단위: 백분율 |
| MemTotalBytes | 이 지표는 게이트웨이의 총 메모리 양을 보고합니다. 단위: 바이트 |
| MemUsedBytes | 이 지표는 게이트웨이에서 사용된 메모리의 양을 보고합니다. 단위: 바이트 |
| NfsSessions | 이 지표는 게이트웨이에서 활성 상태인 NFS 세션 수를 보고합니다. 단위: 개 |
| RootDiskFreeBytes | 이 지표는 게이트웨이의 루트 디스크에서 사용 가능한 바이트 수를 보고합니다. 이 지표가 20GB 미만이 무료라고 보고하는 경우 루트 디스크의 크기를 늘려야 합니다. 루트 디스크 크기를 늘리려면 VM의 기존 루트 디스크 크기를 늘리면 됩니다. VM이 재부팅되면 게이트웨이는 루트 디스크의 증가된 크기를 인식합니다. 단위: 바이트 |
| S3GetObjectRequestTime | 이 지표는 게이트웨이가 S3 객체 가져오기 요청을 완료하는 시간을 보고합니다. 단위: 밀리초 |
| S3PutObjectRequestTime | 이 지표는 게이트웨이가 S3 객체 배치 요청을 완료하는 시간을 보고합니다. 단위: 밀리초 |
| S3UploadPartRequestTime | 이 지표는 게이트웨이가 S3 파트 업로드 요청을 완료하는 시간을 보고합니다. 단위: 밀리초 |
| SmbV1Sessions | 이 지표는 게이트웨이에서 활성 상태인 SMBv1 세션 수를 보고합니다. 단위: 개 |
| SmbV2Sessions | 이 지표는 게이트웨이에서 활성 상태인 SMBv2 세션 수를 보고합니다. 단위: 개 |
| SmbV3Sessions | 이 지표는 게이트웨이에서 활성 상태인 SMBv3 세션 수를 보고합니다. 단위: 개 |
| TotalCacheSize | 이 지표는 캐시의 총 크기를 보고합니다. 단위: 바이트 |
| UserCpuPercent | 이 지표는 게이트웨이 처리에 소요된 시간의 비율을 보고합니다. 단위: 백분율 |
## 파일 공유 지표 이해
파일 공유를 나타내는 Storage Gateway 지표에 대해 다음과 같은 정보를 확인할 수 있습니다. 각 파일 공유에는 연결된 지표 집합이 있습니다. 일부 파일 공유별 지표는 특정 게이트웨이별 지표와 이름이 같습니다. 이러한 지표는 동일한 종류의 측정값을 나타내지만, 그 대신 파일 공유로 범위가 한정됩니다.
지표 관련 작업을 하려면 항상 먼저 게이트웨이와 파일 공유 중 어느 것과 관련된 작업을 할 것인지 지정해야 합니다. 특히 파일 공유 지표 작업을 할 때는 지표를 보고 싶은 파일 공유를 식별하는 `File share ID`를 지정해야 합니다. 자세한 내용은 [Amazon CloudWatch 지표 사용](#using-CloudWatch-metrics) 단원을 참조하십시오.
**참고**
일부 지표는 가장 최근 모니터링 기간 동안 새 데이터가 생성된 경우에만 데이터 포인트를 반환합니다.
다음 표에서는 파일 공유에 대한 정보를 얻는 데 사용할 수 있는 Storage Gateway 측정치에 대해 설명합니다.
| 지표 | 설명 |
| --- | --- |
| CacheHitPercent | 캐시로부터 읽는 파일 공유의 애플리케이션 읽기 작업 백분율입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다. 파일 공유로부터의 애플리케이션 읽기 작업이 없는 경우, 지표가 100%를 보고합니다. 단위: 백분율 |
| CachePercentDirty | AWS에 지속되지 않은 게이트웨이 캐시의 전체 백분율 중 파일 공유가 차지하는 비중입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다. `Sum` 통계와 함께 이 지표를 사용합니다. 이상적으로는 이 지표가 낮게 유지되어야 합니다. 게이트웨이의 `CachePercentDirty` 지표를 사용하면 AWS에 지속되지 않은 게이트웨이 캐시의 전체 백분율을 알 수 있습니다. 단위: 백분율 |
| CachePercentUsed | 전체 게이트웨이에서 사용되는 데이터 캐시의 백분율입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다. 이 파일 공유별 지표는 해당 게이트웨이별 지표와 동일한 값을 보고합니다. 단위: 백분율 |
| CloudBytesUploaded | 보고 기간 AWS 동안 게이트웨이가에 업로드한 총 바이트 수입니다. 이 지표를 `Sum` 통계와 함께 사용하면 처리량을 측정할 수 있으며 `Samples` 통계와 함께 사용하면 IOPS를 측정할 수 있습니다. 단위: 바이트 |
| CloudBytesDownloaded | 보고 기간 AWS 동안 게이트웨이가에서 다운로드한 총 바이트 수입니다. 이 지표를 `Sum` 통계와 함께 사용하면 처리량을 측정할 수 있으며 `Samples` 통계와 함께 사용하면 초당 입력/출력 작업 수(IOPS)를 측정할 수 있습니다. 단위: 바이트 |
| FilesFailingUpload | 이 지표는 AWS에 업로드하지 못한 파일 수를 추적합니다. 이러한 파일은 문제에 대한 자세한 정보가 포함된 상태 알림을 생성합니다. 이 지표를 통계와 함께 사용하여 현재 `Sum`에 업로드하지 못한 파일 수를 표시합니다 AWS. 단위: 개 |
| ReadBytes | 파일 공유에 대한 보고 기간 동안 온프레미스 애플리케이션으로부터 읽은 총 바이트 수입니다. 이 지표를 `Sum` 통계와 함께 사용하면 처리량을 측정할 수 있으며 `Samples` 통계와 함께 사용하면 IOPS를 측정할 수 있습니다. 단위: 바이트 |
| WriteBytes | 보고 기간 동안 온프레미스 애플리케이션에 작성한 총 바이트 수입니다. 이 지표를 `Sum` 통계와 함께 사용하면 처리량을 측정할 수 있으며 `Samples` 통계와 함께 사용하면 IOPS를 측정할 수 있습니다. 단위: 바이트 |
## S3 File Gateway 감사 로그 이해
Amazon S3 File Gateway(S3 File Gateway) 감사 로그는 파일 공유 내의 파일과 폴더의 사용자 액세스에 대한 세부 정보를 제공합니다. 이러한 정보를 사용하여 사용자 활동을 모니터링하고 부적절한 활동 패턴이 식별되면 조치를 취할 수 있습니다.
**운영**
다음 표에서는 S3 File Gateway 감사 로그 파일 액세스 작업에 대해 설명합니다.
| 작업 이름 | 정의 |
| --- | --- |
| 데이터 읽기 | 파일의 내용을 읽습니다. |
| 데이터 쓰기 | 파일의 내용을 변경합니다. |
| 생성 | 새 파일 또는 폴더를 만듭니다. |
| 이름 바꾸기 | 기존 파일 또는 폴더의 이름을 바꿉니다. |
| Delete | 파일 또는 폴더를 삭제합니다. |
| 속성 쓰기 | 파일 또는 폴더 메타데이터(ACL, 소유자, 그룹, 권한)를 업데이트합니다. |
**속성**
다음 표에서는 S3 File Gateway 감사 로그 파일 액세스 속성에 대해 설명합니다.
| 속성 | 정의 |
| --- | --- |
| accessMode | 객체에 대한 권한 설정입니다. |
| accountDomain (SMB만 해당) | 클라이언트의 계정이 속한 AD(Active Directory) 도메인입니다. |
| accountName (SMB만 해당) | 클라이언트의 Active Directory 사용자 이름입니다. |
| bucket | S3 버킷 이름입니다. |
| clientGid (NFS만 해당) | 객체에 액세스하는 사용자 그룹의 식별자입니다. |
| clientUid (NFS만 해당) | 객체에 액세스하는 사용자의 식별자입니다. |
| ctime | 클라이언트에서 설정한 객체의 콘텐츠나 메타데이터가 수정된 시간입니다. |
| groupId | 객체의 소유자에 대한 식별자입니다. |
| fileSizeInBytes | 파일 생성 시 클라이언트에서 설정한 파일 크기(바이트)입니다. |
| gateway | 스토리지 게이트웨이 ID입니다. |
| mtime | 클라이언트에서 설정한 객체의 콘텐츠가 수정된 시간입니다. |
| newObjectName | 이름이 바뀐 후 새 객체의 전체 경로입니다. |
| objectName | 객체의 전체 경로입니다. |
| objectType | 객체가 파일 또는 폴더인지를 정의합니다. |
| operation | 객체 액세스 작업의 이름입니다. |
| ownerId | 객체의 소유자에 대한 식별자입니다. |
| securityDescriptor (SMB만 해당) | 객체에 설정된 DACL(임의 액세스 제어 목록)을 SDDL 형식으로 표시합니다. |
| shareName | 액세스 중인 공유의 이름입니다. |
| source | 감사할 파일 공유의 ID입니다. |
| sourceAddress | 파일 공유 클라이언트 머신의 IP 주소입니다. |
| status | 작업의 상태. 성공만 기록됩니다(권한 거부로 인해 발생한 실패를 제외하고 실패가 기록됩니다). |
| timestamp | 게이트웨이의 OS 타임스탬프를 기준으로 작업이 발생한 시간입니다. |
| version | 감사 로그 형식의 버전입니다. |
**작업당 로깅된 속성**
다음 표에서는 각 파일 액세스 작업에서 기록된 S3 File Gateway 감사 로그 속성에 대해 설명합니다.
| | 데이터 읽기 | 데이터 쓰기 | 폴더 생성 | 파일 만들기 | 파일/폴더 이름 바꾸기 | 파일/폴더 삭제 | 쓰기 속성(ACL 변경 - **SMB만 해당**) | 쓰기 속성(chown) | 쓰기 속성(chmod) | 쓰기 속성(chgrp) |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| accessMode | | | X | X | | | | | X | |
| accountDomain (SMB만 해당) | X | X | X | X | X | X | X | X | X | X |
| accountName (SMB만 해당) | X | X | X | X | X | X | X | X | X | X |
| bucket | X | X | X | X | X | X | X | X | X | X |
| clientGid (NFS만 해당) | X | X | X | X | X | X | | X | X | X |
| clientUid (NFS만 해당) | X | X | X | X | X | X | | X | X | X |
| ctime | | | X | X | | | | | | |
| groupId | | | X | X | | | | | | |
| fileSizeInBytes | | | | X | | | | | | |
| gateway | X | X | X | X | X | X | X | X | X | X |
| mtime | | | X | X | | | | | | |
| newObjectName | | | | | X | | | | | |
| objectName | X | X | X | X | X | X | X | X | X | X |
| objectType | X | X | X | X | X | X | X | X | X | X |
| operation | X | X | X | X | X | X | X | X | X | X |
| ownerId | | | X | X | | | | X | | |
| securityDescriptor (SMB만 해당) | | | | | | | X | X | | |
| shareName | X | X | X | X | X | X | X | X | X | X |
| source | X | X | X | X | X | X | X | X | X | X |
| sourceAddress | X | X | X | X | X | X | X | X | X | X |
| status | X | X | X | X | X | X | X | X | X | X |
| timestamp | X | X | X | X | X | X | X | X | X | X |
| version | X | X | X | X | X | X | X | X | X | X |
# S3 File Gateway에 대한 캐시 보고서 생성
이제 S3 File Gateway는 현재 특정 파일 공유의 로컬 업로드 캐시에 있는 파일에 대한 메타데이터 보고서를 생성할 수 있습니다. 보고서에 표시되는 캐시된 파일의 특정 유형을 결정하는 필터와 추가 기준을 적용할 수 있습니다. 이 보고서를 사용하여 게이트웨이 문제를 식별하고 해결할 수 있습니다. 예를 들어 게이트웨이에서 Amazon S3로 업로드하는 데 실패한 파일이 있는 경우 업로드에 실패한 특정 파일과 업로드 실패 이유를 나열하는 보고서를 생성할 수 있습니다. 보고서는 지정한 필터 파라미터 세트와 일치하는 파일 목록이 포함된 CSV 파일입니다. 출력 파일은 보고서를 구성할 때 지정한 버킷 위치에 Amazon S3 객체로 저장됩니다. AWS Storage Gateway API를 사용하여 캐시 보고서를 생성하려면 *Storage Gateway API 참조*의 [StartCacheReport](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_StartCacheReport.html)를 참조하세요. Storage Gateway 콘솔에서 캐시 보고서를 생성하려면 다음 절차를 사용합니다.
**사전 조건**
+ 캐시 보고서를 저장할 Amazon S3 버킷에 대한 `s3:PutObject` 및 `s3:AbortMultipartUpload` 권한이 게이트웨이에 있어야 합니다.
+ 현재 파일 공유에 대해 진행 중인 다른 캐시 보고서가 없어야 합니다.
+ 파일 공유에 대한 기존 캐시 보고서가 10개 미만이어야 합니다.
+ 게이트웨이는 온라인 상태여야 하며에 연결되어 있어야 합니다 AWS.
+ 게이트웨이 루트 디스크에 최소 20GB의 여유 공간이 있어야 합니다.
**Storage Gateway 콘솔을 사용하여 캐시 보고서를 생성하려면**
1. Storage Gateway 콘솔([https://console.aws.amazon.com/storagegateway/home/](https://console.aws.amazon.com/storagegateway/home/))을 엽니다.
1. 페이지 왼쪽의 탐색 창에서 **파일 공유**를 선택한 다음 캐시 보고서를 생성할 파일 공유를 선택합니다.
1. **작업** 드롭다운 메뉴에서 **캐시 보고서 생성**을 선택합니다.
1. **Amazon S3 위치**에 Amazon S3 버킷과 완료된 캐시 보고서 CSV 파일 객체를 Amazon S3에 저장할 위치의 접두사를 입력합니다. 기존 Amazon S3 스토리지에서 버킷과 접두사를 선택하려면 **S3 찾아보**기를 선택합니다.
1. **IAM 역할**의 경우 다음 중 하나를 수행하여 캐시 보고서를 생성하고 저장할 수 있는 권한을 File Gateway에 부여하는 IAM 역할을 지정합니다.
+ 기존 IAM 역할을 지정하려면 드롭다운 목록에서 역할을 선택합니다.
+ 새 IAM 역할을 수동으로 생성하려면 **역할 생성**을 선택한 다음 IAM 콘솔을 사용하여 새 역할을 생성합니다.
**참고**
보고서 버킷 **Amazon S3 위치**에 객체를 쓰고 보고서 버킷으로의 멀티파트 업로드를 중지하려면 지정한 IAM 역할에 다음 권한이 있어야 합니다.
`s3:PutObject`
`s3:AbortMultipartUpload`
또한 이 역할은 `storagegateway.amazonaws.com` 서비스가 `sts:AssumeRole` 작업을 사용하여 역할을 수임하도록 허용해야 합니다.
1. **보고서 필터**의 경우 다음 중 하나를 수행하여 캐시 보고서에 포함할 파일을 결정합니다.
+ 현재 Amazon S3에 업로드에 실패한 캐시된 모든 파일을 포함하려면 **업로드에 실패한 모든 파일**을 선택합니다.
+ 특정 이유로 Amazon S3에 업로드하지 못한 파일만 포함하려면 **특정 업로드 실패 이유만**을 선택합니다. 그런 다음 **실패의 이유**로 다음 이유 중 하나 이상을 선택합니다.
+ 액세스할 수 없는 스토리지 클래스 - 게이트웨이에서 객체가 저장된 Amazon S3 스토리지 클래스에 액세스할 수 없습니다. 자세한 내용은 [오류: InaccessibleStorageClass](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-inaccessiblestorageclass)를 참조하세요.
+ 잘못된 객체 상태 - 게이트웨이의 파일 상태가 Amazon S3의 파일 상태와 일치하지 않습니다. 자세한 내용은 [오류: InvalidObjectState](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-invalidobjectstate)를 참조하세요.
+ 객체 누락 - 객체가 Amazon S3에서 삭제 또는 이동되었습니다. 자세한 내용은 [오류: ObjectMissing](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-objectmissing)을 참조하세요.
+ S3 액세스 거부 - Amazon S3 버킷 액세스 IAM 역할이 게이트웨이가 업로드 작업을 수행하는 것을 허용하지 않습니다. 자세한 내용은 [오류: S3AccessDenied](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html#troubleshoot-logging-errors-s3accessdenied)를 참조하세요.
**참고**
**파일 업로드 실패** 플래그는 24시간마다 그리고 게이트웨이 재부팅 중에 재설정됩니다. 이 보고서가 재설정 후 다시 플래그가 지정되기 전에 파일을 캡처하는 경우 해당 파일은 **파일 업로드 실패**로 보고되지 않습니다.
1. **VPC 엔드포인트를 사용하여 S3에 연결?**에서 다음 중 하나를 수행하여 게이트웨이가 Amazon S3 버킷에 연결하는 방법을 지정합니다.
+ Amazon VPC를 사용하지 않고 직접 연결하려면 **버킷에 직접 연결**을 선택합니다.
+ 기존 Amazon VPC 엔드포인트 목록을 찾아보려면 **VPC 엔드포인트 선택**을 선택한 다음 나타나는 **VPC 엔드포인트 드롭다운 목록에서 엔드포인트**를 지정합니다.
+ DNS 이름으로 기존 Amazon VPC 엔드포인트를 지정하려면 **VPC 엔드포인트 DNS 이름 입력**을 선택한 다음 나타나는 **VPC 엔드포인트 DNS 이름 필드에 DNS 이름**을 입력합니다.
**참고**
파일 공유가 VPC 엔드포인트를 사용하여 정상적인 작업을 위해 Amazon S3에 연결하는 경우 캐시 보고서를 구성할 때 동일한 VPC를 사용하는 것이 좋습니다. 게이트웨이가 잘못된 VPC 구성을 포함하여 어떤 이유로든 Amazon S3 버킷에 연결할 수 없는 경우 캐시 보고서 생성이 실패합니다.
1. (선택 사항) **태그 - 선택 사항**에서 **새 태그 추가**를 선택한 다음 캐시 보고서에 대한 **키**와 **값**을 입력합니다.
태그는 Storage Gateway 리소스를 분류하는 데 도움이 되는 대/소문자를 구분하는 키-값 페어입니다. 태그를 추가하면 캐시 보고서를 더 쉽게 필터링하고 검색할 수 있습니다. 이 단계를 반복하여 최대 50개의 태그를 추가할 수 있습니다.
1. 마친 후에는 **보고서 생성**을 선택합니다.
Storage Gateway가 보고서 생성을 시작합니다. 파일 공유에 대한 세부 정보 페이지의 **캐시 보고서** 탭에서 진행 상황을 확인하고 상태를 볼 수 있습니다.
# S3 File Gateway에 대한 캐시 보고서 보기 및 관리
캐시 보고서는 지정한 필터 및 기준에 따라 특정 파일 공유에 대해 현재 로컬 캐시에 있는 파일을 나열합니다. API AWS Storage Gateway 또는 Storage Gateway 콘솔을 사용하여 특정 파일 공유에 대한 기존 캐시 보고서 목록을 보고, 보고서 진행 상황 및 상태를 확인하고, 더 이상 필요하지 않은 보고서를 삭제할 수 있습니다.
API를 사용하여 캐시 보고서를 관리하려면 *Storage Gateway API 참조*의 다음 섹션을 참조하세요.
+ [ListCacheReports](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_ListCacheReports.html)
+ [DescribeCacheReport](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_DescribeCacheReport.html)
+ [CancelCacheReport](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_CancelCacheReport.html)
+ [DeleteCacheReport](https://docs.aws.amazon.com/storagegateway/latest/APIReference/API_DeleteCacheReport.html)
Storage Gateway 콘솔에서 캐시 보고서를 관리하려면 다음 절차를 사용합니다.
**Storage Gateway 콘솔을 사용하여 캐시 보고서를 관리하려면**
1. Storage Gateway 콘솔([https://console.aws.amazon.com/storagegateway/home/](https://console.aws.amazon.com/storagegateway/home/))을 엽니다.
1. 페이지 왼쪽의 탐색 창에서 **파일 공유**를 선택한 다음 캐시 보고서를 관리할 파일 공유를 선택합니다.
1. 파일 공유의 **세부 정보** 페이지에서 **캐시 보고서** 탭을 선택합니다. 이 탭은 파일 공유에 대한 기존 캐시 보고서를 나열하고 보고서 파일이 Amazon S3에 저장되는 상태, 진행 상황 및 객체 경로에 대한 정보를 제공합니다.
1. 다음 중 하나를 수행하세요.
+ 보고서 ARN 및 관련 태그와 같은 특정 보고서에 대한 추가 세부 정보를 보려면 **보고서 ID** 열에서 보고서를 선택합니다.
+ 동시에 관리할 여러 보고서를 지정하려면 확인란 열을 사용하여 보고서를 선택합니다.
1. 하나 이상의 보고서를 관리하려면 **작업** 드롭다운 메뉴에서 다음 중 하나를 선택합니다.
+ 캐시 보고서 삭제 - Storage Gateway 데이터베이스에서 캐시 보고서의 레코드를 삭제합니다. 더 이상 사용되지 않는 캐시 보고서의 레코드를 삭제하여 새 보고서를 위한 공간을 확보합니다. 각 파일 공유에는 언제든지 최대 10개의 기존 캐시 보고서가 있을 수 있습니다.
**참고**
이 절차를 사용하여 캐시 보고서 레코드를 삭제해도 Amazon S3에서 보고서 파일 객체는 삭제**되지 않습니다**.
+ 보고서 취소 - 현재 진행 중인 보고서를 취소합니다. 보고서 구성 중에 실수를 했거나 보고서를 완료하는 데 비정상적으로 오랜 시간이 걸리는 경우 진행 중인 보고서를 취소합니다. 메시지가 표시되면 취소를 확인합니다.
**참고**
완료 시간은 캐시의 파일 수에 따라 크게 달라질 수 있습니다. 일반적으로 대부분의 보고서는 5분 이내에 완료됩니다.
Storage Gateway 콘솔에 취소 또는 삭제 작업의 결과를 나타내는 메시지가 표시됩니다.
# S3 File Gateway 캐시 보고서에 제공된 정보 이해
캐시 보고서는 지정한 필터 및 기준에 따라 특정 파일 공유에 대해 현재 로컬 캐시에 있는 파일을 나열합니다. 각 캐시 보고서에는 다음 정보가 포함됩니다.
+ **버킷** - 파일 공유와 연결된 Amazon S3 버킷 또는 액세스 포인트입니다.
+ **S3ObjectKey** -이 파일의 데이터 및 메타데이터를 저장하는 Amazon S3 객체입니다. 이 객체에는 S3에 업로드된 최신 데이터가 있지만 S3에 업로드하지 못하는 데이터가 누락되었을 수 있습니다.
+ **FilePath** - 게이트웨이 캐시의 파일 항목에 대한 파일 경로입니다. 여기에서 파일 공유를 탑재하고 탐색할 때 파일을 찾을 수 있습니다.
+ **RenamedTo** - 이름이 변경된 파일의 새 경로입니다. 파일 공유에서 파일의 이름을 바꿀 때 게이트웨이는 파일의 이전 위치와 새 위치를 모두 추적해야 합니다. 이 필드는 파일이 이동된 위치를 표시하므로 파일 이름이 여러 번 바뀌더라도 파일 이름 바꾸기 작업을 추적할 수 있습니다. 이 정보는 파일 공유의 파일이 Amazon S3 버킷의 객체와 어떻게 일치하는지 이해해야 할 때 특히 유용합니다.
다음 예제는 File Gateway를 통해 이름이 변경되는 동시에 Amazon S3에서 직접 덮어쓰는 파일과 관련된 복잡한 시나리오의 캐시 보고서 항목을 보여줍니다. 이 시나리오에서 게이트웨이는 `A.txt` 파일을 S3에 업로드한 다음 파일 콘텐츠를 제거하여 로컬 캐시에 공간을 만듭니다. 그런 다음 연결된 S3 객체를 게이트웨이가 수행한 작업이 아닌 S3에서 직접 덮어쓰게 되며, 이로 인해 S3 객체와 게이트웨이가 예상하는 것 간의 불일치로 인해 `InvalidObjectState`가 발생합니다. 동시에 게이트웨이를 통해 `A.txt` 파일의 이름이 `B.txt`로 변경되었습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/filegateway/latest/files3/understand-cache-reports.html)
+ **Type** - 항목이 `FILE` 또는 `DIRECTORY`에 대한 항목인지 여부를 나타냅니다.
+ **IsDirty** - Amazon S3에 업로드되지 않은 파일에 변경 유형이 있는 경우 `TRUE`를 보고합니다. 여기에는 파일의 데이터가 변경되지 않은 경우에도 파일 이름 및 읽기/쓰기 권한과 같은 메타데이터에 대한 변경 사항이 포함됩니다.
+ **IsDataDirty** - Amazon S3에 업로드되지 않은 파일 데이터에 변경 사항이 있는 경우 `TRUE`를 보고합니다.
+ **IsDeleted** - 게이트웨이에서 파일이 삭제된 경우 `TRUE`를 보고합니다. 파일이 삭제된 것으로 표시되면 항상 더티로 표시됩니다.
+ **IsFailingToUpload** - Amazon S3에 파일을 업로드하는 데 문제가 있는 경우 `TRUE`를 보고합니다. 이 상태는 게이트웨이가 업로드를 다시 시도하고 문제가 해결되었는지 확인할 수 있도록 24시간마다 재설정됩니다. 게이트웨이는 업로드에 실패한 파일에 대한 새 쓰기 작업을 거부합니다. 게이트웨이의 캐시에 전체 파일이 없는 경우 읽기 작업도 거부합니다.
+ **UploadError** - 파일이 Amazon S3에 업로드되지 못하게 하는 오류입니다. 이러한 오류를 해결하기 위한 자세한 내용과 권장 단계는 [문제 해결: File Gateway 문제](https://docs.aws.amazon.com/filegateway/latest/files3/troubleshooting-file-gateway-issues.html)를 참조하세요.
+ **SizeInBytes** - 파일의 총 크기입니다.
+ **IsWholeFileInCache** - 파일의 모든 데이터가 현재 게이트웨이 캐시에 저장되어 있는 경우 `TRUE`를 보고합니다. 파일이 Amazon S3에 업로드되지 않는 경우 TRUE``이면 게이트웨이에서 파일을 읽을 수 있습니다.