Instana エージェントを使用した Microsoft® Azure の監視と計測

Microsoft® Azure センサーのサポートされているオペレーティング システムは、ホスト エージェントの要件と一致しています。 詳細については、各 Instana ホストエージェントの対応 OSをご確認ください。

Azure のセンサーバージョンによって、サブスクリプションの監視機能が決定されます：

Instana エージェントを Azure 環境の外にインストールした場合、エージェントはデフォルトで Azure のパブリッククラウドエンドポイントを使用します。

使用する Azure クラウドエンドポイントを指定するには、/opt/instana/agent/etc/instana/configuration.yaml エージェント設定ファイルを次のように変更します：

com.instana.plugin.azure:
  cloud: 'AzurePublicCloud'

使用する Azure クラウドエンドポイントに応じて、以下のクラウド設定値から選択できます： AzurePublicCloud、 AzureChinaCloud、 AzureUSGovernmentCloud、および AzureGermanCloud。 Azure のクラウドエンドポイントに関する詳細については、 「 Azure のクラウドエンドポイント」 をご覧ください。

選択した Azure クラウド環境について、以下のネットワークエンドポイントにアクセスできることを確認してください：

Azure サービスの外部からの監視を有効にするには、お使いの Azure クラウド環境に応じて、ファイアウォールを設定し、上記の REST API エンドポイントへのアクセスを許可してください。 また、 Azure のクラウドエンドポイントの有無にかかわらず、主にDatabricksで必要となるLog Analyticsエンドポイントへのファイアウォールアクセスが許可されていることを確認 https://api.loganalytics.ioしてください。

Azure Resource Manager (ARM) API : Instana は、ARM API を使用して、サブスクリプション内の Azure リソースを検出し、名前、タイプ、場所、タグなどの構成詳細を収集します。 Instana また、これらの詳細情報を利用して、リソース同士がどのように関連しているかを把握します。

ARMの API エンドポイントは、通常、次のようなパターンを使用します： https://{managementendpoint}/subscriptions/{subscriptionId}/...

Azure API の監視 : Instana は、ARM 管理エンドポイントを共有する Azure Monitor API を使用して、 Azure リソースに関するメトリクス、ログ、ヘルス情報などの監視データを収集します。

Azure API のエンドポイントの監視では、通常、次のようなパターンが使用されます： https://{managementendpoint}/subscriptions/{subscriptionId}/providers/Microsoft.Insights/...

Azure の監視を有効にするには、少なくとも「reader」権限を持つサービスプリンシパルを使用してホストエージェントを設定してください。 サービスプリンシパルは、 Azure ポータル、 Azure CLI、または Azure PowerShell を使用して作成できます。

Azure ポータルを利用することで：

1. Azure ポータルで、 「すべてのサービス 」>「 一般 」>「 サブスクリプション」 を選択します。
2. サブスクリプションページで、サブスクリプションを選択し、アクセスコントロール（IAM）を選択します。
3. 「 役割の割り当てを追加 」を選択し、「 閲覧者」 を選びます。 次へ をクリックします。
4. 「 会員 」セクションで、以下の情報を入力してください：
   • アクセス権の割り当てでは、user、group、service principalのいずれかを選択します。
   • 「メンバー」 の場合、 「メンバーの選択」 をクリックし、左側のリストからサービスプリンシパルを選択してください。
5. 次へをクリックし、レビュー+割り当てを選択します。

Azure CLI を使用して：

az ad sp create-for-rbac --name "<service-principal-name>" --role "Reader" --scopes /subscriptions/{subscription-id}

Python スクリプトを使用してサービスプリンシパルのリーダーロールを確認するには（オプション）、 Python スクリプトを参照してください。

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 Resource Manager (ARM) はトークンバケット方式のスロットリングモデルを採用しており、持続的な補充レート（毎秒25リクエスト）を維持しつつ、短時間のリクエスト集中（例えば、250回の読み取り）を許容します。 Instana の Azure モニタリングは、サブスクリプション全体にわたってメトリクスやリソースデータを収集するため、特に大規模な環境では、 API へのリクエスト数が非常に多くなる可能性があります。 この制限を克服するため、複数のサービス・プリンシパルを作成できます。 サービスプリンシパルの作成方法については、 「 Azure PowerShell を使用して証明書付きのサービスプリンシパルを作成する」 を参照してください。

サービスプリンシパルを作成したら、 Instana/opt/instana/agent/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-1"
      secret: "Your-Base64-encoded-Service-Principal-Secret-1"
    - id: "Your-Service-Principal-Account-Id-2"
      secret: "Your-Base64-encoded-Service-Principal-Secret-2"

