Azure Monitor メトリックストアの従来の Cloud Services にゲスト OS メトリックを送信する

[アーティクル]
01/08/2024

Note

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。作業を開始するには、Azure PowerShell のインストールに関する記事を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

Azure Monitor 診断拡張機能を使用すると、仮想マシン、クラウドサービス、または Service Fabric クラスターの一部として、ゲストオペレーティングシステム (ゲスト OS) からメトリックとログを収集できます。拡張機能により、多くの異なる場所にテレメトリを送信できます。

この記事では、従来の Azure Cloud Services 用のゲスト OS のパフォーマンスメトリックを Azure Monitor メトリックストアに送信するプロセスについて説明します。診断拡張機能バージョン 1.11 以降、標準プラットフォームメトリックが既に収集されている Azure Monitor メトリックストアに、メトリックを直接書き込むことができます。

この場所にこれらを格納することで、プラットフォームメトリックに対して使用できるのと同じアクションにアクセスできます。アクションには、ほぼリアルタイムのアラート、グラフ作成、ルーティング、REST API からのアクセスなどの機能があります。これまで、診断拡張機能では、Azure Monitor データストアではなく Azure Storage に書き込んでいました。

この記事で説明されているプロセスは、Azure Cloud Services でのパフォーマンスカウンターに対してのみ機能します。他のカスタムメトリックに対しては機能しません。

前提条件

Azure サブスクリプションで、サービス管理者または共同管理者である必要があります。
サブスクリプションを Microsoft.Insights に登録する必要があります
Azure PowerShell または Azure Cloud Shell がインストールされている必要があります。

クラウドサービスとストレージアカウントのプロビジョニング

従来のクラウドサービスを作成し、デプロイします。従来の Cloud Services アプリケーションとデプロイのサンプルは、「Azure Cloud Services と ASP.NET を使ってみる」に示されています。
既存のストレージアカウントを使用できるか、新しいストレージアカウントを配置できます。ストレージアカウントが、作成した従来のクラウドサービスと同じ領域にある場合は最適です。 Azure portal で、[ストレージアカウント] リソースペインに移動し、[キー] を選択します。ストレージアカウント名とストレージアカウントキーをメモしておきます。この情報は後続の手順で必要になります。

サービスプリンシパルの作成

「ポータルを使用したリソースにアクセスできる Microsoft Entra アプリケーションとサービスプリンシパルの作成」の手順を使用することで Microsoft Entra テナントにサービスプリンシパルを作成します。このプロセスを進める際には、次の点に注意してください。

サインイン URL には任意の URL を入力できます。
このアプリ用に新しいクライアントシークレットを作成します。
後の手順で使用するために、キーとクライアント ID を保存します。

以前の手順のメトリックパブリッシャーの監視で作成したアプリに、メトリックを発行するリソースへのアクセス許可を付与します。アプリを使用して多くのリソースに対してカスタムメトリックを発行する予定である場合は、リソースグループまたはサブスクリプションレベルでこれらのアクセス許可を付与できます。

Note

診断拡張機能では、サービスプリンシパルを使用して、Azure Monitor を認証し、クラウドサービス用のメトリックを発行します。

診断拡張機能の構成の作成

診断拡張機能の構成ファイルを準備します。このファイルにより、お使いのクラウドサービスに対して、診断拡張機能が収集するパフォーマンスカウンターとログが決まります。サンプルの診断構成ファイルを以下に示します。

<?xml version="1.0" encoding="utf-8"?> 
<DiagnosticsConfiguration xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration"> 
  <PublicConfig xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration"> 
    <WadCfg> 
      <DiagnosticMonitorConfiguration overallQuotaInMB="4096"> 
        <DiagnosticInfrastructureLogs scheduledTransferLogLevelFilter="Error" /> 
        <Directories scheduledTransferPeriod="PT1M"> 
          <IISLogs containerName="wad-iis-logfiles" /> 
          <FailedRequestLogs containerName="wad-failedrequestlogs" /> 
        </Directories> 
        <PerformanceCounters scheduledTransferPeriod="PT1M"> 
          <PerformanceCounterConfiguration counterSpecifier="\Processor(_Total)\% Processor Time" sampleRate="PT15S" /> 
          <PerformanceCounterConfiguration counterSpecifier="\Memory\Available MBytes" sampleRate="PT15S" /> 
          <PerformanceCounterConfiguration counterSpecifier="\Memory\Committed Bytes" sampleRate="PT15S" /> 
          <PerformanceCounterConfiguration counterSpecifier="\Memory\Page Faults/sec" sampleRate="PT15S" /> 
        </PerformanceCounters> 
        <WindowsEventLog scheduledTransferPeriod="PT1M"> 
          <DataSource name="Application!*[System[(Level=1 or Level=2 or Level=3)]]" /> 
          <DataSource name="Windows Azure!*[System[(Level=1 or Level=2 or Level=3 or Level=4)]]" /> 
        </WindowsEventLog> 
        <CrashDumps> 
          <CrashDumpConfiguration processName="WaIISHost.exe" /> 
          <CrashDumpConfiguration processName="WaWorkerHost.exe" /> 
          <CrashDumpConfiguration processName="w3wp.exe" /> 
        </CrashDumps> 
        <Logs scheduledTransferPeriod="PT1M" scheduledTransferLogLevelFilter="Error" /> 
      </DiagnosticMonitorConfiguration> 
      <SinksConfig> 
      </SinksConfig> 
    </WadCfg> 
    <StorageAccount /> 
  </PublicConfig> 
  <PrivateConfig xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration"> 
    <StorageAccount name="" endpoint="" /> 
