Amazon MSK 모니터링
Instana 에이전트를 설치하면 Amazon MSK 센서가 자동으로 배포 및 설치됩니다.
센서 (데이터 수집)
MSK 브로커 - 지표 수집
추적된 구성
| MSK 인스턴스 세부사항 | 설명 |
|---|---|
| ID | 특정 MSK 인스턴스의 ID입니다. |
| ARN | 인스턴스에 지정된 규정되지 않은 Amazon 자원 이름 (ARN) 입니다. |
| 유형 | MSK 인스턴스 유형입니다. |
| 인스턴스 유형 | 인스턴스 티어 유형입니다. |
| 클러스터에 추가됨 | 브로커가 클러스터에 추가된 시간입니다. |
성능 매트릭
| 성능 메트릭 | 설명 |
|---|---|
| 파티션 | 파티션 수입니다. |
| 복제가 완료되지 않은 파티션 수 | 복제가 적은 파티션 수입니다. |
메트릭
| 브로커 지표 | 설명 | 모니터링 레벨 |
|---|---|---|
| 리더 수 | 복제본을 포함하지 않은 브로커당 파티션 리더의 총 수입니다. | DEFAULT |
| 수신 바이트 | 클라이언트에서 받은 초당 바이트 수입니다. 이 지표는 브로커 및 주제별로 사용 가능합니다. | DEFAULT |
| 보낸 바이트 | 클라이언트에 보낸 초당 바이트 수입니다. 이 지표는 브로커 및 주제별로 사용 가능합니다. | DEFAULT |
| 수신 메시지 | 브로커의 초당 수신 메시지 수입니다. | DEFAULT |
| 요청 바이트 | 브로커의 평균 요청 바이트 수입니다. | DEFAULT |
| CPU 유휴 | CPU 유휴 시간의 백분율입니다. | DEFAULT |
| CPU 사용자 | 사용자 공간의 CPU 백분율입니다. | DEFAULT |
| CPU 시스템 | 커널 공간의 CPU 백분율입니다. | DEFAULT |
| 사용 가능한 메모리 | 브로커에 사용 가능하고 사용 가능한 메모리의 크기 (바이트) 입니다. | DEFAULT |
| 사용된 메모리 | 브로커에 사용 중인 메모리의 크기 (바이트) 입니다. | DEFAULT |
| 캐시된 메모리 | 브로커에 대한 캐시된 메모리의 크기 (바이트) 입니다. | DEFAULT |
| 버퍼로 지정된 메모리 | 브로커의 버퍼링된 메모리 크기 (바이트) 입니다. | DEFAULT |
| 스왑 사용 가능 | 브로커에 사용 가능한 스왑 메모리의 크기 (바이트) 입니다. | DEFAULT |
| 스왑 사용 | 브로커에 사용 중인 스왑 메모리의 크기 (바이트) 입니다. | DEFAULT |
| 네트워크 Rx 수신 | 브로커가 받은 패킷 수입니다. | DEFAULT |
| 네트워크 Rx 삭제됨 | 삭제된 수신 패키지 수입니다. | DEFAULT |
| 네트워크 Rx 오류 | 브로커의 네트워크 수신 오류 수입니다. | DEFAULT |
| 전송된 네트워크 Tx | 브로커가 전송한 패킷 수입니다. | DEFAULT |
| 네트워크 Rx 삭제됨 | 삭제된 전송 패키지 수입니다. | DEFAULT |
| 네트워크 Rx 오류 | 브로커의 네트워크 전송 오류 수입니다. | DEFAULT |
| 생성 시간 | 평균 생성 시간 (밀리초) 입니다. | PER_BROKER |
| 조절 시간 생성 | 평균 생성 조절 시간 (밀리초) 입니다. | PER_BROKER |
| 조절 시간 페치 | 평균 페치 조절 시간 (밀리초) 입니다. | PER_BROKER |
| 조절 시간 요청 | 평균 요청 조절 시간 (밀리초) 입니다. | PER_BROKER |
| 조절 바이트 비율 생성 | 초당 조절된 바이트 수입니다. | PER_BROKER |
| 조절 바이트 비율 페치 | 초당 조절된 바이트 수입니다. | PER_BROKER |
| 이용자 페치 시간 | 이용자가 브로커에서 데이터를 페치하는 데 소비하는 평균 총 시간 (밀리초) 입니다. | PER_BROKER |
| 팔로워 페치 시간 | 팔로워가 브로커에서 데이터를 페치하는 데 소요하는 평균 총 시간 (밀리초) 입니다. | PER_BROKER |
| 네트워크 유휴 시간 | 네트워크 프로세서가 유휴 상태인 시간의 평균 백분율입니다. | PER_BROKER |
| 요청 유휴 시간 | 요청 핸들러 스레드가 유휴 상태인 시간의 평균 백분율입니다. | PER_BROKER |
MSK 클러스터 - 메트릭 수집
추적된 구성
| MSK 클러스터 세부사항 | 설명 |
|---|---|
| 이름 | MSK 클러스터의 이름입니다. |
| ARN | 인스턴스에 지정된 규정되지 않은 Amazon 자원 이름 (ARN) 입니다. |
| 모니터링 강화 | 모니터링 레벨. |
| Kafka 버전 | Kafka 인스턴스의 버전입니다. |
성능 매트릭
| 성능 메트릭 | 설명 |
|---|---|
| 활성 컨트롤러 | 활성 제어기의 수입니다. |
| 토픽 | 주제 수입니다. |
메트릭
| 브로커 지표 | 설명 | 모니터링 레벨 |
|---|---|---|
| 파티션 수 | 총 파티션 수입니다. | DEFAULT |
| 오프라인 파티션 | 오프라인 파티션의 총 수입니다. | DEFAULT |
| 사용된 디스크 | 디스크 공간 사용량입니다. | DEFAULT |
필수 권한
cloudwatch:GetMetricDatacloudwatch:GetMetricStatisticskafka:ListClusterskafka:ListNodeskafka:ListTagsForResourcekafka:DescribeCluster
알려진 제한사항
Amazon MSK 센서는 프로비저닝된 MSK 클러스터 유형에 대한 모니터링만 지원합니다. 서버리스 클러스터 유형은 지원되지 않습니다.
구성
Amazon MSK에 대한 지표는 5분마다 가져옵니다. 이는 에이전트 구성 (<agent_install_dir>/etc/instana/configuration.yaml) 을 통해 변경할 수 있습니다.
com.instana.plugin.aws.msk:
cloudwatch_period: 300
MSK 인스턴스의 모니터링을 사용 안함으로 설정하려면 다음 구성을 사용하십시오.
com.instana.plugin.aws.msk:
enabled: false
프록시 구성
프록시 구성을 사용하도록 특정 AWS 센서를 구성하려면 다음 에이전트 구성 설정을 추가하십시오.
com.instana.plugin.aws.msk:
proxy_host: 'example.com' # proxy host name or ip address
proxy_port: 3128 # proxy port
proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
proxy_username: 'username' # OPTIONAL: proxy username
proxy_password: 'password' # OPTIONAL: proxy password
여러 AWS 계정 모니터링
동일한 지역에 있는 하나의 AWS 에이전트를 사용하여 여러 AWS 계정의 모니터링을 설정하려면 여러 AWS 계정 모니터링 문서를 참조하십시오.
AWS 명명된 프로필 방식
MSK를 모니터하는 데 사용해야 하는 프로파일을 대체하려면 다음 구성을 사용하십시오.
com.instana.plugin.aws.msk:
profile_names:
- 'profile2'
- 'profile3'
AWS STS 접근법
MSK를 모니터하는 데 사용해야 하는 IAM 역할을 대체하려면 다음 구성을 사용하십시오.
com.instana.plugin.aws.msk:
role_arns:
- 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
- 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
필터링
여러 태그를 쉼표로 구분하여 정의할 수 있습니다. 태그는: 로 구분된 키-값 쌍으로 제공되어야 합니다. 구성을 더 쉽게 하기 위해 감지에 포함하거나 감지에서 제외할 태그를 정의할 수 있습니다. 두 목록 (include및 exclude) 에서 태그를 정의하는 경우 제외 목록의 우선순위가 더 높습니다. 서비스 필터링이 필요하지 않은 경우 구성을 정의하지 않아야 합니다. 필터링을 사용하기 위해 모든 값을 반드시 정의할 필요는 없습니다.
사용자는 센서가 tagged-services-poll-rate 구성 특성 (기본값은 300초) 을 사용하여 AWS 태그 지정된 자원을 폴링하는 빈도를 지정할 수 있습니다.
센서가 태그 지정된 자원을 폴링하는 빈도를 정의하려면 다음 구성을 사용하십시오.
com.instana.plugin.aws:
tagged-services-poll-rate: 60 #default 300
태그별 서비스를 감지에 포함시키려면 다음 구성을 사용하십시오.
com.instana.plugin.aws.msk:
include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
발견에서 태그별 서비스를 제외하려면 다음 구성을 사용하십시오.
com.instana.plugin.aws.msk:
exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
태그가 없는 AWS 서비스는 기본적으로 모니터되지만 include_untagged 필드를 false로 설정하여 제외할 수 있습니다.
com.instana.plugin.aws.beanstalk:
include_untagged: false # True value by default