파일 게이트웨이 모니터링 - AWSStorage Gateway
파일 게이트웨이 상태 로그 가져오기Amazon CloudWatch 지표 사용파일 작업에 대한 알림 받기게이트웨이 지표 이해파일 공유 지표 이해파일 게이트웨이 감사 로그 이해

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

파일 게이트웨이 모니터링

에서 파일 게이트웨이 및 관련 리소스를 모니터링할 수 있습니다.AWS Storage GatewayAmazon CloudWatch 지표 및 파일 공유 감사 로그를 사용합니다. 또한 CloudWatch 이벤트를 사용하여 파일 작업이 완료될 때 알림을 받을 수도 있습니다. 파일 게이트웨이 유형 지표에 대한 자세한 내용은 파일 게이트웨이 모니터링 단원을 참조하십시오.

CloudWatch 로그 그룹을 사용하여 파일 게이트웨이 상태 로그 가져오기

Amazon CloudWatch Logs 사용하여 파일 게이트웨이 및 관련 리소스 상태에 대한 정보를 가져올 수 있습니다. 로그를 사용하여 게이트웨이에 로그가 발생하는지 모니터링할 수 있습니다. 또한 Amazon CloudWatch 구독 필터를 사용하여 실시간으로 로그 정보 처리를 자동화할 수 있습니다. 자세한 내용은 단원을 참조하십시오.구독을 통한 로그 데이터 실시간 처리의Amazon CloudWatch 사용 설명서

예를 들어 게이트웨이를 모니터링하고, 파일 게이트웨이에서 Amazon S3 버킷에 파일을 업로드하는 데 실패하면 알림을 받도록 CloudWatch 로그 그룹을 구성할 수 있습니다. 게이트웨이를 활성화할 때나 게이트웨이가 활성화되어 실행된 후에 그룹을 구성할 수 있습니다. 게이트웨이를 활성화할 때 CloudWatch 로그 그룹을 구성하는 방법에 대한 자세한 내용은 단원을 참조하십시오.Amazon S3 파일 게이트웨이 구성. CloudWatch 로그 그룹에 대한 일반적인 내용은 단원을 참조하십시오.로그 그룹 및 로그 스트림 작업의Amazon CloudWatch 사용 설명서

다음은 파일 게이트웨이에서 보고하는 오류의 예입니다.

{
    "severity": "ERROR",
    "bucket": "bucket-smb-share2",
    "roleArn": "arn:aws:iam::123456789012:role/my-bucket",
    "source": "share-E1A2B34C",
    "type": "InaccessibleStorageClass",
    "operation": "S3Upload",
    "key": "myFolder/myFile.text",
    "gateway": "sgw-B1D123D4",
    "timestamp": "1565740862516"
}

이 오류는 파일 게이트웨이가 객체를 업로드할 수 없음을 의미합니다.myFolder/myFile.textAmazon S3로 전환되었으므로 Amazon S3 스탠다드 스토리지 클래스에서 S3 Glacier Flacive 검색 또는 S3 Glacier Deep Archive 스토리지 클래스로 전환되었으므로

앞에 나온 게이트웨이 상태 로그에서는 다음 항목이 주어진 정보를 지정합니다.

  • source: share-E1A2B34C - 이 오류를 일으킨 파일 공유를 나타냅니다.

  • "type": "InaccessibleStorageClass" - 발생한 오류의 유형을 나타냅니다. 여기서는 게이트웨이가 지정된 객체를 Amazon S3에 업로드하거나 Amazon S3 읽으려고 할 때 이 오류가 발생했습니다. 하지만 이때 객체는 Amazon S3 Glacier로 전환했습니다. "type"의 값은 파일 게이트웨이가 일으키는 모든 오류일 수 있습니다. 가능한 오류 목록은 파일 게이트웨이 문제 해결 단원을 참조하십시오.

  • "operation": "S3Upload"- 게이트웨이가 이 객체를 S3에 업로드하려고 할 때 이 오류가 발생했음을 나타냅니다.

  • "key": "myFolder/myFile.text" - 오류를 유발한 객체를 나타냅니다.

  • gateway": "sgw-B1D123D4 - 이 오류를 일으킨 파일 게이트웨이를 나타냅니다.

  • "timestamp": "1565740862516"오류 발생 시간을 나타냅니다.

문제를 해결하고 이 오류 유형을 해결하는 방법에 대한 자세한 내용은 파일 게이트웨이 문제 해결 단원을 참조하십시오.

