AWS Kinesis のモニター
「 Instana 」エージェントをインストールすると、「 AWS Kinesis 」センサーが自動的に展開およびインストールされます。
補足情報
クライアントサイドのトレースに対応
センサー (データ収集)
追跡対象の構成
- Kinesis データ・ストリームのインスタンスの詳細
- ストリーム名
- ストリーム ARN
- ストリーム状況
- ストリームの暗号化タイプ
- ストリーム保存期間 (時間)
- ストリーム作成時刻
- AWS グループ化ゾーン
必要なアクセス権
cloudwatch:GetMetricDatakinesis:ListStreamskinesis:DescribeStreamkinesis: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 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>'
フィルタリング
複数のタグを定義するには、コンマで区切ります。 タグは、以下で区切られたキーと値のペアとして指定されます。設定を簡単にするため、ディスカバリに含めるタグや除外するタグを定義することができます。 両方のリスト (包含と除外) にタグを定義すると、除外リストの優先順位が高くなります。 サービスをフィルタリングする必要がない場合は、構成を定義しないでください。 フィルタリングを有効にするためにすべての値を定義する必要はありません。
ユーザーは、tagged-services-poll-rate構成プロパティーを使用する AWS タグ付きリソースをセンサーがポーリングする頻度を指定できます (デフォルトは 300 秒)。
タグ付きリソースをセンサーがポーリングする頻度を定義するには、以下の構成を使用します。
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
Instana エージェント・タグ
なお、タグ機能は AWS エージェントでのみ利用可能です。 タグの使用方法の詳細については、こちらをご覧ください。