Azure のEvent Hubsの監視

オンラインで編集する

Instana の「 Azure Event Hub 」センサーを使用することで、 Azure のEvent Hubsを監視できます。Event Hubsは、クラウドベースのデータストリーミングサービスであり、低遅延で毎秒数百万件のイベントを処理可能です。

Instana ホストエージェントをインストールすると、 Azure Event Hub センサーが自動的にインストールされ、有効化されます。 「設定 」セクションの手順に従ってセンサーを設定した後、 Instana のUIで、 Azure Event Hub に関連するインフラストラクチャのメトリクスを確認できます。

Azure Event Hubs には、Event Hub クラスターに関連付けられる「クラスター型ネームスペース」と、どのクラスターにも接続されていない「スタンドアロン型ネームスペース」の 2 種類のネームスペースがあります。

Azure Event Hub センサーの設定

オンラインで編集する

Azure Event Hub センサーを設定するには、以下の手順を実行してください：

  1. Instana で「 Azure 」サブスクリプションを有効にしてください。 次の例に示すように、エージェントの設定 <agentinstall_dir>/etc/instana/configuration.yaml ファイルを更新してください：

    com.instana.plugin.azure:
  enabled: true
  subscription: "[Your-Subscription-Id]"
  tenant: "[Your-Tenant-Id]"
  principals:
    - id: "[Your-Service-Principal-Account-Id]"
      secret: "[Your-Service-Principal-Secret]"

    Azure エージェントのインストールに関する詳細については、 「インストール」 を参照してください。

  2. エージェントの設定ファイルで、 Azure Event Hub センサーが有効になっているか確認してください。

    com.instana.plugin.azure.eventhub:
  enabled: true # Valid values: true, false. Enabled (true) by default
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)
  include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)
  exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)
    注： また、[ タグとリソースグループを定義してサービスをフィルタリングする セクション]に記載されている手順に従って、タグやリソースグループを設定することもできます。

タグとリソースグループを定義してサービスをフィルタリングする

オンラインで編集する

ファイル configuration.yaml 内では、カンマで区切ることで複数のタグやリソースグループを定義できます。 タグを定義するには、以下の key:value 形式を使用してください。 タグまたはリソースグループを「含める」リストと「除外する」リストの両方に定義した場合、「除外する」リストが優先されます。 フィルタリングを行わずにすべてのサービスを含めるには、設定を定義しないでください。

  • インクルードリストにタグを設定するには、次の例のようにファイルを configuration.yaml 更新してください：

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

  • 除外リストのタグを設定するには、次の例に示すようにファイルを configuration.yaml 更新してください：

    com.instana.plugin.azure.eventhub:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

  • インクルードリストのリソースグループを設定するには、次の例に示すようにファイルを configuration.yaml 更新してください：

    com.instana.plugin.azure.eventhub:
  include_resource_groups: # Comma separated list of resource groups (e.g. rg_prod,rg_staging)

  • 除外リストのリソースグループを設定するには、次の例に示すようにファイルを configuration.yaml 更新してください：

    com.instana.plugin.azure.eventhub:
  exclude_resource_groups: # Comma separated list of resource groups (e.g. rg_dev,rg_test)
注：Azure Event Hub サービスに対してフィルタを設定した場合、その設定はすべての Azure サービスに共通するフィルタよりも優先されます。 詳細については、 「設定」 を参照してください。

Azure Event Hub センサーを無効にする

オンラインで編集する

Azure Event Hub センサーを無効にするには、次の例に示すようにエージェントの設定 <agentinstall_dir>/etc/instana/configuration.yaml ファイルを更新してください

com.instana.plugin.azure.eventhub:
  enabled: false

メトリックの表示

オンラインで編集する

指標を確認するには、以下の手順に従ってください：

  1. Instana のUIにあるナビゲーションメニューから、 「インフラストラクチャ」 をクリックします。
  2. 監視対象のホストをクリックしてください。 収集されたすべてのメトリクスと監視対象のプロセスが表示されたホストダッシュボードを確認できます。

メトリクスは1分ごとに取得されます。これは、 Azure がこれらのサービスの監視に提供する更新間隔です。

