Azure Service Bus 監視データ リファレンス

この記事には、このサービスに関するすべての監視リファレンス情報が含まれています。

Service Bus 用に収集できるデータとその使用方法の詳細については、 Monitor Azure Service Bus を参照してください。

メトリック

このセクションには、このサービスに関して自動的に収集されるすべてのプラットフォーム メトリックが一覧表示されています。 これらのメトリックは、Azure Monitor でサポートされているすべてのプラットフォーム メトリックのグローバル リストにも含まれています。

メトリックのリテンション期間の詳細については、「Azure Monitor メトリックの概要」を参照してください。

Microsoft.ServiceBus/Namespaces でサポートされているメトリック

次の表に、Microsoft.ServiceBus/Namespaces リソースの種類で使用できるメトリックを示します。

• すべての列がすべてのテーブルに存在するわけではない場合があります。
• 一部の列がページの表示領域を超えている場合があります。 [テーブルの展開] を選択すると、使用可能なすべての列が表示されます。

テーブルの見出し

• カテゴリ - メトリック グループまたは分類。
• メトリック - Azure Portal に表示されるメトリックの表示名。
• REST API の名前 - REST API で参照されるメトリック名。
• 単位 - 測定単位。
• 集計 - 既定の集計の種類。 有効な値: 平均 (Avg)、最小 (Min)、最大 (Max)、合計 (Sum)、数。
• ディメンション - メトリックで使用できるディメンション。
• 時間グレイン - メトリックをサンプリングする間隔。 たとえば、PT1M は、メトリックを 1 分ごとに、PT30Mは 30 分ごとに、PT1H は 1 時間ごとにサンプリングすることを示します。
• DS エクスポート - メトリックが診断設定を介して Azure Monitor ログにエクスポート可能かどうかを示します。 メトリックのエクスポートについては、「Azure Monitor で診断設定を作成する」を参照してください。

次のセクションでは、前のセクションで示したメトリックの詳細について説明します。

要求のメトリック

要求メトリック データと管理操作の要求の数をカウントします。

次の 2 種類のエラーは、ユーザー エラーとして分類されます。

• クライアント側のエラー (HTTP では 400 エラー)。
• MessageLockLostException など、メッセージの処理中に発生するエラー。

メッセージのメトリック

次のメトリックは、 message メトリックです。

接続のメトリック

次のメトリックは、 接続メトリックです。

リソース使用状況のメトリック

次の リソース メトリック は、 premium レベルでのみ使用できます。

Premium レベルの名前空間の停止を監視するための重要なメトリックは次のとおりです。名前空間ごとの CPU 使用率と名前空間 1 つあたりのメモリ サイズ。 Azure Monitor を使用して、これらのメトリックのアラートを設定します。

監視できるもう 1 つのメトリックは、スロットルされた要求です。 これは、名前空間がメモリ、CPU、およびブローカー接続の制限内にある限り、問題にはなりません。 詳細については、「Azure Service Bus Premium レベルでのスロットル」を参照してください。

エラー指標

次のメトリックは、 エラー メトリックです。

geo レプリケーションメトリック

次のメトリックは、 geo-replication メトリックです。

メトリック ディメンション

メトリック ディメンションについては、「多次元メトリック」を参照してください。

このサービスでは、次のディメンションがそのメトリックに関連付けられています。

• EntityName Service Bus では、名前空間の下のメッセージング エンティティがサポートされます。 受信要求メトリックでは、エンティティ名ディメンションには、すべてのキューとトピックに加えて -NamespaceOnlyMetric- の値があります。 この値は、名前空間レベルで行われた要求を表します。 たとえば、名前空間の下にあるすべてのキューとトピックを一覧表示する要求や、認証または認可に失敗したエンティティへの要求などがあります。
• MessagingErrorSubCode
• OperationResult
• [レプリカ]

リソース ログ

このセクションでは、このサービス用に収集できるリソース ログの種類を一覧表示します。 このセクションでは、Azure Monitor でサポートされているすべてのリソース ログ カテゴリの種類のリストからプルされます。

