AWS Kinesis¶

스크립트 마켓의 「Guance 클라우드 동기화」 시리즈 스크립트 패키지를 사용하여 클라우드 모니터링 및 클라우드 자산 데이터를 Guance로 동기화합니다

설정¶

Func 설치¶

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

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

스크립트 설치¶

안내: 요구 사항에 맞는 Amazon AK를 미리 준비해 두세요. (간단히 하려면 전역 읽기 전용 권한 ReadOnlyAccess를 직접 부여할 수 있습니다)

관리형 버전 스크립트 개통¶

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

수동으로 스크립트 개통¶

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

검증¶

「관리 / 자동 트리거 설정」에서 해당 작업의 자동 트리거 설정이 존재하는지 확인하고, 동시에 해당 작업 기록과 로그를 확인하여 이상이 있는지 점검합니다
Guance의 「인프라 / 사용자 지정」에서 자산 정보가 있는지 확인합니다
Guance의 「지표」에서 해당 모니터링 데이터가 있는지 확인합니다

지표¶

Amazon CloudWatch가 설정되어 있으면 기본 지표 집합은 다음과 같습니다. 설정을 통해 더 많은 지표를 수집할 수 있습니다. Amazon CloudWatch 지표 상세

인스턴스 지표¶

AWS/Kinesis 네임스페이스에는 다음 인스턴스 지표가 포함됩니다.

지표	설명
`IncomingBytes`	지정된 기간 동안 Kinesis 스트림에 성공적으로 전달된 바이트 수입니다. 이 지표에는 `PutRecord`와 `PutRecords`의 바이트 수가 포함됩니다. `Minimum`, `Maximum`, `Average` 통계는 지정된 기간 동안 스트림의 단일 put 작업에서 전송된 바이트 수를 나타냅니다. 샤드 수준 지표 이름: `IncomingBytes`. 차원: `StreamName`. 단위: 바이트
`IncomingRecords`	지정된 기간 동안 Kinesis 스트림에 성공적으로 전달된 레코드 수입니다. 이 지표에는 `PutRecord`와 `PutRecords`의 레코드 수가 포함됩니다. `Minimum`, `Maximum`, `Average` 통계는 지정된 기간 동안 스트림의 단일 put 작업에서 전송된 레코드 수를 나타냅니다. 샤드 수준 지표 이름: `IncomingRecords`. 차원: `StreamName`. 단위: 개수
`WriteProvisionedThroughputExceeded`	지정된 기간 동안 스트림 제한으로 인해 거부된 레코드 수입니다. 이 지표에는 `PutRecord`와 `PutRecords` 작업의 제한이 포함됩니다. 이 지표에서 가장 자주 사용하는 통계는 `Average`입니다. 통계 `Minimum` 값이 0이 아니면 해당 기간 동안 스트림의 레코드가 제한되었음을 의미합니다. 통계 `Maximum` 값이 0이면 해당 기간 동안 스트림의 어떤 레코드도 제한되지 않았음을 의미합니다. 샤드 수준 지표 이름: `WriteProvisionedThroughputExceeded`. 차원: `StreamName`. 단위: 개수
`PutRecords.Bytes`	지정된 시간 동안 `PutRecords`를 사용하여 Kinesis 스트림에 전달된 바이트 수입니다. 차원: `StreamName`. 단위: 바이트
`PutRecords.Success`	지정된 기간 동안 측정된 각 Kinesis 스트림에서 하나 이상의 레코드가 성공한 `PutRecords` 작업 수입니다. 차원: `StreamName`. 단위: 개수
`PutRecords.Latency`	지정된 기간 동안 측정된 각 `PutRecords` 작업에 걸린 시간입니다. 차원: `StreamName`. 단위: 밀리초
`PutRecords.FailedRecords`	내부 오류로 인해 거부된 레코드 수입니다. 지정된 기간 동안 측정된 각 Kinesis 데이터 스트림의 `PutRecords` 작업 수입니다. 간헐적으로 내부 오류가 발생할 수 있으며, 다시 시도해야 합니다. 차원: `StreamName`. 단위: 개수
`PutRecords.ThrottledRecords`	제한이 있어 거부된 레코드 수입니다. 지정된 기간 동안 측정된 각 Kinesis 데이터 스트림의 `PutRecords` 작업 수입니다. 차원: `StreamName`. 단위: 개수
`utRecords.TotalRecords`	지정된 기간 동안 측정된 각 Kinesis 데이터 스트림의 `PutRecords` 작업 수입니다. 차원: `StreamName`. 단위: 개수
## 객체

수집된 AWS Kinesis 객체 데이터 구조로, 「인프라-사용자 지정」에서 객체 데이터를 확인할 수 있습니다

{
  "measurement": "aws_kinesis",
  "tags": {
    "class"          : "aws_kinesis",
    "cloud_provider" : "aws",
    "create_time"    : "2023/08/07 14:29:19",
    "date"           : "2023/08/07 14:29:19",
    "date_ns"        :"0",
    "EncryptionType" :"NONE",
    "HasMoreShards"  :"false",
    "name"           :"zsh_test",
    "RegionId"      :"cn-northwest-1",
    "RetentionPeriodHours":"24",
    "StreamARN":"arn:aws-cn:kinesis:cn-northwest-1:294654068288:stream/zsh_test",
    "StreamName":"zsh_test",
    "StreamStatus":"ACTIVE"
  }
}

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

안내 1: name 값은 인스턴스명이며, 고유 식별자로 사용됩니다