게이트웨이가 활성화된 후 CloudWatch 로그 그룹 구성

다음 과정에서는 게이트웨이가 활성화된 후 CloudWatch 로그 그룹을 구성하는 방법을 보여줍니다.

파일 게이트웨이와 함께 작동하도록 CloudWatch 로그 그룹을 구성하려면

  1. 에 로그인합니다.AWS Management Console에서 Storage Gateway 콘솔을 엽니다.https://console.aws.amazon.com/storagegateway/home.

  2. 탐색 창에서 [] 를 선택합니다.게이트웨이그런 다음 CloudWatch 로그 그룹을 구성할 게이트웨이를 선택합니다.

  3. 용작업, 선택게이트웨이 정보 편집. 또는,세부 정보탭, 아래Health 로그과사용 안 함, 선택로그 그룹 구성를 열려면Edit커스텀 게이트웨이 이름대화 상자.

  4. 용게이트웨이 상태 로그 그룹다음 중 하나를 선택합니다.

    • 로깅 비활성화CloudWatch 로그 그룹을 사용하여 게이트웨이를 모니터링하지 않으려는 경우

    • 새 로그 그룹 생성를 사용하여 새 CloudWatch 로그 그룹을 생성합니다.

    • 기존 로그 그룹 사용이미 존재하는 CloudWatch 로그 그룹을 사용합니다.

      에서 로그 그룹을 선택합니다.기존 로그 그룹 목록.

  5. 변경 사항 저장(Save changes)을 선택합니다.

  6. 게이트웨이의 상태 로그를 확인하려면 다음을 수행합니다.

    1. 탐색 창에서 [] 를 선택합니다.게이트웨이그런 다음 CloudWatch 로그 그룹을 구성한 게이트웨이를 선택합니다.

    2. 선택을 선택합니다.세부 정보탭 및 아래Health 로그, 선택CloudWatch Logs(CloudWatch 로그). 이로그 그룹 세부 정보CloudWatch 콘솔에서 페이지가 열립니다.

파일 게이트웨이와 함께 작동하도록 CloudWatch 로그 그룹을 구성하려면

  1. 에 로그인합니다.AWS Management Console에서 Storage Gateway 콘솔을 엽니다.https://console.aws.amazon.com/storagegateway/home.

  2. 선택게이트웨이그런 다음 CloudWatch 로그 그룹을 구성할 게이트웨이를 선택합니다.

  3. 용작업, 선택게이트웨이 정보 편집. 또는세부 정보탭, 옆에로깅를 열려면사용 안 함, 선택로그 그룹 구성를 열려면게이트웨이 정보 편집대화 상자.

  4. 용게이트웨이 로그 그룹, 선택기존 로그 그룹 사용를 선택합니다. 그런 다음 사용할 로그 그룹을 선택합니다.

    로그 그룹이 없는 경우 새 로그 그룹 만들기를 선택하여 로그 그룹을 만듭니다. 로그 그룹을 만들 수 있는 CloudWatch Logs 콘솔로 이동합니다. 새 로그 그룹을 만드는 경우 새로 고침 버튼을 선택하여 드롭다운 목록에서 새 로그 그룹을 확인합니다.

  5. 마치면 [Save]를 선택합니다.

  6. 게이트웨이의 로그를 보려면 게이트웨이를 선택한 다음세부 정보탭.

오류 문제 해결 방법에 대한 자세한 내용은 파일 게이트웨이 문제 해결 단원을 참조하십시오.

Amazon CloudWatch 지표 사용

파일 게이트웨이에 대한 모니터링 데이터를 얻을 수 있습니다.AWS Management ConsoleCloudWatch API 를 사용합니다. 콘솔에는 CloudWatch API의 원시 데이터를 기초로 하는 일련의 그래프가 표시됩니다. CloudWatch API는 다음 중 하나를 통해서도 사용할 수 있습니다.AWSSDK또는Amazon CloudWatch API도구. 필요에 따라 콘솔에 표시되거나 API에서 가져온 그래프를 사용하는 것이 더 나을 수 있습니다.

지표 관련 작업을 위해 사용하는 방법에 관계 없이 다음 정보를 지정해야 합니다.

  • 작업할 지표 차원. 차원은 지표를 고유하게 식별하는 데 도움이 되는 이름-값 페어입니다. Storage Gateway 게이트웨이의 크기는 다음과 같습니다.GatewayId과GatewayName. CloudWatch 콘솔에서 다음을 사용할 수 있습니다.Gateway Metrics뷰로 게이트웨이별 차원을 선택합니다. 차원에 대한 자세한 내용은 단원을 참조하십시오.차원의Amazon CloudWatch 사용 설명서.

  • ReadBytes와 같은 지표 이름.

