Amazon MSK 모니터링

Instana 에이전트를 설치하면 Amazon MSK 센서가 자동으로 배포 및 설치됩니다.

참고: AWS 문서를 통해 지원되는 다른 AWS 서비스에 대해 알아보세요.

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:GetMetricData
  • cloudwatch:GetMetricStatistics
  • kafka:ListClusters
  • kafka:ListNodes
  • kafka:ListTagsForResource
  • kafka: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 프로필 설정이 무시됩니다.

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>'
참고: 서비스 수준에서 IAM 역할을 정의하면 전역 AWS IAM 역할 구성이 재정의됩니다.

필터링

여러 태그를 쉼표로 구분하여 정의할 수 있습니다. 태그는: 로 구분된 키-값 쌍으로 제공되어야 합니다. 구성을 더 쉽게 하기 위해 감지에 포함하거나 감지에서 제외할 태그를 정의할 수 있습니다. 두 목록 (include및 exclude) 에서 태그를 정의하는 경우 제외 목록의 우선순위가 더 높습니다. 서비스 필터링이 필요하지 않은 경우 구성을 정의하지 않아야 합니다. 필터링을 사용하기 위해 모든 값을 반드시 정의할 필요는 없습니다.

사용자는 센서가 tagged-services-poll-rate 구성 특성 (기본값은 300초) 을 사용하여 AWS 태그 지정된 자원을 폴링하는 빈도를 지정할 수 있습니다.

참고: 태그는 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