AWS EFS

AWS Elastic File System 메트릭 데이터를 수집

구성¶

Func 설치¶

Guance 통합 - 확장 - 관리형 Func 활성화를 권장합니다. 모든 사전 조건이 자동으로 설치되므로 스크립트 설치를 계속하세요

Func를 직접 배포하는 경우 Func 직접 배포를 참고하세요

설치 스크립트¶

참고: 요구 사항을 충족하는 Amazon AK를 미리 준비하세요(간단히 하려면 전역 읽기 전용 권한 ReadOnlyAccess를 직접 부여해도 됩니다)

관리형 버전 활성화 스크립트¶

Guance 콘솔에 로그인합니다
[통합] 메뉴를 클릭하고 [클라우드 계정 관리]를 선택합니다
[클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보가 이미 구성되어 있으면 이 단계를 건너뜁니다
[테스트]를 클릭합니다. 테스트가 성공하면 [저장]을 클릭합니다. 테스트에 실패하면 관련 구성 정보가 올바른지 확인한 뒤 다시 테스트합니다
[클라우드 계정 관리] 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 들어갑니다
클라우드 계정 상세 페이지의 [통합] 버튼을 클릭한 뒤 설치되지 않음 목록에서 AWS EFS를 찾아 [설치] 버튼을 클릭하면 설치 화면이 뜹니다. 그곳에서 설치하면 됩니다

수동 활성화 스크립트¶

Func 콘솔에 로그인한 뒤 [스크립트 마켓]을 클릭하고 Guance 스크립트 마켓으로 들어가 integration_aws_efs를 검색합니다
[설치]를 클릭한 뒤 AWS AK ID, AK Secret 및 계정 이름을 입력합니다.
[시작 스크립트 배포]를 클릭하면 시스템이 자동으로 Startup 스크립트 세트를 생성하고, 해당 시작 스크립트를 자동으로 구성합니다.
활성화 후에는 「관리 / 자동 트리거 구성」에서 해당 자동 트리거 구성을 확인할 수 있습니다. [실행]을 클릭하면 예약 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다.

확인¶

「관리 / 자동 트리거 구성」에서 해당 작업에 대응하는 자동 트리거 구성이 이미 있는지 확인하고, 작업 기록 및 로그를 통해 이상 여부를 점검합니다
Guance의 「기반 인프라 - 리소스 디렉터리」에서 자산 정보가 있는지 확인합니다
Guance의 「메트릭」에서 해당 모니터링 데이터가 있는지 확인합니다

메트릭¶

Amazon CloudWatch를 구성하면 설정 방식으로 더 많은 메트릭을 수집할 수 있습니다 Amazon CloudWatch 메트릭 상세

AWS Elastic File System 메트릭은 aws_AWS/EFS 메트릭 세트 아래에 있으며, 설명 열에는 각 메트릭의 설명과 단위 및 통계 데이터가 포함됩니다.

메트릭	설명	단위
`ClientConnections`	파일 시스템의 클라이언트 연결 수	Count
`DataReadIOBytes`	파일 시스템별 읽기 작업의 실제 바이트 수	Bytes
`DataWriteIOBytes`	파일 시스템별 쓰기 작업의 실제 바이트 수	Bytes
`MetadataIOBytes`	각 메타데이터 작업의 실제 바이트 수	Bytes
`MetadataReadIOBytes`	각 메타데이터 읽기의 실제 바이트 수	Bytes
`MetadataWriteIOBytes`	각 메타데이터 쓰기의 실제 바이트 수	Bytes
`MeteredIOBytes`	각 파일 시스템 작업의 계량된 바이트 수	Bytes
`PercentIOLimit`	파일 시스템이 일반 성능 모드의 I/O 제한에 얼마나 가까운지를 표시	%
`PermittedThroughput`	파일 시스템이 처리할 수 있는 최대 처리량	Bytes/s
`TotalIOBytes`	IO 작업 전송 바이트 수	Bytes

객체¶

수집된 AWS Elastic File System 객체 데이터 구조이며, 「기반 인프라 - 리소스 디렉터리」에서 객체 데이터를 확인할 수 있습니다

{
  "measurement": "aws_efs",
  "tags": {
    "OwnerId"                    : "876267738xxxx",
    "FileSystemId"               : "fs-03babd100fxxxxxxx",
    "FileSystemArn"              : "arn:aws:elasticfilesystem:ap-southeast-1:876267738534:file-system/fs-xxx",
    "LifeCycleState"             : "available",
    "PerformanceMode"            : "generalPurpose",
    "KmsKeyId"                   : "arn:aws:kms:ap-southeast-1:876267738534:key/0dd81bcb-d916xxxxx",
    "ThroughputMode"             : "elastic",
    "AvailabilityZoneName"       : "xxxxxxx",
    "AvailabilityZoneId"         : "xxxxxxx",
    "State"                      : "xxxxxxx"

  },
  "fields": {
    "NumberOfMountTargets"                    : "3",
    "CreationTime"                            : "2025/07/18 17:23:04",
    "Encrypted"                               : "True",
    "ProvisionedThroughputInMibps"            : "xxxxxx"
  }
}

주의: tags와 fields의 필드는 이후 업데이트에 따라 변경될 수 있습니다