다음 표에서는 사용할 수 있는 Storage Gateway 지표 데이터의 유형을 요약한 것입니다.

Amazon CloudWatch 네임스페이스 차원 설명
AWS/StorageGateway GatewayId, GatewayName

이 차원은 게이트웨이의 여러 측면을 설명하는 지표 데이터를 필터링합니다. GatewayId 및 GatewayName 차원을 모두 지정하여 작업할 파일 게이트웨이를 식별할 수 있습니다.

게이트웨이의 처리량 및 지연 시간 데이터는 게이트웨이의 모든 파일 공유를 기반으로 합니다.

자동으로 5분 기간 동안 데이터를 무료로 사용할 수 있습니다.

게이트웨이 및 파일 지표 작업은 기타 서비스 지표 작업과 유사합니다. 아래 나열된 CloudWatch 문서에서 가장 흔한 지표 작업 일부에 대한 논의를 보실 수 있습니다.

파일 작업에 대한 알림 받기

파일 작업이 완료될 때 Storage Gateway CloudWatch 이벤트를 시작할 수 있습니다.

  • 게이트웨이가 파일 공유에서 Amazon S3 S3로 파일을 비동기 업로드하는 작업이 완료될 때 알림을 받을 수 있습니다. 사용NotificationPolicy파일 업로드 알림을 요청하는 매개 변수입니다. 이렇게 하면 완료된 각 파일 업로드에 대한 알림이 Amazon S3 전송됩니다. 자세한 정보는 파일 업로드 알림 받기을 참조하십시오.

  • 게이트웨이가 파일 공유에서 Amazon S3 S3로 작업 파일 세트의 비동기 업로드가 완료될 때 알림을 받을 수 있습니다. 사용NotifyWhenUploaded작업 파일 세트 업로드 알림을 요청하는 API 작업입니다. 작업 파일 세트의 모든 파일이 Amazon S3 업로드되면 알림을 전송합니다. 자세한 정보는 작업 파일 세트 업로드 알림 받기을 참조하십시오.

  • 게이트웨이가 S3 버킷에서 캐시 새로 고침을 완료하면 알림을 받을 수 있습니다. 를 호출할 때RefreshCacheStorage Gateway 콘솔이나 API를 통한 작업, 작업 완료 시 알림을 받도록 구독합니다. 자세한 정보는 새로 고침 캐시 알림 받기을 참조하십시오.

요청한 파일 작업이 완료되면 Storage Gateway가 CloudWatch Events를 통해 알림을 전송합니다. Amazon SNS, Amazon SQS 또는AWS Lambda함수. 예를 들어 이메일이나 문자 메시지 같은 알림을 Amazon SNS 소비자에게 전송하도록 Amazon SNS 대상을 구성할 수 있습니다. CloudWatch 이벤트에 대한 자세한 내용은 단원을 참조하십시오.CloudWatch 이벤트란 무엇입니까?

CloudWatch Events 알림을 설정하려면

  1. Storage Gateway에서 요청한 이벤트가 트리거될 때 호출할 대상 (Amazon SNS 주제 또는 Lambda 함수) 을 생성합니다.

  2. CloudWatch Eventds 콘솔에서 Storage Gateway의 이벤트를 기반으로 대상을 호출하기 위한 규칙을 만듭니다.

  3. 규칙에서 이벤트 유형에 대한 이벤트 패턴을 생성합니다. 이벤트가 이 규칙 패턴과 일치할 때 알림이 트리거됩니다.

  4. 대상을 선택하고 설정을 구성합니다.

다음 예제에서는 지정된 게이트웨이와 지정된 게이트웨이에서 지정된 이벤트 유형을 시작하는 규칙을 보여줍니다.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 이벤트를 사용하여 규칙을 트리거하는 방법에 대한 자세한 내용은 단원을 참조하십시오.이벤트에서 트리거되는 CloudWatch Events 규칙 생성의Amazon CloudWatch Events 사용 설명서.

파일 업로드 알림 받기

