AWS OpenSearch Serverless(AOSS)
AWS OpenSearch Serverless (AOSS) 메트릭 데이터 수집
구성¶
Func 설치¶
Guance 통합 - 확장 - 호스팅 Func를 활성화하는 것을 권장합니다. 모든 사전 요구 사항이 자동으로 설치되므로 스크립트 설치를 진행하세요.
직접 Func를 배포하는 경우 Func 직접 배포를 참고하세요
설치 스크립트¶
안내: 요구 사항에 맞는 Amazon AK를 미리 준비해 주세요. (간단히 하려면 전역 읽기 전용 권한
ReadOnlyAccess를 직접 부여해도 됩니다)
관리형 Func에서 스크립트 활성화¶
- Guance 콘솔에 로그인합니다
- 【통합】 메뉴를 클릭하고 【클라우드 계정 관리】를 선택합니다
- [클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보가 이미 설정되어 있다면 이 단계를 건너뜁니다
- [테스트]를 클릭하고, 테스트에 성공하면 [저장]을 클릭합니다. 테스트에 실패하면 관련 설정이 올바른지 확인한 뒤 다시 테스트합니다
- 【클라우드 계정 관리】 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 들어갑니다
- 클라우드 계정 상세 페이지에서 【통합】을 클릭하고
미설치목록에서AWS OpenSearch Serverless(AOSS)를 찾은 다음 【설치】를 클릭하여 설치 양식을 엽니다.
수동 활성화 스크립트¶
-
Func 콘솔에 로그인하고 【스크립트 마켓】을 클릭하여 Guance 스크립트 마켓을 연 다음
integration_open_search_serverless를 검색합니다. -
[설치]를 클릭한 뒤 다음 파라미터를 입력합니다. AWS AK ID, AK Secret, 계정명.
-
[배포 시작 스크립트]를 클릭하면 시스템이 자동으로
Startup스크립트 세트를 생성하고, 해당 시작 스크립트를 자동으로 구성합니다. -
활성화 후에는 [관리 / 자동 트리거 설정]에서 해당 자동 트리거 구성을 확인할 수 있습니다. [실행]을 클릭하면 예약 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다.
검증¶
- [관리 / 자동 트리거 구성]에서 해당 작업의 자동 트리거 구성이 있는지 확인하고 작업 기록과 로그에서 이상 여부를 점검합니다.
- Guance의 「인프라 - 리소스 디렉터리」에서 자산 정보가 있는지 확인합니다
- Guance의 【메트릭】에서 해당 모니터링 데이터가 있는지 확인합니다.
지표¶
AWS OpenSearch Serverless (AOSS) 메트릭은 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 (AOSS) 객체 데이터 구조는 「인프라 - 리소스 디렉터리」에서 객체 데이터를 확인할 수 있습니다
{
"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의 필드는 이후 업데이트에 따라 변경될 수 있습니다