Microsoft.ServiceBus/Namespaces でサポートされているリソース ログ

このセクションでは、Azure Service Bus 用に収集できるリソース ログの種類を示します。

• 操作ログ
• 仮想ネットワークと IP フィルターのログ
• ランタイム監査ログ

Azure Service Bus には、Log Analytics で Azure Diagnostic または リソース固有のテーブルという 2 つの宛先テーブルのいずれかにログをディスパッチする機能が追加されました。 Azure portal で使用可能な切り替えを使用して、変換先テーブルを選択できます。

操作ログ

操作ログ エントリには、次の表に示す要素が含まれます。

操作ログの JSON 文字列の例を次に示します。

AzureDiagnostics:

{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Create Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
  "SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
  "EventTimeString": "9/28/2016 8:40:06 PM +00:00",
  "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
  "Status": "Succeeded",
  "Caller": "ServiceBus Client",
  "category": "OperationalLogs"
}

リソース固有のテーブル エントリ:

{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "EventName": "Retrieve Queue",
  "resourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
  "SubscriptionId": "0000000000-0000-0000-0000-00000000000000",
  "TimeGenerated(UTC)": "9/28/2023 8:40:06 PM +00:00",
  "EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-00000000000000\",\"Namespace\":\"mynamespace\",\"Via\":\"https://mynamespace.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
  "Status": "Succeeded",
  "Caller": "ServiceBus Client",
  "type": "AZMSOperationalLogs",
  "Provider" : "SERVICEBUS"
}

操作ログでキャプチャされるイベントと操作

操作ログでは、Azure Service Bus 名前空間上で実行されるすべての管理操作がキャプチャされます。 Azure Service Bus 上では大量のデータ操作が実行されるため、データ操作は取り込まれません。

操作ログでは、以下の管理操作がキャプチャされます。

仮想ネットワークと IP フィルターのログ

Service Bus 仮想ネットワーク接続イベント JSON には、次の表に示す要素が含まれています。

仮想ネットワーク ログの JSON 文字列の例を以下に示します。

AzureDiagnostics:

{
    "SubscriptionId": "0000000-0000-0000-0000-000000000000",
    "NamespaceName": "namespace-name",
    "IPAddress": "1.2.3.4",
    "Action": "Accept Connection",
    "Reason": "IP is accepted by IPAddress filter.",
    "Count": 1,
    "ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
    "Category": "ServiceBusVNetConnectionEvent"
}

リソース固有のテーブル エントリ:

{
  "SubscriptionId": "0000000-0000-0000-0000-000000000000",
  "NamespaceName": "namespace-name",
  "AddressIp": "1.2.3.4",
  "Action": "Accept Connection",
  "Message": "IP is accepted by IPAddress filter.",
  "Count": 1,
  "ResourceId": "/SUBSCRIPTIONS/<AZURE SUBSCRIPTION ID>/RESOURCEGROUPS/<RESOURCE GROUP NAME>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<SERVICE BUS NAMESPACE NAME>",
  "Provider" : "SERVICEBUS",
  "Type": "AZMSVNetConnectionEvents"
}

ランタイム監査ログ

ランタイム監査ログは、Service Bus でのさまざまなデータ プレーン アクセス操作 (メッセージの送信や受信など) に関する集約された診断情報をキャプチャします。

ランタイム監査ログには、次の表に示す要素が含まれます。

ランタイム監査ログ エントリの例を次に示します。

AzureDiagnostics:

{
  "ActivityId": "<activity id>",
  "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | PeekLockMessage",
  "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
  "Time": "1/1/2021 8:40:06 PM +00:00",
  "Status": "Success | Failure",
  "Protocol": "AMQP | HTTP | SBMP", 
  "AuthType": "SAS | AAD", 
  "AuthKey": "<AAD Application Name| SAS policy name>",
  "NetworkType": "Public | Private", 
  "ClientIp": "x.x.x.x",
  "Count": 1, 
  "Category": "RuntimeAuditLogs"
}