파일 업로드 알림은 다음과 같은 두 가지 사용 사례에서 사용할 수 있습니다.

  • 업로드된 파일의 클라우드 내 처리를 자동화하기 위해NotificationPolicy매개 변수를 선택하고 알림 ID를 다시 가져옵니다. 파일이 업로드되면 트리거되는 알림은 API가 반환한 것과 동일한 알림 ID를 갖습니다. 이 알림 ID를 매핑하여 업로드 중인 파일 목록을 추적할 경우, 에 업로드된 파일의 처리를 트리거할 수 있습니다AWS동일한 ID를 가진 이벤트가 생성되는 경우입니다.

  • 콘텐츠 배포 사용 사례의 경우 동일한 Amazon S3 버킷에 매핑되는 파일 게이트웨이 두 개가 있을 수 있습니다. Gateway1용 파일 공유 클라이언트는 Amazon S3 새 파일을 업로드할 수 있으며, Gateway2의 파일 공유 클라이언트는 이 파일을 읽습니다. 이 파일은 Amazon S3 업로드되지만, Gateway2에서는 Amazon S3 S3에서 로컬로 캐시된 버전의 파일을 사용하므로 새 파일이 표시되지 않습니다. Gateway2에서 파일을 표시하려면NotificationPolicy업로드 파일이 완료될 때 알리도록 Gateway1의 파일 업로드 알림을 요청하는 매개 변수 그런 다음 CloudWatch 이벤트를 사용하여 자동으로RefreshCacheGateway2의 파일 공유를 요청합니다. 를 열려면RefreshCache요청이 완료되면 새 파일이 Gateway2에 표시됩니다.

예 - 파일 업로드 알림

다음 예제에서는 사용자가 생성한 규칙과 이벤트가 일치할 때 CloudWatchatch를 통해 사용자에게 전송되는 파일 업로드 알림을 보여 줍니다. 이 알림은 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": "my-bucket",  
    }
}

필드 이름

설명

version

IAM 정책의 현재 버전입니다.

id

IAM 정책을 식별하는 ID입니다.

detail-type

전송된 알림을 트리거한 이벤트에 대한 설명입니다.

소스

이AWS요청과 알림이 발생한 서비스입니다.

account

의 ID입니다.AWS요청과 알림이 생성된 계정입니다.

시간

Amazon S3 파일을 업로드하는 요청이 이루어진 시간입니다.

리전

이AWS요청과 알림이 전송된 리전입니다.

리소스

정책이 적용된 Storage Gateway 리소스입니다.

Object size

객체의 크기 (바이트) 입니다.

수정 시간

클라이언트가 파일을 수정한 시간입니다.

객체 키

파일의 경로입니다.

event-type

알림을 트리거한 CloudWatch 이벤트입니다.

prefix

S3 버킷의 접두사 이름입니다.

bucket-name

S3 버킷의 이름

작업 파일 세트 업로드 알림 받기

작업 파일 세트 업로드 알림을 사용할 수 있는 두 가지 사용 사례가 있습니다.

  • 업로드된 파일의 클라우드 내 처리를 자동화하기 위해NotifyWhenUploadedAPI를 사용하여 알림 ID를 다시 가져옵니다. 작업 파일 세트가 업로드되면 트리거되는 알림은 API가 반환한 것과 동일한 알림 ID를 갖습니다. 이 알림 ID를 매핑하여 업로드 중인 파일 목록을 추적할 경우, 에서 업로드된 파일 작업 집합의 처리를 트리거할 수 있습니다AWS동일한 ID를 가진 이벤트가 생성되는 경우입니다.

  • 콘텐츠 배포 사용 사례의 경우 동일한 Amazon S3 버킷에 매핑되는 파일 게이트웨이 두 개가 있을 수 있습니다. Gateway1용 파일 공유 클라이언트는 Amazon S3 새 파일을 업로드할 수 있으며, Gateway2의 파일 공유 클라이언트는 이 파일을 읽습니다. 이 파일은 Amazon S3 업로드되지만, Gateway2에서는 S3에서 로컬로 캐시된 버전의 파일을 사용하므로 새 파일이 표시되지 않습니다. Gateway2에서 파일을 표시하려면NotifyWhenUploaded작업 파일 세트 업로드가 완료될 때 알리도록 Gateway1의 파일 업로드 알림을 요청하는 API 작업 그런 다음 CloudWatch 이벤트를 사용하여 자동으로RefreshCacheGateway2의 파일 공유를 요청합니다. 를 열려면RefreshCache요청이 완료되면 새 파일이 Gateway2에 표시됩니다. 이 작업은 파일을 파일 게이트웨이 캐시 스토리지로 가져오지 않습니다. S3 버킷에 있는 객체의 인벤토리의 변경 사항을 반영하도록 캐시된 인벤토리만 업데이트합니다.