構成データ

オンラインで編集する

次の表は、 Azure Event Hub センサーによって収集される設定データの一覧です：

イベントハブの詳細 説明
名前 Azure Event Hub インスタンスの名前
リソース・グループ リソース・グループの名前
Location リソースが存在する地理的位置
サブスクリプション ID Azure サブスクリプション識別子
作成日 リソース作成時のタイムスタンプ（協定世界時（UTC））
タイプ リソースのタイプ

Event Hub クラスターのパフォーマンス指標

オンラインで編集する

次の表は、Event Hub クラスターのパフォーマンス指標を示しています：

メトリック 名前 ユニット 集約 説明
接続
数 開く 数 最大 Microsoft.EventHub の接続が確立されました
数 アクティブ 数 最大 Microsoft.EventHub のアクティブな接続数
数 クローズ済み 数 最大 Microsoft.EventHub の接続が閉じられました
エラー
数 サーバー 数 最大 Microsoft.EventHub のサーバーエラー
数 ユーザー 数 最大 Microsoft.EventHub のユーザーによる操作ミス
トラフィック
バイト数 IncomingBytes バイト数 合計 Microsoft.EventHub への受信バイト数
バイト数 OutgoingBytes バイト数 合計 Microsoft.EventHub への送信バイト数
要求
数 IncomingRequests 数 合計 Microsoft.EventHub へのリクエスト
数 SuccessfulRequests 数 合計 Microsoft.EventHub へのリクエストが成功しました
数 ThrottledRequests 数 合計 Microsoft.EventHub へのリクエストが制限されています
メッセージ
数 IncomingMessages 数 合計 Microsoft.EventHub 宛ての受信メッセージ
数 OutgoingMessages 数 合計 Microsoft.EventHub 宛ての送信メッセージ
CPU
パーセント CPU パーセント 平均 Event Hub クラスターの CPU 使用率（パーセント）

Event Hub ネームスペースのパフォーマンス指標

オンラインで編集する
注： 名前空間レベルのメトリクス NamespaceCpuUsage および NamespaceMemoryUsage は、プレミアム階層のイベントハブ名前空間でのみ利用可能です。 また、レプリケーションの遅延に関連するメトリクス（ ReplicationLagCount および）は、ジオリカバリが有効化され、正しいレプリカが作成されている ReplicationLagDuration イベントハブのネームスペースでのみ利用可能です。

次の表は、Event Hub ネームスペースのパフォーマンス指標を示しています：

メトリック 名前 ユニット 集約 説明
接続
数 開く 数 最大 Microsoft.EventHub の接続が確立されました
数 アクティブ 数 最大 Microsoft.EventHub のアクティブな接続総数
数 クローズ済み 数 最大 Microsoft.EventHub の接続が閉じられました
エラー
数 サーバー 数 最大 Microsoft.EventHub のサーバーエラー
数 ユーザー 数 最大 Microsoft.EventHub のユーザーによる操作ミス
トラフィック
バイト数 IncomingBytes バイト数 合計 Microsoft.EventHub への受信バイト数
バイト数 OutgoingBytes バイト数 合計 Microsoft.EventHub への送信バイト数
要求
数 IncomingRequests 数 合計 Microsoft.EventHub へのリクエスト
数 SuccessfulRequests 数 合計 Microsoft.EventHub へのリクエストが成功しました
数 ThrottledRequests 数 合計 Microsoft.EventHub へのリクエストが制限されています
メッセージ
数 IncomingMessages 数 合計 Microsoft.EventHub 宛ての受信メッセージ
数 OutgoingMessages 数 合計 Microsoft.EventHub 宛ての送信メッセージ
レプリケーション・ラグ
数 ReplicationLagCount 数 最大 メッセージ数別のレプリケーション遅延
秒 ReplicationLagDuration 秒 最大 期間別のレプリケーション遅延
使用法
パーセント NamespaceCpuUsage パーセント 平均 プレミアムSKUネームスペースのCPU使用率メトリクス
パーセント NamespaceMemoryUsage パーセント 平均 プレミアムSKUネームスペースのメモリ使用量メトリクス