Azure Event Grid のプル イベント配信のデータ リファレンスを監視する
この記事では、Azure Event Grid のプッシュ配信のパフォーマンスと可用性を分析する目的で収集されるログとメトリック データのリファレンスを提供します。
重要
現在、この機能はプレビュー段階にあります。
メトリック
Microsoft.EventGrid/domains
| メトリック | 診断設定を使用したエクスポートが可能か? | メトリックの表示名 | ユニット | 集計の種類 | 説明 | Dimensions |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | はい | 高度なフィルターの評価 | Count | 合計 | このトピックのイベント サブスクリプション全体で評価される高度なフィルターの合計数。 | Topic、EventSubscriptionName、DomainEventSubscriptionName |
| DeadLetteredCount | はい | 配信不能イベント | Count | 合計 | このイベント サブスクリプションに一致する配信不能イベントの合計 | Topic、EventSubscriptionName、DomainEventSubscriptionName、DeadLetterReason |
| DeliveryAttemptFailCount | いいえ | 配信できなかったイベント | Count | 合計 | このイベント サブスクリプションに配信できなかったイベントの合計 | Topic、EventSubscriptionName、DomainEventSubscriptionName、Error、ErrorType |
| DeliverySuccessCount | はい | 配信されたイベント | Count | 合計 | このイベント サブスクリプションに配信されたイベントの合計 | Topic、EventSubscriptionName、DomainEventSubscriptionName |
| DestinationProcessingDurationInMs | いいえ | 宛先処理継続時間 | MilliSeconds | Average | 宛先処理継続時間 (ミリ秒単位) | Topic、EventSubscriptionName、DomainEventSubscriptionName |
| DroppedEventCount | はい | 削除されたイベント | Count | 合計 | このイベント サブスクリプションに一致する削除されたイベントの合計 | Topic、EventSubscriptionName、DomainEventSubscriptionName、DropReason |
| MatchedEventCount | はい | 一致するイベント | Count | 合計 | このイベント サブスクリプションに一致するイベントの合計 | Topic、EventSubscriptionName、DomainEventSubscriptionName |
| PublishFailCount | はい | 発行失敗イベント | Count | 合計 | このトピックに発行できなかったイベントの合計 | Topic、ErrorType、Error |
| PublishSuccessCount | はい | 発行されたイベント | Count | 合計 | このトピックに発行されたイベントの合計数 | トピック |
| PublishSuccessLatencyInMs | はい | 成功した発行の待機時間 | MilliSeconds | 合計 | 成功した発行の待機時間 (ミリ秒単位) | ディメンションなし |
Microsoft.EventGrid/eventSubscriptions
| メトリック | 診断設定を使用したエクスポートが可能か? | メトリックの表示名 | ユニット | 集計の種類 | 説明 | Dimensions |
|---|---|---|---|---|---|---|
| DeadLetteredCount | はい | 配信不能イベント | Count | 合計 | このイベント サブスクリプションに一致する配信不能イベントの合計 | DeadLetterReason |
| DeliveryAttemptFailCount | いいえ | 配信できなかったイベント | Count | 合計 | このイベント サブスクリプションに配信できなかったイベントの合計 | Error、ErrorType |
| DeliverySuccessCount | はい | 配信されたイベント | Count | 合計 | このイベント サブスクリプションに配信されたイベントの合計 | ディメンションなし |
| DestinationProcessingDurationInMs | いいえ | 宛先処理継続時間 | ミリ秒 | Average | 宛先処理継続時間 (ミリ秒単位) | ディメンションなし |
| DroppedEventCount | はい | 削除されたイベント | Count | 合計 | このイベント サブスクリプションに一致する削除されたイベントの合計 | DropReason |
| MatchedEventCount | はい | 一致するイベント | Count | 合計 | このイベント サブスクリプションに一致するイベントの合計 | ディメンションなし |
Microsoft.EventGrid/extensionTopics
| メトリック | 診断設定を使用したエクスポートが可能か? | メトリックの表示名 | ユニット | 集計の種類 | 説明 | Dimensions |
|---|---|---|---|---|---|---|
| PublishFailCount | はい | 発行失敗イベント | Count | 合計 | このトピックに発行できなかったイベントの合計 | ErrorType、Error |
| PublishSuccessCount | はい | 発行されたイベント | Count | 合計 | このトピックに発行されたイベントの合計数 | ディメンションなし |
| PublishSuccessLatencyInMs | はい | 成功した発行の待機時間 | ミリ秒 | 合計 | 成功した発行の待機時間 (ミリ秒単位) | ディメンションなし |
| UnmatchedEventCount | はい | 不一致のイベント | Count | 合計 | このトピックのどのイベント サブスクリプションにも一致しないイベントの合計 | ディメンションなし |
Microsoft.EventGrid/partnerNamespaces
| メトリック | 診断設定を使用したエクスポートが可能か? | メトリックの表示名 | ユニット | 集計の種類 | 説明 | Dimensions |
|---|---|---|---|---|---|---|
| PublishFailCount | はい | 発行失敗イベント | Count | 合計 | このパートナー名前空間に発行できなかったイベントの合計数 | ErrorType、Error |
| PublishSuccessCount | はい | 発行されたイベント | Count | 合計 | このパートナー名前空間に発行されたイベントの合計数 | ディメンションなし |
| PublishSuccessLatencyInMs | はい | 成功した発行の待機時間 | MilliSeconds | 合計 | 成功した発行の待機時間 (ミリ秒単位) | ディメンションなし |
| UnmatchedEventCount | はい | 不一致のイベント | Count | 合計 | パートナー トピックのいずれにも一致しないイベントの合計数 | ディメンションなし |
Microsoft.EventGrid/partnerTopics
| メトリック | 診断設定を使用したエクスポートが可能か? | メトリックの表示名 | ユニット | 集計の種類 | 説明 | Dimensions |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | はい | 高度なフィルターの評価 | Count | 合計 | このパートナー トピックのイベント サブスクリプション全体で評価される高度なフィルターの合計数。 | EventSubscriptionName |
| DeadLetteredCount | はい | 配信不能イベント | Count | 合計 | このイベント サブスクリプションに一致する配信不能イベントの合計 | DeadLetterReason、EventSubscriptionName |
| DeliveryAttemptFailCount | いいえ | 配信できなかったイベント | Count | 合計 | このイベント サブスクリプションに配信できなかったイベントの合計 | Error、ErrorType、EventSubscriptionName |
| DeliverySuccessCount | はい | 配信されたイベント | Count | 合計 | このイベント サブスクリプションに配信されたイベントの合計 | EventSubscriptionName |
| DestinationProcessingDurationInMs | いいえ | 宛先処理継続時間 | MilliSeconds | Average | 宛先処理継続時間 (ミリ秒単位) | EventSubscriptionName |
| DroppedEventCount | はい | 削除されたイベント | Count | 合計 | このイベント サブスクリプションに一致する削除されたイベントの合計 | DropReason、EventSubscriptionName |
| MatchedEventCount | はい | 一致するイベント | Count | 合計 | このイベント サブスクリプションに一致するイベントの合計 | EventSubscriptionName |
| PublishSuccessCount | はい | 発行されたイベント | Count | 合計 | このパートナー トピックに発行されたイベントの合計数 | ディメンションなし |
| UnmatchedEventCount | はい | 不一致のイベント | Count | 合計 | このパートナー トピックのどのイベント サブスクリプションにも一致しないイベントの合計 | ディメンションなし |
Microsoft.EventGrid/systemTopics
| メトリック | 診断設定を使用したエクスポートが可能か? | メトリックの表示名 | ユニット | 集計の種類 | 説明 | Dimensions |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | はい | 高度なフィルターの評価 | Count | 合計 | このトピックのイベント サブスクリプション全体で評価される高度なフィルターの合計数。 | EventSubscriptionName |
| DeadLetteredCount | はい | 配信不能イベント | Count | 合計 | このイベント サブスクリプションに一致する配信不能イベントの合計 | DeadLetterReason、EventSubscriptionName |
| DeliveryAttemptFailCount | いいえ | 配信できなかったイベント | Count | 合計 | このイベント サブスクリプションに配信できなかったイベントの合計 | Error、ErrorType、EventSubscriptionName |
| DeliverySuccessCount | はい | 配信されたイベント | Count | 合計 | このイベント サブスクリプションに配信されたイベントの合計 | EventSubscriptionName |
| DestinationProcessingDurationInMs | いいえ | 宛先処理継続時間 | ミリ秒 | Average | 宛先処理継続時間 (ミリ秒単位) | EventSubscriptionName |
| DroppedEventCount | はい | 削除されたイベント | Count | 合計 | このイベント サブスクリプションに一致する削除されたイベントの合計 | DropReason、EventSubscriptionName |
| MatchedEventCount | はい | 一致するイベント | Count | 合計 | このイベント サブスクリプションに一致するイベントの合計 | EventSubscriptionName |
| PublishFailCount | はい | 発行失敗イベント | Count | 合計 | このトピックに発行できなかったイベントの合計 | ErrorType、Error |
| PublishSuccessCount | はい | 発行されたイベント | Count | 合計 | このトピックに発行されたイベントの合計数 | ディメンションなし |
| PublishSuccessLatencyInMs | はい | 成功した発行の待機時間 | ミリ秒 | 合計 | 成功した発行の待機時間 (ミリ秒単位) | ディメンションなし |
| UnmatchedEventCount | はい | 不一致のイベント | Count | 合計 | このトピックのどのイベント サブスクリプションにも一致しないイベントの合計 | ディメンションなし |
Microsoft.EventGrid/topics
| メトリック | 診断設定を使用したエクスポートが可能か? | メトリックの表示名 | ユニット | 集計の種類 | 説明 | Dimensions |
|---|---|---|---|---|---|---|
| AdvancedFilterEvaluationCount | はい | 高度なフィルターの評価 | Count | 合計 | このトピックのイベント サブスクリプション全体で評価される高度なフィルターの合計数。 | EventSubscriptionName |
| DeadLetteredCount | はい | 配信不能イベント | Count | 合計 | このイベント サブスクリプションに一致する配信不能イベントの合計 | DeadLetterReason、EventSubscriptionName |
| DeliveryAttemptFailCount | いいえ | 配信できなかったイベント | Count | 合計 | このイベント サブスクリプションに配信できなかったイベントの合計 | Error、ErrorType、EventSubscriptionName |
| DeliverySuccessCount | はい | 配信されたイベント | Count | 合計 | このイベント サブスクリプションに配信されたイベントの合計 | EventSubscriptionName |
| DestinationProcessingDurationInMs | いいえ | 宛先処理継続時間 | MilliSeconds | Average | 宛先処理継続時間 (ミリ秒単位) | EventSubscriptionName |
| DroppedEventCount | はい | 削除されたイベント | Count | 合計 | このイベント サブスクリプションに一致する削除されたイベントの合計 | DropReason、EventSubscriptionName |
| MatchedEventCount | はい | 一致するイベント | Count | 合計 | このイベント サブスクリプションに一致するイベントの合計 | EventSubscriptionName |
| PublishFailCount | はい | 発行失敗イベント | Count | 合計 | このトピックに発行できなかったイベントの合計 | ErrorType、Error |
| PublishSuccessCount | はい | 発行されたイベント | Count | 合計 | このトピックに発行されたイベントの合計数 | ディメンションなし |
| PublishSuccessLatencyInMs | はい | 成功した発行の待機時間 | MilliSeconds | 合計 | 成功した発行の待機時間 (ミリ秒単位) | ディメンションなし |
| UnmatchedEventCount | はい | 不一致のイベント | Count | 合計 | このトピックのどのイベント サブスクリプションにも一致しないイベントの合計 | ディメンションなし |
リソース ログ
Event Grid ユーザーは、診断設定を使用して、Azure ストレージ アカウント、イベント ハブ、または Log Analytics ワークスペースのいずれかで発行および配信エラー ログをキャプチャして表示することができます。 この記事では、ログのスキーマとログ エントリの例を示します。
発行および配信エラー ログのスキーマ
| プロパティ名 | データ型 | 説明 |
|---|---|---|
| Time | DateTime | ログ エントリが生成された時刻 値の例: 01-29-2020 09:52:02.700 |
| EventSubscriptionName | String | イベント サブスクリプションの名前 値の例: "EVENTSUB1" このプロパティは、配信エラー ログにのみ存在します。 |
| カテゴリ | String | ログのカテゴリの名前。 値の例: "DeliveryFailures" または "PublishFailures" |
| OperationName | String | エラーの原因となった操作の名前。 サンプル値: 配信に失敗した場合は、"Deliver"。 |
| Message | String | エラーの理由とその他の詳細情報を説明する、ユーザーのログ メッセージ。 |
| ResourceId | String | トピックまたはドメイン リソースのリソース ID 値の例: |
例 - 発行および配信エラー ログのスキーマ
{
"time": "2019-11-01T00:17:13.4389048Z",
"resourceId": "/SUBSCRIPTIONS/SAMPLE-SUBSCTIPTION-ID /RESOURCEGROUPS/SAMPLE-RESOURCEGROUP-NAME/PROVIDERS/MICROSOFT.EVENTGRID/TOPICS/SAMPLE-TOPIC-NAME ",
"eventSubscriptionName": "SAMPLEDESTINATION",
"category": "DeliveryFailures",
"operationName": "Deliver",
"message": "Message:outcome=NotFound, latencyInMs=2635, id=xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx, systemId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx, state=FilteredFailingDelivery, deliveryTime=11/1/2019 12:17:10 AM, deliveryCount=0, probationCount=0, deliverySchema=EventGridEvent, eventSubscriptionDeliverySchema=EventGridEvent, fields=InputEvent, EventSubscriptionId, DeliveryTime, State, Id, DeliverySchema, LastDeliveryAttemptTime, SystemId, fieldCount=, requestExpiration=1/1/0001 12:00:00 AM, delivered=False publishTime=11/1/2019 12:17:10 AM, eventTime=11/1/2019 12:17:09 AM, eventType=Type, deliveryTime=11/1/2019 12:17:10 AM, filteringState=FilteredWithRpc, inputSchema=EventGridEvent, publisher=DIAGNOSTICLOGSTEST-EASTUS.EASTUS-1.EVENTGRID.AZURE.NET, size=363, fields=Id, PublishTime, SerializedBody, EventType, Topic, Subject, FilteringHashCode, SystemId, Publisher, FilteringTopic, TopicCategory, DataVersion, MetadataVersion, InputSchema, EventTime, fieldCount=15, url=sb://diagnosticlogstesting-eastus.servicebus.windows.net/, deliveryResponse=NotFound: The messaging entity 'sb://diagnosticlogstesting-eastus.servicebus.windows.net/eh-diagnosticlogstest' could not be found. TrackingId:c98c5af6-11f0-400b-8f56-c605662fb849_G14, SystemTracker:diagnosticlogstesting-eastus.servicebus.windows.net:eh-diagnosticlogstest, Timestamp:2019-11-01T00:17:13, referenceId: ac141738a9a54451b12b4cc31a10dedc_G14:"
}
Outcome に指定できる値は、NotFound、Aborted、TimedOut、GenericError、Busy です。 Event Grid では、message のイベント ハンドラーから受信したあらゆる情報をログに記録します。 たとえば、GenericError の場合、HTTP ステータス コード、エラー コード、エラー メッセージをログに記録します。
データ プレーン操作ログのスキーマ
| プロパティ名 | データ型 | 説明 |
|---|---|---|
| NetworkAccess | String | 使用できる値 : - PublicAccess - パブリック IP で接続するとき- PrivateAccess - プライベート リンクで接続するとき |
| ClientIpAddress | String | 受信要求のソース IP |
| TlsVersion | String | クライアント接続に使用するトランスポート層セキュリティ (TLS) のバージョン。 指定できる値は 1.0、1.1、1.2 です |
| Authentication/Type | String | メッセージの発行時に認証のために使用されるシークレットのタイプ。 - Key – 要求では SAS キーを使用します- SASToken – 要求では SAS キーから生成された SAS トークンを使用します- AADAccessToken – Microsoft Entra ID 発行の JSON Web Token (JWT) トークン- Unknown – 上記の種類の認証以外。 OPTIONS 要求には、この種類の認証が含まれます |
| Authentication/ObjectId | String | 認証の種類が AADAccessToken に設定されているときに使用されるサービス プリンシパルの ObjectId |
| OperationResult | String | 発行の結果。 使用できる値: - 成功 - Unauthorized - Forbidden - RequestEntityTooLarge - BadRequest - InternalServerError |
| TotalOperations | String | これらのトレースは、発行要求ごとには生成されません。 上記の値の一意の組み合わせごとに集計が 1 分ごとに出力されます |
例 - データ プレーン要求のスキーマ
{
"time": "2021-10-26T21:44:16.8117322Z",
"resourceId": "/SUBSCRIPTIONS/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/RESOURCEGROUPS/BMT-TEST/PROVIDERS/MICROSOFT.EVENTGRID/DOMAINS/BMTAUDITLOGDOMAIN",
"operationName": "Microsoft.EventGrid/events/send",
"category": "DataPlaneRequests",
"level": "Information",
"region": "CENTRALUSEUAP",
"properties": {
"aggregatedRequests": [
{
"networkAccess": "PublicAccess",
"clientIpAddress": "xx.xx.xx.xxx",
"tlsVersion": "1.2",
"authentication": {
"type": "AADAccessToken",
"objectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
},
"operationResult": "Success",
"totalOperations": 1
}
]
}
}
DataPlaneRequests 診断設定を選択すると、Event Grid リソースにより、パブリック アクセスとプライベート アクセスの操作を含むデータ プレーン操作の監査トレースの発行が開始されます。 このトレースでは、必要に応じて 1 つ以上の要求がログに記録される場合があります。
次のステップ
トピックまたはドメインの診断ログを有効にする方法については、診断ログの有効化に関するページを参照してください。