リソース固有のテーブル エントリ:

{
  "ActivityId": "<activity id>",
  "ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage | PeekLockMessage",
  "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<Service Bus namespace>/servicebus/<service bus name>",
  "TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
  "Status": "Success | Failure",
  "Protocol": "AMQP | HTTP | SBMP", 
  "AuthType": "SAS | AAD", 
  "AuthKey": "<AAD Application Name| SAS policy name>",
  "NetworkType": "Public | Private", 
  "ClientIp": "x.x.x.x",
  "Count": 1, 
  "Provider": "SERVICEBUS",
  "Type"   : "AZMSRuntimeAuditLogs"
}

診断エラー ログ

診断エラー ログは、クライアント側、調整、クォータ超過エラーのエラー メッセージをキャプチャします。 エラー識別の詳細な診断が提供されます。

診断エラー ログには、次の表に示す要素が含まれます。

診断エラー ログ エントリの例を次に示します。

{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "SubscriptionId": "<Azure Subscription Id",
  "NamespaceName": "Name of Service Bus Namespace",
  "EntityType": "Queue",
  "EntityName": "Name of Service Bus Queue",
  "ActivityName": "SendMessage",
  "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
  "OperationResult": "ClientError",
  "ErrorCount": 1,
  "EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
  "ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
  "category": "DiagnosticErrorLogs"
}

リソース固有のテーブル エントリ:

{
  "ActivityId": "0000000000-0000-0000-0000-00000000000000",
  "NamespaceName": "Name of Service Bus Namespace",
  "EntityType": "Queue",
  "EntityName": "Name of Service Bus Queue",
  "ActivityName": "SendMessage",
  "ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.SERVICEBUS/NAMESPACES/<service bus namespace name>",,
  "OperationResult": "ClientError",
  "ErrorCount": 1,
  "TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
  "ErrorMessage": "the sessionid was not set on a message, and it cannot be sent to the entity. entities that have session support enabled can only receive messages that have the sessionid set to a valid value.",
  "Type": "AZMSDiagnosticErrorLogs"
}

Azure Monitor ログ テーブル

このセクションでは、Kusto クエリを使用した Log Analytics によるクエリに使用できる、このサービスに関連するすべての Azure Monitor ログ テーブルを一覧表示します。 テーブルにはリソース ログ データが含まれており、収集されルーティングされる内容によっては、さらに多くのデータが含まれる場合があります。

2026 年 9 月 30 日に Azure Service Bus 用の SBMP プロトコルのサポートは終了するため、2026 年 9 月 30 日以降はこのプロトコルを使用できなくなります。 その日付より前に、(重要なセキュリティ更新プログラムと強化された機能が提供される) AMQP プロトコルを使った最新の Azure Service Bus SDK ライブラリに移行してください。

詳細については、サポート廃止のお知らせに関するページを参照してください。

Azure Service Bus では、Azure Monitor ログの Kusto テーブルが使用されます。 これらのテーブルに対して Log Analytics を使用してクエリを実行できます。

Service Bus Microsoft.ServiceBus/namespaces

• AzureActivity
• AzureMetrics
• AzureDiagnostics
• AZMSOperationalLogs
• AZMSVnetConnectionEvents
• AZMSRunTimeAuditLogs
• AZMSApplicationMetricLogs
• AZMSDiagnosticErrorLogs

アクティビティ ログ

リンクされたテーブルには、このサービスのアクティビティ ログに記録できる操作が一覧表示されます。 これらの操作は、アクティビティ ログで使用可能なすべてのリソース プロバイダー操作のサブセットです。

アクティビティ ログ エントリのスキーマの詳細については、「アクティビティ ログのスキーマ」を参照してください。

• 統合リソース プロバイダーの操作

関連するコンテンツ

• Service Bus の監視の詳細については、「 Monitor Azure Service Bus 」を参照してください。
• Azure リソースの監視の詳細については、「Azure Monitor で Azure リソースを監視する」を参照してください。