예 - 작업 파일 세트 업로드 알림

다음 예제에서는 사용자가 생성한 규칙과 이벤트가 일치할 때 CloudWatchatch를 통해 사용자에게 전송되는 파일 세트 업로드 알림을 보여 줍니다. 이 알림은 JSON 형식입니다. 이 알림을 텍스트 메시지로 대상에게 전달되도록 구성할 수 있습니다. detail-type은 Storage Gateway File Upload Event입니다.

{
    "version": "2012-10-17",
    "id": "2649b160-d59d-c97f-3f64-8aaa9ea6aed3",
    "detail-type": "Storage Gateway Upload Notification 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"
    }
}

필드 이름

설명

version

IAM 정책의 현재 버전입니다.

id

IAM 정책을 식별하는 ID입니다.

detail-type

전송된 알림을 트리거한 이벤트에 대한 설명입니다.

소스

이AWS요청과 알림이 발생한 서비스입니다.

account

의 ID입니다.AWS요청과 알림이 생성된 계정입니다.

시간

Amazon S3 파일을 업로드하는 요청이 이루어진 시간입니다.

리전

이AWS요청과 알림이 전송된 리전입니다.

리소스

정책이 적용되는 Storage Gateway 리소스입니다.

event-type

알림을 트리거한 CloudWatch 이벤트입니다.

notification-id

전송된 알림의 무작위 생성 ID입니다. 이 ID는 UUID 형식입니다. NotifyWhenUploaded 호출 시 반환된 알림 ID입니다.

request-received

게이트웨이가 NotifyWhenUploaded 요청을 받은 시간입니다.

completed

작업 세트의 모든 파일이 Amazon S3 업로드된 때입니다.

새로 고침 캐시 알림 받기

캐시 새로 고침 알림 사용 사례의 경우 두 개의 파일 게이트웨이를 동일한 Amazon S3 버킷에 매핑할 수 있으며, Gateway1용 NFS 클라이언트는 S3 버킷에 새 파일을 업로드합니다. 파일은 Amazon S3 업로드되지만, 캐시 새로 고침을 할 때까지 Gateway2에 나타나지 않습니다. 왜냐하면 Gateway2가 Amazon S3 로컬에 캐싱된 버전의 파일을 사용하기 때문입니다. 캐시 새로 고침이 완료될 때 Gateway2에서 파일을 처리하고 싶을 수 있습니다. 대용량 파일은 Gateway2에 표시되는 데 시간이 걸릴 수 있으므로 캐시 새로 고침이 완료될 때 알림을 받고 싶을 수 있습니다. 모든 파일이 Gateway2에서 표시될 때 이를 알려주도록 Gateway2에서 캐시 새로 고침 알림을 요청할 수 있습니다.

예 - 캐시 새로 고침 알림

다음 예제에서는 사용자가 생성한 규칙과 이벤트가 일치할 때 CloudWatchatch를 통해 사용자에게 전송되는 캐시 새로 고침 알림을 보여줍니다. 이 알림은 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": [
            "/"
        ]
    }
}

필드 이름

설명

version

IAM 정책의 현재 버전입니다.

id

IAM 정책을 식별하는 ID입니다.

detail-type

전송된 알림을 트리거한 이벤트 유형에 대한 설명입니다.

소스

이AWS요청과 알림이 발생한 서비스입니다.

account

의 ID입니다.AWS요청과 알림이 생성된 계정입니다.

시간

작업 세트에서 파일 새로 고침 요청이 이루어진 시간입니다.

리전

이AWS요청과 알림이 전송된 리전입니다.

리소스

정책이 적용되는 Storage Gateway 리소스입니다.

event-type

알림을 트리거한 CloudWatch 이벤트입니다.

notification-id

전송된 알림의 무작위 생성 ID입니다. 이 ID는 UUID 형식입니다. RefreshCache 호출 시 반환된 알림 ID입니다.

started

게이트웨이가 를 받은 시간입니다.RefreshCache요청과 새로 고침이 시작되었습니다.

completed

작업 세트의 새로 고침이 완료된 시간입니다.

folderList

캐시에서 새로 고친 폴더 경로의 목록(쉼표 구분)입니다. 기본값은 ["/"]입니다.

