AWS OpenSearch Serverless

AWS OpenSearch Serverless 메트릭 데이터 수집

구성¶

Func 설치¶

Guance 통합 - 확장 - 관리형 Func 사용을 권장합니다: 모든 사전 조건이 자동으로 설치되므로, 스크립트 설치를 계속 진행하세요

Func를 직접 배포하는 방법은 직접 Func 배포를 참고하세요

설치 스크립트¶

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

관리형 개통 스크립트¶

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

수동 개통 스크립트¶

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

검증¶

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

메트릭¶

AWS OpenSearch Serverless 메트릭은 aws_aoss 메트릭 세트에 있으며, 설명 열에는 각 메트릭의 설명과 단위 및 통계 데이터가 포함됩니다.

메트릭	설명	단위
`ActiveCollection`	컬렉션이 활성 상태인지 나타냅니다. 값이 1이면 컬렉션이 ACTIVE 상태임을 의미합니다. 이 값은 컬렉션이 성공적으로 생성되면 발행되며, 컬렉션을 삭제할 때까지 계속 1로 유지됩니다. 이 메트릭의 값은 0이 될 수 없습니다.	-
`DeletedDocuments`	삭제된 문서의 총수입니다.	count
`IndexingOCU`	컬렉션 데이터 수집에 사용되는 OpenSearch 컴퓨팅 단위(OCU)의 수입니다. 이 메트릭은 계정 수준에 적용됩니다.	count
`IngestionDataRate`	컬렉션 또는 인덱스의 인덱싱 속도이며, 단위는 GiB/s입니다	GiB/s
`IngestionDocumentErrors`	컬렉션 또는 인덱스 수집 중 발생한 문서 오류의 총수입니다. 대량 인덱싱 요청이 성공적으로 완료된 후 작성자는 해당 요청을 처리하고, 요청에서 실패한 모든 문서에 대해 오류를 발행합니다.	count
`IngestionDocumentRate`	문서를 컬렉션 또는 인덱스로 수집하는 초당 속도입니다. 이 메트릭은 대량 인덱싱 요청에만 적용됩니다.	count/s
`IngestionRequestErrors`	컬렉션의 대량 인덱싱 요청 오류 총수입니다.	count
`IngestionRequestLatency`	컬렉션에 대한 대량 쓰기 작업의 지연 시간이며, 단위는 초입니다.	s
`IngestionRequestRate`	컬렉션이 수신한 대량 쓰기 작업의 총수입니다.	count
`IngestionRequestSuccess`	컬렉션에 대해 성공적으로 인덱싱 작업이 수행된 삭제된 문서의 총수입니다.	count
`SearchableDocuments`	컬렉션 또는 인덱스에서 검색 가능한 문서의 총수입니다.	count
`SearchRequestErrors`	컬렉션의 분당 쿼리 오류 총수입니다.	count
`SearchRequestLatency`	컬렉션에서 검색 작업을 완료하는 데 걸리는 평균 시간이며, 단위는 밀리초입니다.	ms
`SearchOCU`	검색용으로 컬렉션 데이터에 사용되는 OpenSearch 컴퓨팅 단위(OCU)의 수입니다.	count
`SearchRequestRate`	컬렉션에 대한 분당 검색 요청 총수입니다.	count
`StorageUsedInS3`	사용 중인 Amazon S3 저장 공간의 양이며, 바이트 단위입니다.	count
`2xx, 3xx, 4xx, 5xx`	주어진 HTTP 응답 코드(2xx, 3xx, 4xx, 5xx)를 생성한 컬렉션에 대한 요청 수입니다.	count

객체¶

수집된 AWS OpenSearch Serverless 객체 데이터 구조는 「인프라 - 리소스 디렉터리」에서 객체 데이터를 확인할 수 있습니다

{
  "measurement": "aws_opensearch_serverless",
  "tags": {
    "collection_id"             : "91dxh9h35ijjctd8nlvxfd4d",
    "collection_name"           : "xxx-test",
    "RegionId"                  : "ap-southeast-1",
    "arn"                       : "arn:aws:aoss:ap-southeast-1:87xxxxxxx45r:collection/xh9h35ijjctd8nldddxd
"
  },
  "fields": {
    "status"                    : "ACTIVE"
  }
}

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