Amazon MSK のモニター

Instana エージェントをインストールすると、Amazon MSKセンサーが自動的にデプロイおよびインストールされます。

注: その他のサポート対象の AWS サービスについては、「 AWS 」のドキュメントをご覧ください。

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

同じリージョン内の 1 つの 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ロール設定が上書きされます。

フィルタリング

複数のタグを定義するには、コンマで区切ります。 タグは、「:」で区切られたキーと値のペアとして指定する必要があります。 構成を容易にするために、ディスカバリーに含めるタグを定義することも、ディスカバリーから除外するタグを定義することもできます。 両方のリスト (包含および除外) でタグを定義する場合は、除外リストの優先順位が高くなります。 サービスのフィルタリングが不要な場合は、構成を定義しないでください。 フィルタリングを有効にするためにすべての値を定義する必要はありません。

ユーザーは、tagged-services-poll-rate 構成プロパティーを使用して、センサーが AWS タグ付きリソースをポーリングする頻度 (デフォルトは 300 秒) を指定できます。

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