AWS Kinesis 모니터링

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

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

센서 (데이터 수집)

추적된 구성

  • Kinesis 데이터 스트림 인스턴스 세부사항
    • 스트림 이름
    • 스트림 ARN
    • 스트림 상태
    • 스트림 암호화 유형
    • 스트림 보존 기간 (시간)
    • 스트림 작성 시간
    • AWS 그룹화 구역

필수 권한

  • cloudwatch:GetMetricData
  • kinesis:ListStreams
  • kinesis:DescribeStream
  • kinesis:ListTagsForStream

구성

Kinesis에 대한 메트릭은 5분마다 가져옵니다. 이 메트릭은 <agent_install_dir>/etc/instana/configuration.yml의 에이전트 구성을 통해 변경할 수 있습니다.

com.instana.plugin.aws.kinesis:
  cloudwatch_period: 300

Kinesis 스트림의 모니터링을 사용하지 않으려면 다음 구성을 사용하십시오.

com.instana.plugin.aws.kinesis:
  enabled: false

프록시 구성

프록시 구성을 사용하도록 특정 AWS 센서를 구성하려면 다음 에이전트 구성 설정을 추가하십시오.

com.instana.plugin.aws.kinesis:
  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 명명된 프로필 방식

Kinesis를 모니터하는 데 사용할 수 있는 프로파일을 대체하려면 다음 구성을 사용하십시오.

com.instana.plugin.aws.kinesis:
  profile_names:
    - 'profile2'
    - 'profile3'
참고: 서비스 수준에서 프로필을 정의하면 전역 AWS 프로필 설정이 무시됩니다.

AWS STS 접근법

Kinesis를 모니터하는 데 사용되는 IAM 역할을 대체하려면 다음 구성을 사용하십시오.

com.instana.plugin.aws.kinesis:
  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 역할 구성이 무시됩니다.

필터링

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

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

참고: 태그 기능은 AWS 에이전트 에서만 사용할 수 있습니다.

센서가 태그 지정된 자원을 폴링하는 빈도를 정의하려면 다음 구성을 사용하십시오.

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

태그별 서비스를 감지에 포함시키려면 다음 구성을 사용하십시오.

com.instana.plugin.aws.kinesis:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

발견에서 태그별 서비스를 제외하려면 다음 구성을 사용하십시오.

com.instana.plugin.aws.kinesis:
  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.kinesis:
  include_untagged: false # True value by default