게이트웨이 지표 이해

다음 표에서는 S3 파일 게이트웨이를 나타내는 지표에 대해 설명합니다. 각 게이트웨이에는 연결된 지표 집합이 있습니다. 일부 게이트웨이별 지표는 특정 파일 공유별 지표와 이름이 같습니다. 이러한 지표는 같은 종류의 측정값을 나타내지만 파일 공유가 아닌 게이트웨이에 한정됩니다.

특정 지표로 작업할 때 게이트웨이와 파일 공유로 작업할지 아니면 파일 공유로 작업할지를 항상 지정합니다. 특히 게이트웨이 지표를 사용할 때는Gateway Name지표 데이터를 확인하려는 게이트웨이의 경우입니다. 자세한 정보는 Amazon CloudWatch 지표 사용을 참조하십시오.

다음 표에서는 에 대한 정보를 얻는 데 사용할 수 있는 지표에 대해 설명합니다.S3 파일 게이트웨이s.

지표 설명
AvailabilityNotifications

이 지표는 보고 기간 동안 게이트웨이에 의해 생성된 가용성 관련 상태 알림 수를 보고합니다.

단위: 개수
CacheFileSize

이 지표는 게이트웨이 캐시의 파일 크기를 추적합니다.

이 메트릭과 함께 사용Average게이트웨이 캐시에 있는 파일의 평균 크기를 측정하는 통계입니다. 이 메트릭과 함께 사용Max게이트웨이 캐시에 있는 파일의 최대 크기를 측정하는 통계입니다.

단위: 바이트
CacheFree

이 측정치는 게이트웨이 캐시에서 사용 가능한 바이트 수를 보고합니다.

단위: 바이트
CacheHitPercent

캐시로부터 읽는 게이트웨이의 애플리케이션 읽기 작업 백분율입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다.

게이트웨이에서 애플리케이션 읽기 작업이 없는 경우, 지표가 100% 를 보고합니다.

단위: %
CachePercentDirty

에 지속되지 않은 게이트웨이 캐시의 전체 백분율입니다.AWS. 보고 기간 종료 시점에서 샘플이 채취됩니다.

단위: %
CachePercentUsed

사용되는 게이트웨이 캐시 스토리지의 전체 비율입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다.

단위: %
CacheUsed

이 측정치는 게이트웨이 캐시에 사용된 바이트 수를 보고합니다.

단위: 바이트
CloudBytesDownloaded

게이트웨이가 로 업로드한 총 바이트 수입니다.AWS보고 기간 동안.

이 지표를 Sum 통계와 함께 사용하면 처리량을 측정할 수 있으며 Samples 통계와 함께 사용하면 초당 입력/출력 작업 수(IOPS)를 측정할 수 있습니다.

단위: 바이트
CloudBytesUploaded

보고 기간 동안 게이트웨이가 AWS로부터 다운로드한 총 바이트 수입니다.

이 지표를 Sum 통계와 함께 사용하면 처리량을 측정할 수 있으며 Samples 통계와 함께 사용하면 IOPS를 측정할 수 있습니다.

단위: 바이트
FilesFailingUpload

이 측정치는 업로드하지 못한 파일 수를 추적합니다.AWS. 이 파일은 문제에 대한 자세한 정보가 포함된 상태 알림을 생성합니다.

이 메트릭과 함께 사용Sum현재 업로드하지 못한 파일 수를 표시하는 통계AWS.

단위: 개수
FileSharesUnavailable

이 측정 단위는 이 게이트웨이에 있는 파일 공유 수를 제공합니다.Unavailable상태입니다.

이 측정 단위는 파일 공유를 사용할 수 없다고 보고하면 게이트웨이에 문제가 발생하여 워크플로가 중단될 수 있습니다. 이 지표가 0이 아닌 값을 보고할 때 경보를 만드는 것이 좋습니다.

단위: 개수
FilesRenamed

이 측정치는 보고 기간에 이름이 변경된 파일 수를 추적합니다.

단위: 개수
HealthNotifications

이 지표는 보고 기간 동안 이 게이트웨이에 의해 생성된 상태 알림 수를 보고합니다.

단위: 개수
IoWaitPercent

이 지표는 CPU가 로컬 디스크의 응답을 대기하고 있는 시간 비율을 보고합니다.

단위: %
MemTotalBytes

이 측정 단위는 게이트웨이의 총 메모리 양을 보고합니다.

단위: 바이트
MemUsedBytes

