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 アカウントのモニター

同じリージョン内の 1 つの 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構成プロパティーを使用する AWS タグ付きリソースをセンサーがポーリングする頻度を指定できます (デフォルトは 300 秒)。

注: タグは、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