Instana エージェントによる Microsoft® Azure の監視と計測

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

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 https://api.loganalytics.io Analytics エンドポイントへのファイアウォールアクセスが許可されていることを確認してください。

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

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

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

Azure Monitor API エンドポイントは通常、このパターンを使用します： https://{managementendpoint}/subscriptions/{subscriptionId}/providers/Microsoft.Insights/...

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

Azure ポータルを利用することにより：

1. Azure ポータルで、 [すべてのサービス ] > [一般 ] > [サブスクリプション ] を選択します。
2. サブスクリプションページで、サブスクリプションを選択し、 アクセスコントロール（IAM ）を選択します。
3. 「ロールの割り当てを追加」 を選択し、「 閲覧者」 を選択します。 次へ をクリックします。
4. メンバー セクションでは、以下の詳細を入力してください：
   • Assign access to で、 user、 group、または service principal を選択します。
   • メンバー の場合は、 「メンバーの選択」 をクリックし、左側のリストからサービスプリンシパルを選択してください。
5. Nextをクリックし、 Review + assignを選択する。

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"

ホストエージェントを再起動して、新しい設定を適用します。 再起動後、エージェントは指定されたサブスクリプション上でサポートされているリモートサービスを自動的に検出できます。

プロキシを使用するように 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:
 

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

Azure 監視 API にはサービスプリンシパルごとの 12000 リクエスト数に制限があり、これにより単一のホストエージェントが監視できるサービスの数が制限されます。 この制限を克服するため、複数のサービス・プリンシパルを作成できます。 サービス・プリンシパルの作成方法については、 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"
 

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

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 を優先します。