이 측정 단위는 게이트웨이에서 사용된 메모리 양을 보고합니다.

단위: 바이트
NfsSessions

이 측정치는 게이트웨이에서 활성 상태인 NFS 세션 수를 보고합니다.

단위: 개수
RootDiskFreeBytes

이 측정치는 게이트웨이의 루트 디스크에서 사용 가능한 바이트 수를 보고합니다.

이 측정 단위 보고서가 20GB 미만인 경우 루트 디스크의 크기를 늘려야 합니다.

단위: 바이트
S3GetObjectRequestTime

이 지표는 게이트웨이가 S3 get 객체 요청을 완료하는 데 걸리는 시간을 보고합니다.

단위: 밀리초
S3PutObjectRequestTime

이 지표는 게이트웨이가 S3 put 객체 요청을 완료하는 데 걸리는 시간을 보고합니다.

단위: 밀리초
S3UploadPartRequestTime

이 지표는 게이트웨이가 S3 업로드 부품 요청을 완료하는 데 걸리는 시간을 보고합니다.

단위: 밀리초
SmbV1Sessions

이 측정 치는 게이트웨이에서 활성 상태인 SMBv1 세션 수를 보고합니다.

단위: 개수
SmbV2Sessions

이 측정치는 게이트웨이에서 활성 상태인 SMBv2 세션 수를 보고합니다.

단위: 개수
SmbV3Sessions

이 측정치는 게이트웨이에서 활성 상태인 SMBv3 세션 수를 보고합니다.

단위: 개수
TotalCacheSize

이 지표는 캐시의 총 크기를 보고합니다.

단위: 바이트
UserCpuPercent

이 측정 단위는 게이트웨이 처리에 소요되는 시간의 비율을 보고합니다.

단위: %

파일 공유 지표 이해

파일 공유를 나타내는 Storage Gateway 지표에 대해 다음과 같은 정보를 확인할 수 있습니다. 각 파일 공유에는 연결된 지표 집합이 있습니다. 일부 파일 공유별 지표는 특정 게이트웨이별 지표와 이름이 같습니다. 이러한 지표는 동일한 종류의 측정값을 나타내지만, 그 대신 파일 공유로 범위가 한정됩니다.

지표 관련 작업을 하려면 항상 먼저 게이트웨이와 파일 공유 중 어느 것과 관련된 작업을 할 것인지 지정해야 합니다. 특히 파일 공유 지표 작업을 할 때는 지표를 보고 싶은 파일 공유를 식별하는 File share ID를 지정해야 합니다. 자세한 정보는 Amazon CloudWatch 지표 사용을 참조하십시오.

다음 표에서는 파일 공유에 대한 정보를 얻는 데 사용할 수 있는 Storage Gateway 측정치에 대해 설명합니다.

지표 설명
CacheHitPercent

캐시로부터 읽는 파일 공유의 애플리케이션 읽기 작업 백분율입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다.

파일 공유로부터의 애플리케이션 읽기 작업이 없는 경우, 지표가 100%를 보고합니다.

단위: %
CachePercentDirty

AWS에 지속되지 않은 게이트웨이 캐시의 전체 백분율 중 파일 공유가 차지하는 비중입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다.

게이트웨이의 CachePercentDirty 지표를 사용하면 AWS에 지속되지 않은 게이트웨이 캐시의 전체 백분율을 알 수 있습니다.

단위: %
CachePercentUsed

게이트웨이의 캐시 스토리지의 전체 사용 백분율 중 파일 공유가 차지하는 비중입니다. 보고 기간 종료 시점에서 샘플이 채취됩니다.

게이트웨이의 CachePercentUsed 지표를 사용하면 게이트웨이의 캐시 스토리지의 전체 사용 백분율을 알 수 있습니다.

단위: %
CloudBytesUploaded

게이트웨이가 로 업로드한 총 바이트 수입니다.AWS보고 기간 동안.

이 지표를 Sum 통계와 함께 사용하면 처리량을 측정할 수 있으며 Samples 통계와 함께 사용하면 IOPS를 측정할 수 있습니다.

단위: 바이트
CloudBytesDownloaded

보고 기간 동안 게이트웨이가 AWS로부터 다운로드한 총 바이트 수입니다.

이 지표를 Sum 통계와 함께 사용하면 처리량을 측정할 수 있으며 Samples 통계와 함께 사용하면 초당 입력/출력 작업 수(IOPS)를 측정할 수 있습니다.

