Amazon MSK のモニター
Instana エージェントをインストールすると、Amazon MSKセンサーが自動的にデプロイおよびインストールされます。
センサー (データ収集)
MSK ブローカー - メトリック収集
追跡対象の構成
| MSK インスタンスの詳細 | 説明 |
|---|---|
| ID | 特定の MSK インスタンスの ID。 |
| ARN | インスタンスに割り当てられている非修飾の Amazon リソース・ネーム (ARN)。 |
| タイプ | MSK インスタンスのタイプ。 |
| インスタンス・タイプ | インスタンス・ティアのタイプ。 |
| クラスターに追加 | ブローカーがクラスターに追加された時刻。 |
パフォーマンス・メトリック
| パフォーマンス・メトリック | 説明 |
|---|---|
| パーティション | パーティション数。 |
| レプリカ生成不足のパーティション数 | レプリカ生成不足パーティションの数。 |
メトリック
| ブローカーのメトリック | 説明 | モニタリング・レベル |
|---|---|---|
| リーダー数 | ブローカー当たりのパーティションのリーダーの合計数 (レプリカは含みません)。 | DEFAULT |
| 着信バイト | 1 秒間にクライアントから受信したバイト数。 このメトリックはブローカー当たりおよびトピック当たりで使用可能です。 | DEFAULT |
| 発信バイト | 1 秒間にクライアントに送信されたバイト数。 このメトリックはブローカー当たりおよびトピック当たりで使用可能です。 | DEFAULT |
| 着信メッセージ | ブローカーの着信メッセージの数 (1 秒当たり)。 | DEFAULT |
| 要求バイト数 | ブローカーの要求バイトの平均数。 | DEFAULT |
| CPU アイドル | CPU アイドル時間のパーセンテージ。 | DEFAULT |
| CPU ユーザー | ユーザー・スペースで費やされた CPU のパーセンテージ。 | DEFAULT |
| CPU システム | カーネル・スペースで費やされた CPU のパーセンテージ。 | DEFAULT |
| 空きメモリー | 空いていてブローカーが使用可能なメモリーのサイズ (バイト)。 | DEFAULT |
| 使用メモリー | ブローカーが使用中のメモリーのサイズ (バイト)。 | DEFAULT |
| キャッシュされたメモリー | ブローカーによってキャッシュに入れられたメモリーのサイズ (バイト)。 | DEFAULT |
| バッファーされたメモリー | ブローカーによってバッファーに入れられたメモリーのサイズ (バイト)。 | DEFAULT |
| 空きスワップ | ブローカーが使用可能なスワップ・メモリーのサイズ (バイト) | DEFAULT |
| 使用済みスワップ | ブローカーが使用中のスワップ・メモリーのサイズ (バイト)。 | DEFAULT |
| 受信したネットワーク受信パケット数 | ブローカーが受信したパケットの数。 | DEFAULT |
| 除去されたネットワーク受信パケット数 | 除去された受信パッケージの数。 | DEFAULT |
| ネットワーク受信パケットのエラー数 | ブローカーのネットワーク受信エラーの数。 | DEFAULT |
| 送信されたネットワーク送信パケット数 | ブローカーが送信したパケットの数。 | DEFAULT |
| 除去されたネットワーク受信パケット数 | 除去された送信パッケージの数。 | DEFAULT |
| ネットワーク受信パケットのエラー数 | ブローカーのネットワーク送信エラーの数。 | DEFAULT |
| 生成時間 | 平均生成時間 (ミリ秒)。 | PER_BROKER |
| 生成スロットル時間 | 平均生成スロットル時間 (ミリ秒) | PER_BROKER |
| フェッチ・スロットル時間 | 平均フェッチ・スロットル時間 (ミリ秒) | PER_BROKER |
| 要求スロットル時間 | 平均要求スロットル時間 (ミリ秒) | PER_BROKER |
| 生成スロットル・バイト・レート | 1 秒間にスロットルされたバイトの数。 | PER_BROKER |
| フェッチ・スロットル・バイト・レート | 1 秒間にスロットルされたバイトの数。 | 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 アカウントのモニター
同じリージョン内の 1 つの 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>'
フィルタリング
複数のタグを定義するには、コンマで区切ります。 タグは、「:」で区切られたキーと値のペアとして指定する必要があります。 構成を容易にするために、ディスカバリーに含めるタグを定義することも、ディスカバリーから除外するタグを定義することもできます。 両方のリスト (包含および除外) でタグを定義する場合は、除外リストの優先順位が高くなります。 サービスのフィルタリングが不要な場合は、構成を定義しないでください。 フィルタリングを有効にするためにすべての値を定義する必要はありません。
ユーザーは、tagged-services-poll-rate 構成プロパティーを使用して、センサーが AWS タグ付きリソースをポーリングする頻度 (デフォルトは 300 秒) を指定できます。
センサーがタグ付きリソースをポーリングする頻度を定義するには、以下の構成を使用します。
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
Instana エージェント・タグ
タグは、 AWS エージェントと一緒にのみ使用できます。 タグの使用方法の詳細については、こちらをご覧ください。