AWS Simple Queue Service¶
AWS Simple Queue Service (SQS)의 표시 지표에는 큐에서 가장 오래된 삭제되지 않은 메시지의 대략적인 존재 시간, 지연되어 즉시 읽을 수 없는 메시지 수, in-flight 상태의 메시지 수, 큐에서 가져올 수 있는 메시지 수 등이 포함됩니다.
구성¶
Func 설치¶
Guance 통합 - 확장 - 관리형 Func 개통을 권장합니다: 모든 사전 조건이 자동으로 설치되므로, 스크립트 설치를 계속 진행하세요
직접 Func를 배포하는 경우 Func 직접 배포를 참고하세요
설치 스크립트¶
안내: 요구 사항에 맞는 Amazon AK를 미리 준비하세요. (간단하게 하려면 전역 읽기 전용 권한
ReadOnlyAccess를 직접 부여할 수 있습니다)
관리형 개통 스크립트¶
- Guance 콘솔에 로그인합니다
- [통합] 메뉴를 클릭하고 [클라우드 계정 관리]를 선택합니다
- [클라우드 계정 추가]를 클릭하고 [AWS]를 선택한 뒤 화면에 필요한 정보를 입력합니다. 이전에 클라우드 계정 정보가 이미 설정되어 있다면 이 단계는 건너뜁니다
- [테스트]를 클릭합니다. 테스트가 성공하면 [저장]을 클릭합니다. 테스트가 실패하면 관련 설정이 올바른지 확인한 뒤 다시 테스트합니다
- [클라우드 계정 관리] 목록에서 추가된 클라우드 계정을 확인할 수 있습니다. 해당 클라우드 계정을 클릭해 상세 페이지로 들어갑니다
- 클라우드 계정 상세 페이지의 [통합] 버튼을 클릭한 뒤
미설치목록에서AWS Simple Queue Service를 찾아 [설치] 버튼을 클릭하면 설치 화면이 뜨고, 설치를 진행하면 됩니다
수동 개통 스크립트¶
-
Func 콘솔에 로그인한 뒤 [스크립트 마켓]을 클릭하여 Guance 스크립트 마켓으로 들어가
integration_aws_sqs를 검색합니다 -
[설치]를 클릭한 뒤 AWS AK ID, AK Secret 및 계정명을 입력합니다
-
[부팅 스크립트 배포]를 클릭하면 시스템이 자동으로
Startup스크립트 세트를 생성하고, 대응하는 시작 스크립트를 자동으로 구성합니다 -
활성화한 후에는 「관리 / 자동 트리거 구성」에서 해당 자동 트리거 구성을 확인할 수 있습니다. [실행]을 클릭하면 주기 시간을 기다리지 않고 즉시 한 번 실행할 수 있습니다. 잠시 후 실행 작업 기록과 해당 로그를 확인할 수 있습니다
검증¶
- 「관리 / 자동 트리거 구성」에서 해당 작업에 대한 자동 트리거 구성이 존재하는지 확인하고, 동시에 해당 작업 기록과 로그를 확인하여 이상이 있는지 검사합니다
- Guance의 「인프라 / 사용자 정의」에서 자산 정보가 존재하는지 확인합니다
- Guance의 「지표」에서 해당 모니터링 데이터가 있는지 확인합니다
지표¶
Amazon CloudWatch를 구성하면 기본 지표 집합은 다음과 같습니다. 구성 방식으로 더 많은 지표를 수집할 수 있습니다:
Amazon CloudWatch AWS Simple Queue Service 지표 상세
| 지표 이름 | 설명 | 단위 | 유효한 통계 데이터 |
|---|---|---|---|
ApproximateAgeOfOldestMessage |
큐에서 가장 오래된 삭제되지 않은 메시지의 대략적인 존재 시간입니다. 주의: 메시지를 세 번(또는 그 이상) 수신했지만 처리하지 않으면, 해당 메시지는 큐의 뒤쪽으로 이동하며 ApproximateAgeOfOldestMessage 지표는 아직 세 번을 초과해 수신되지 않은 두 번째로 오래된 메시지를 표시합니다. 큐에 redrive 정책이 있어도 이 동작은 발생합니다. 단일 poison pill 메시지(여러 번 수신되었지만 한 번도 삭제되지 않음)는 이 지표를 왜곡할 수 있으므로, poison pill 메시지가 성공적으로 사용되기 전까지는 지표에 해당 메시지의 사용 기간이 포함되지 않습니다. 큐에 redrive 정책이 있으면 구성된 최대 수신 횟수에 도달한 후 메시지는 dead-letter queue로 이동합니다. 메시지가 dead-letter queue로 이동하면, dead-letter queue의 ApproximateAgeOfOldestMessage 지표는 해당 메시지가 dead-letter queue로 이동한 시점을 나타냅니다(메시지가 전송된 원래 시점이 아님). 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 초 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
ApproximateNumberOfMessagesDelayed |
큐에서 지연되어 즉시 읽을 수 없는 메시지 수입니다. 큐가 지연 큐로 구성되어 있거나 지연 매개변수를 사용해 메시지를 전송한 경우에 발생합니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 개수 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
ApproximateNumberOfMessagesNotVisible |
in-flight 상태의 메시지 수입니다. 메시지가 클라이언트에 전송되었지만 아직 삭제되지 않았거나 가시성 창의 끝에 도달하지 않았으면 해당 메시지는 in-flight 상태로 간주됩니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 개수 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
ApproximateNumberOfMessagesVisible |
큐에서 가져올 수 있는 메시지 수입니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 개수 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
NumberOfEmptyReceives |
메시지를 반환하지 않은 ReceiveMessage API 호출 수입니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 개수 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
NumberOfMessagesDeleted |
큐에서 삭제된 메시지 수입니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 개수 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
NumberOfMessagesReceived |
ReceiveMessage 작업이 반환한 메시지 수입니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 개수 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
NumberOfMessagesSent |
큐에 추가된 메시지 수입니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 개수 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |
SentMessageSize |
큐에 추가된 메시지 크기입니다. 보고 기준: 큐가 활성 상태이면 음이 아닌 값을 보고합니다. | 바이트 | 평균값, 최소값, 최대값, 합계, 데이터 샘플(Amazon SQS 콘솔에서는 샘플 수로 표시됨) |