Instana のホストエージェントでプロキシを使用するように設定するには、エージェントの設定に以下の設定を追加します

com.instana.plugin.azure:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password
 

proxy_hostとproxy_portの両方のフィールドを定義して、エージェントがプロキシサーバーを経由してトラフィックをルーティングできるようにします。

プロキシの設定が完了したら、変更を反映させるために Instana エージェントを再起動してください。

Instana のホストエージェントは、 Azure サービスのフィルタリングに対応しています。 サービスとそのインスタンスのフィルタリングは、タグとリソースグループに基づいて行われる。

Azure リソースへのタグの付け方に関する詳細については、 「タグを使用して Azure リソースと管理階層を整理する」 を参照してください。

Azure でのリソースグループの定義に関する詳細については、 「 Azure とは Resource Manager? 」を参照してください。

Instana のホストエージェント設定ファイルを次のように変更して、 /opt/instana/agent/etc/instana/configuration.yaml フィルタリングを適用します：

com.instana.plugin.azure:
  # Comma separated list of tags in key:value format
  include_tags:
  # Comma separated list of tags in key:value format
  exclude_tags:
  # Comma separated list of resource groups
  include_resource_groups:
  # Comma separated list of resource groups
  exclude_resource_groups:
 

また、特定のサービスレベルでフィルタリングを適用することもできる。 詳細については、監視対象サービスセクションを参照してください。

1つのAPI Managementサービスの下にあまりにも多くのAPIがあると、データを効果的に収集して分析することが難しくなります。 重要なAPIに焦点を当てるには、以下の例に示すように、包含型または除外型の正規表現を定義して、 API のフィルタリングを設定します。 YAML ファイル：

com.instana.plugin.azure.apimanagement:
  monitorApiList:
    - serviceName: 'robotShopApiGateway'
      #inclusiveApiRegex: '^(API name 1|API name 2)$'
      exclusiveApiRegex: '^(API name 1|API name 2)$'
 

前の例で示したように、orとandのロジックで複雑な正規表現を使うことができます。 inclusiveApiRegexとexclusiveApiRegexの両方を定義した場合、ホストエージェントはexclusiveApiRegexを優先します。

非常に多数のリソースを監視するには、 1つのエージェントにつき複数のサブスクリプションを設定するか、それぞれに1つのサブスクリプションを設定した複数のエージェントを展開することができます。 いずれの場合も、サブスクリプションがエージェント間で共有されないよう、また相互に排他的な状態が保たれるようにしてください。

• すべてのサブスクリプションは、同じ Azure テナントに属している必要があります。
• 各サブスクリプションには、Reader ロールの権限を持つサービスプリンシパルが少なくとも 1 つ必要です。

複数の Azure サブスクリプションを監視するには、 Instana ホストエージェントを構成し、ファイル /opt/instana/agent/etc/instana/configuration.yaml にサブスクリプションとサービスプリンシパルの詳細を指定します：

com.instana.plugin.azure:
  enabled: true
  tenant: 'Your-Tenant-Id'
  subscriptions:
    - id: 'Subscription-Id-1'
      principals:
        - id: 'Service-Principal-Client-Id-1'
          secret: 'Service-Principal-Client-Secret-1'
        - id: 'Service-Principal-Client-Id-2'
          secret: 'Service-Principal-Client-Secret-2'
    - id: 'Subscription-Id-2'
      principals:
        - id: 'Service-Principal-Client-Id-3'
          secret: 'Service-Principal-Client-Secret-3'
        - id: 'Service-Principal-Client-Id-4'
          secret: 'Service-Principal-Client-Secret-4'

各サブスクリプションには、 API の負荷を分散させるために、複数のサービスプリンシパルを設定できます。

• サービスプリンシパルの計画 ：多数のリソースを監視する際にスロットリングが発生しないよう、サブスクリプションごとに少なくとも2～3つのサービスプリンシパルを作成してください。
• リソースの分散 ：多数のリソースを監視する場合は、『 Azure 』のドキュメントに記載されているように、複数のサブスクリプションや異なるリージョンにリソースを分散させることを検討してください。
• 必要な権限 ：各サービスプリンシパルが、サブスクリプションに対して少なくとも「リーダー」ロールのアクセス権を持っていることを確認してください。 API クライアントの設定時、必要な権限を持たないサービスプリンシパルはスキップされます。

以下の注意事項は、合成 Azure リソースを監視する際の Instana エージェントの検証済みパフォーマンス限界についてまとめたものです。 これらの結果は、安定した運用における安全限界を特定するために、 Ubuntu （ 24.04 ）で行われたストレステストに基づいています。