Azure Web PubSub を監視する

[アーティクル]
11/15/2023

Azure リソースに依存するクリティカルなアプリケーションやビジネスプロセスがある場合は、それらのリソースの可用性、パフォーマンス、運用を監視する必要があります。この記事では、Azure Web PubSub によって生成される監視データと、Azure Monitor の機能を使ってこのデータについての分析とアラートを行う方法について説明します。

モニターの概要

Azure portal の各 Azure Web PubSub の [概要] ページには、コンカレント接続数や送信トラフィックなど、リソースの使用状況の要約が表示されます。この情報は役に立ちます。このペインで入手できる監視データの量はごくわずかです。このデータの一部はデータは自動的には収集されます。これは、リソースを作成するとすぐに分析で利用できるようになります。構成の後には、他の種類のデータ収集を有効にできます。

Azure Monitor とは

Azure Web PubSub では、Azure Monitor を使って監視データが作成されます。 Monitor は Azure のフルスタックの監視サービスであり、他のクラウドやオンプレミスのリソースに加えて、Azure リソースを監視するための完全な機能セットが提供されます。

Azure サービスの監視について理解が十分でない場合は、まず「Azure Monitor を使用した Azure リソースの監視」で次の概念の説明をお読みください。

Azure Monitor とは
監視に関連するコスト
Azure で収集される監視データ
データ収集の構成
監視データの分析とアラート生成のための Azure の標準ツール

以降のセクションは、この記事が基になっています。 Azure Web PubSub から収集される特定のデータについて説明します。また、Azure のツールを使ってデータの収集を構成し、このデータを分析するための例を示します。

データの監視

Azure Web PubSub により、他の Azure リソースと同じ種類の監視データが収集されます。これについては、Azure Monitor データコレクションに関する記事を参照してください。

Azure Web PubSub によって作成されるメトリックとログメトリックの詳細については、「Azure Web PubSub の監視データのリファレンス」を参照してください。

収集とルーティング

プラットフォームメトリックとアクティビティログは自動的に収集および格納されますが、診断設定を使用して他の場所にルーティングすることもできます。

リソースログは、診断設定を作成して 1 つ以上の場所にルーティングするまでは収集および格納されません。

Azure portal、CLI、または PowerShell を使用して診断設定を作成するプロセスの詳細については、「Azure でプラットフォームログとメトリックを収集するための診断設定を作成する」を参照してください。診断設定を作成するときは、収集するログのカテゴリを指定します。

収集できるメトリックとログについては、次のセクションで説明します。

メトリックの分析

Azure Monitor のメニューから [メトリック] を開き、メトリックスエクスプローラーを使って、Azure Web PubSub のメトリックを、他の Azure サービスからのメトリックと一緒に分析することができます。このツールの使用方法の詳細については、Azure Monitor メトリックスエクスプローラーでメトリックスを分析する方法に関するページを参照してください。

Azure Web PubSub 用に収集されるプラットフォームメトリックの一覧については、メトリックに関する記事を参照してください。

参考のために、Azure Monitor でサポートされているすべてのリソースメトリックの一覧を確認できます。

ログの分析

Azure Monitor ログのデータはテーブルに格納され、各テーブルには独自の一意のプロパティセットがあります。

Azure Monitor 内のすべてのリソースログには、同じフィールドの後にサービス固有のフィールドがあります。共通のスキーマの概要については、Azure Monitor リソースログのスキーマに関する記事をご覧ください。

Azure Web PubSub により、"接続"、"メッセージング"、"HTTP 要求" という 3 種類のリソースログが収集されます。

接続ログでは、Azure Web PubSub ハブ接続に関する詳細情報が提供されます。たとえば、基本情報 (ユーザー ID、接続 ID など) やイベント情報 (接続、切断など) です。
メッセージング ログでは、Azure Web PubSub サービス経由で送受信される Azure Web PubSub ハブメッセージのトレース情報が提供されます。たとえば、メッセージのトレース ID やメッセージの種類などです。
HTTP 要求ログは、Azure Web PubSub サービスに対する HTTP 要求のトレース情報を提供します。たとえば、HTTP メソッドと状態コードです。 HTTP 要求は通常、サービスへの到着時またはサービスからの発信時に記録されます。

リソースログを有効にする方法

現在、Azure Web PubSub は Azure Storage との統合をサポートしています。

Azure ポータルに移動します。
Azure Web PubSub サービスインスタンスの [診断設定] ページで、[+ 診断設定を追加する] を選びます。
[診断設定の名前] に設定名を入力します。
[カテゴリの詳細] で、必要なログカテゴリを選択します。
[宛先の詳細] で、[ストレージアカウントへのアーカイブ] をオンにします。
[保存] を選択んで診断設定を保存します。

Note

ストレージアカウントは、Azure Web PubSub サービスと同じリージョンにある必要があります。

Azure ストレージアカウントにアーカイブする

ログは、[診断設定] ペインで構成されているストレージアカウントに格納されます。リソースログを格納するために、insights-logs-<CATEGORY_NAME> という名前のコンテナーが自動的に作成されます。コンテナー内では、ログはファイル resourceId=/SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/XXXX/PROVIDERS/MICROSOFT.SIGNALRSERVICE/SIGNALR/XXX/y=YYYY/m=MM/d=DD/h=HH/m=00/PT1H.json に格納されます。パスは resource ID と Date Time によって連結されます。ログファイルは hour 別に分割されています。分の値は常に m=00 です。

Azure Log Analytics にアーカイブする

ログを Log Analytics ワークスペースに送信するには:

[診断設定] ページの [宛先の詳細] で、[Log Analytics ワークスペースへの送信] を選びます。
使用するサブスクリプションを選択します。
ログの宛先として使用する [Log Analytics ワークスペース] を選びます。

リソースログを表示するには、次の手順のようにします。

対象の Log Analytics の Logs を選びます。
「WebPubSubConnectivity」、「WebPubSubMessaging」、または「WebPubSubHttpRequest」と入力し、ログを照会する時間範囲を選びます。詳細なクエリについては、Azure Monitor での Log Analytics の使用開始に関する記事をご覧ください。

SignalR サービスのサンプルクエリを使うには、次の手順のようにします。

対象の Log Analytics の Logs を選びます。
Queries を選んで、クエリエクスプローラーを開きます。
Resource type を選んで、サンプルクエリをリソースの種類でグループ化します。
Run を選んで、スクリプトを実行します。

警告

Azure Monitor のアラートは、監視データで重要な状態が見つかると事前に通知します。これにより、ユーザーが気付く前に、管理者が問題を識別して対処できます。アラートはメトリック、ログ、アクティビティログに対して設定できます。アラートの種類に応じて、さまざまな利点と欠点があります。

次の表に、Azure Web PubSub の一般的および推奨されるアラートルールを示します。

アラートの種類	条件	例
メトリック	つながり	接続数が設定値を超えた場合
メトリック	送信トラフィック	メッセージ数が設定値を超えたとき
アクティビティログ	サービスを作成または更新する	サービスが作成または更新されたとき
アクティビティログ	サービスの削除	サービスが削除されたとき
アクティビティログ	サービスを再起動する	サービスが再起動されたとき

次のステップ

Azure Functions の監視については、以下のアーティクルをご覧ください。