단위: 바이트
ReadBytes

파일 공유에 대한 보고 기간 동안 온프레미스 애플리케이션으로부터 읽은 총 바이트 수입니다.

이 지표를 Sum 통계와 함께 사용하면 처리량을 측정할 수 있으며 Samples 통계와 함께 사용하면 IOPS를 측정할 수 있습니다.

단위: 바이트
WriteBytes

보고 기간 동안 온프레미스 애플리케이션에 작성한 총 바이트 수입니다.

이 지표를 Sum 통계와 함께 사용하면 처리량을 측정할 수 있으며 Samples 통계와 함께 사용하면 IOPS를 측정할 수 있습니다.

단위: 바이트

파일 게이트웨이 감사 로그 이해

Amazon S3 파일 게이트웨이 (S3 파일 게이트웨이) 감사 로그는 파일 공유 내의 파일과 폴더의 사용자 액세스에 대한 세부 정보를 제공합니다. 이러한 정보를 사용하여 사용자 활동을 모니터링하고 부적절한 활동 패턴이 식별되면 조치를 취할 수 있습니다.

작업

다음 표에서는 파일 게이트웨이 감사 로그 파일 액세스 작업에 대해 설명합니다.

작업 이름

정의

데이터 읽기

파일의 내용을 읽습니다.

데이터 쓰기

파일의 내용을 변경합니다.

생성

새 파일 또는 폴더를 만듭니다.

이름 바꾸기

기존 파일 또는 폴더의 이름을 바꿉니다.

Delete

파일 또는 폴더를 삭제합니다.

쓰기 속성

파일 또는 폴더 메타데이터(ACL, 소유자, 그룹, 권한)를 업데이트합니다.

속성

다음 표에서는 S3 파일 게이트웨이 감사 로그 파일 액세스 속성에 대해 설명합니다.

속성

정의
accessMode 객체에 대한 권한 설정입니다.
accountDomain (중소기업만 해당) 클라이언트의 계정이 속한 AD(Active Directory) 도메인입니다.
accountName (중소기업만 해당) 클라이언트의 Active Directory 사용자 이름입니다.
bucket S3 버킷 이름입니다.
clientGid (NFS만 해당) 객체에 액세스하는 사용자 그룹의 식별자입니다.
clientUid (NFS만 해당) 객체에 액세스하는 사용자의 식별자입니다.
ctime 클라이언트에서 설정한 객체의 콘텐츠나 메타데이터가 수정된 시간입니다.
groupId 객체의 그룹 소유자에 대한 식별자입니다.
fileSizeInBytes 파일 생성 시 클라이언트에서 설정한 파일 크기(바이트)입니다.
gateway 스토리지 게이트웨이 ID입니다.
mtime 클라이언트에서 설정한 객체의 콘텐츠가 수정된 시간입니다.
newObjectName 이름이 바뀐 후 새 객체의 전체 경로입니다.
objectName 객체의 전체 경로입니다.
objectType 객체가 파일 또는 폴더인지를 정의합니다.
operation 객체 액세스 작업의 이름입니다.
ownerId 객체의 소유자에 대한 식별자입니다.
securityDescriptor (중소기업만 해당) 객체에 설정된 DACL(임의 액세스 제어 목록)을 SDDL 형식으로 표시합니다.
shareName 액세스 중인 공유의 이름입니다.
source 감사할 파일 공유의 ID입니다.
sourceAddress 파일 공유 클라이언트 머신의 IP 주소입니다.
status 작업의 상태입니다. 성공만 기록됩니다 (권한 거부로 인해 발생한 실패를 제외하고 실패가 기록됩니다).
timestamp 게이트웨이의 OS 타임스탬프를 기준으로 작업이 발생한 시간입니다.
version 감사 로그 형식의 버전입니다.

작업당 로깅된 속성

다음 표에서는 각 파일 액세스 작업에서 기록된 S3 파일 게이트웨이 감사 로그 속성에 대해 설명합니다.

데이터 읽기

데이터 쓰기

폴더 생성

파일 만들기

파일/폴더 이름 바꾸기

파일/폴더 삭제

특성 쓰기 (ACL 변경 -SMB 전용)

쓰기 속성 (chown)

쓰기 속성 (chmod)

쓰기 속성 (chgrp)
accessMode X X X
accountDomain (중소기업만 해당) X X X X X X X X X X
accountName (중소기업만 해당) 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 (중소기업만 해당) 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