</PrivateConfig> 
  <IsEnabled>true</IsEnabled> 
</DiagnosticsConfiguration>

診断ファイルの "SinksConfig" セクションで、新しい Azure Monitor シンクを定義します。

  <SinksConfig> 
    <Sink name="AzMonSink"> 
    <AzureMonitor> 
      <ResourceId>-Provide ClassicCloudService’s Resource ID-</ResourceId> 
      <Region>-Azure Region your Cloud Service is deployed in-</Region> 
    </AzureMonitor> 
    </Sink> 
  </SinksConfig>

収集するパフォーマンスカウンターをリストした構成ファイルのセクションに、Azure Monitor シンクを追加します。このエントリにより、指定されたすべてのパフォーマンスカウンターが Azure Monitor にメトリックとしてルーティングされます。パフォーマンスカウンターは必要に応じて追加したり、削除することができます。

    <PerformanceCounters scheduledTransferPeriod="PT1M" sinks="AzMonSink">
        <PerformanceCounterConfiguration counterSpecifier="\Processor(_Total)\% Processor Time" sampleRate="PT15S" />
    ...
    </PerformanceCounters>

最後に、プライベート構成に Azure Monitor アカウントセクションを追加します。前の手順で作成したサービスプリンシパルのクライアント ID とシークレットを入力します。

<PrivateConfig xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration"> 
  <StorageAccount name="" endpoint="" /> 
    <AzureMonitorAccount> 
      <ServicePrincipalMeta> 
        <PrincipalId>clientId from step 3</PrincipalId> 
        <Secret>client secret from step 3</Secret> 
      </ServicePrincipalMeta> 
    </AzureMonitorAccount> 
</PrivateConfig>

この診断ファイルをローカルに保存します。

診断拡張機能をクラウドサービスに配置する

PowerShell を起動し、Azure にログインします。

Login-AzAccount

次のコマンドを使用して、先ほど作成したストレージアカウントの詳細情報を格納します。

$storage_account = <name of your storage account from step 3> 
$storage_keys = <storage account key from step 3>

同様に、次のコマンドを使用して、診断ファイルのパスを変数に設定します。

$diagconfig = “<path of the Diagnostics configuration file with the Azure Monitor sink configured>”

次のコマンドを使用して、Azure Monitor シンクが構成された診断ファイルで、診断拡張機能をクラウドサービスに配置します。

Set-AzureServiceDiagnosticsExtension -ServiceName <classicCloudServiceName> -StorageAccountName $storage_account -StorageAccountKey $storage_keys -DiagnosticsConfigurationPath $diagconfig

Note

診断拡張機能のインストールの一環として、引き続きストレージアカウントを指定する必要があります。診断構成ファイルで指定されたログやパフォーマンスカウンターは、指定したストレージアカウントに書き込まれます。

Azure portal でメトリックをプロットします

Azure portal に移動します。
左側のメニューで [モニター] を選択します。
[モニター] ペインで、[メトリック (プレビュー)] タブを選択します。
リソースのドロップダウンメニューで、お使いのクラシッククラウドサービスを選択します。
名前空間のドロップダウンメニューで、 [azure.vm.windows.guest] を選択します。
メトリックのドロップダウンメニューで、 [Memory\Committed Bytes in Use] を選択します。

ディメンションのフィルタリング機能と分割機能を使用することで、特定のロールとロールインスタンスにより使用されている合計メモリを選択して表示することができます。

次のステップ

カスタムメトリックの詳細を確認します。

Azure Monitor メトリック ストアの従来の Cloud Services にゲスト OS メトリックを送信する

前提条件

クラウド サービスとストレージ アカウントのプロビジョニング

サービス プリンシパルの作成

診断拡張機能の構成の作成

診断拡張機能をクラウド サービスに配置する

Azure portal でメトリックをプロットします

次のステップ

その他のリソース

Azure Monitor メトリックストアの従来の Cloud Services にゲスト OS メトリックを送信する

クラウドサービスとストレージアカウントのプロビジョニング

サービスプリンシパルの作成

診断拡張機能をクラウドサービスに配置する