共用方式為


監視 Azure 事件方格推送事件傳遞的資料參考

本文提供記錄和計量資料的參考,這些資料是為了對 Azure 事件方格推送傳遞進行效能與可用性分析而收集的。

重要

這項功能目前為「預覽」狀態。

計量

Microsoft.EventGrid/domains

計量 是否可透過診斷設定匯出? 計量顯示名稱 單位 彙總類型 描述 維度
AdvancedFilterEvaluationCount Yes 進階篩選評估 計數 總數 針對此主題事件訂閱評估的進階篩選總數。 Topic、EventSubscriptionName、DomainEventSubscriptionName
DeadLetteredCount Yes 失效信件事件 計數 總數 與此事件訂閱相符的失效信件事件總數 Topic、EventSubscriptionName、DomainEventSubscriptionName、DeadLetterReason
DeliveryAttemptFailCount No 傳遞失敗的事件 計數 總數 傳遞到此事件訂閱失敗的事件總數 Topic、EventSubscriptionName、DomainEventSubscriptionName、Error、ErrorType
DeliverySuccessCount Yes 已傳遞的事件 計數 總數 已傳遞到此事件訂閱的事件總數 Topic、EventSubscriptionName、DomainEventSubscriptionName
DestinationProcessingDurationInMs No 目的端處理持續期間 毫秒 平均 目的端處理持續期間,以毫秒為單位 Topic、EventSubscriptionName、DomainEventSubscriptionName
DroppedEventCount Yes 卸除的事件 計數 總數 與此事件訂閱相符的已卸除事件總數 Topic、EventSubscriptionName、DomainEventSubscriptionName、DropReason
MatchedEventCount Yes 相符的事件 計數 總數 與此事件訂閱相符的事件總數 Topic、EventSubscriptionName、DomainEventSubscriptionName
PublishFailCount Yes 發行失敗的事件 計數 總數 發佈至本主題失敗的事件總數 Topic、ErrorType、Error
PublishSuccessCount Yes 已發佈的事件 計數 總數 發佈至本主題的事件總數 主題
PublishSuccessLatencyInMs Yes 發行成功延遲 毫秒 總數 發佈成功延遲 (以毫秒計) 無維度

Microsoft.EventGrid/eventSubscriptions

計量 是否可透過診斷設定匯出? 計量顯示名稱 單位 彙總類型 描述 維度
DeadLetteredCount Yes 失效信件事件 計數 總數 與此事件訂閱相符的失效信件事件總數 DeadLetterReason
DeliveryAttemptFailCount No 傳遞失敗的事件 計數 總數 傳遞到此事件訂閱失敗的事件總數 Error、ErrorType
DeliverySuccessCount Yes 已傳遞的事件 計數 總數 已傳遞到此事件訂閱的事件總數 無維度
DestinationProcessingDurationInMs No 目的端處理持續期間 毫秒 平均 目的端處理持續期間,以毫秒為單位 無維度
DroppedEventCount Yes 卸除的事件 計數 總數 與此事件訂閱相符的已卸除事件總數 DropReason
MatchedEventCount Yes 相符的事件 計數 總數 與此事件訂閱相符的事件總數 無維度

Microsoft.EventGrid/extensionTopics

計量 是否可透過診斷設定匯出? 計量顯示名稱 單位 彙總類型 描述 維度
PublishFailCount Yes 發行失敗的事件 計數 總數 發佈至本主題失敗的事件總數 ErrorType、Error
PublishSuccessCount Yes 已發佈的事件 計數 總數 發佈至本主題的事件總數 無維度
PublishSuccessLatencyInMs Yes 發行成功延遲 毫秒 總數 發佈成功延遲 (以毫秒計) 無維度
UnmatchedEventCount Yes 不相符的事件 計數 總數 不符合本主題中任何事件訂閱的事件總數 無維度

Microsoft.EventGrid/partnerNamespaces

計量 是否可透過診斷設定匯出? 計量顯示名稱 單位 彙總類型 描述 維度
PublishFailCount Yes 發行失敗的事件 計數 總數 發佈至本夥伴名稱空間失敗的事件總數 ErrorType、Error
PublishSuccessCount Yes 已發佈的事件 計數 總數 發佈至本夥伴名稱空間的事件總數 無維度
PublishSuccessLatencyInMs Yes 發行成功延遲 毫秒 總數 發佈成功延遲 (以毫秒計) 無維度
UnmatchedEventCount Yes 不相符的事件 計數 總數 未符合任何夥伴主題的事件總數 無維度

Microsoft.EventGrid/partnerTopics

計量 是否可透過診斷設定匯出? 計量顯示名稱 單位 彙總類型 描述 維度
AdvancedFilterEvaluationCount Yes 進階篩選評估 計數 總數 針對本夥伴主題事件訂閱評估的進階篩選總數。 EventSubscriptionName
DeadLetteredCount Yes 失效信件事件 計數 總數 與此事件訂閱相符的失效信件事件總數 DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount No 傳遞失敗的事件 計數 總數 傳遞到此事件訂閱失敗的事件總數 Error、ErrorType、EventSubscriptionName
DeliverySuccessCount Yes 已傳遞的事件 計數 總數 已傳遞到此事件訂閱的事件總數 EventSubscriptionName
DestinationProcessingDurationInMs No 目的端處理持續期間 毫秒 平均 目的端處理持續期間,以毫秒為單位 EventSubscriptionName
DroppedEventCount Yes 卸除的事件 計數 總數 與此事件訂閱相符的已卸除事件總數 DropReason, EventSubscriptionName
MatchedEventCount Yes 相符的事件 計數 總數 與此事件訂閱相符的事件總數 EventSubscriptionName
PublishSuccessCount Yes 已發佈的事件 計數 總數 發佈至本夥伴主題的事件總數 無維度
UnmatchedEventCount Yes 不相符的事件 計數 總數 不符合本夥伴主題中任何事件訂閱的事件總數 無維度

Microsoft.EventGrid/systemTopics

計量 是否可透過診斷設定匯出? 計量顯示名稱 單位 彙總類型 描述 維度
AdvancedFilterEvaluationCount Yes 進階篩選評估 計數 總數 針對此主題事件訂閱評估的進階篩選總數。 EventSubscriptionName
DeadLetteredCount Yes 失效信件事件 計數 總數 與此事件訂閱相符的失效信件事件總數 DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount No 傳遞失敗的事件 計數 總數 傳遞到此事件訂閱失敗的事件總數 Error、ErrorType、EventSubscriptionName
DeliverySuccessCount Yes 已傳遞的事件 計數 總數 已傳遞到此事件訂閱的事件總數 EventSubscriptionName
DestinationProcessingDurationInMs No 目的端處理持續期間 毫秒 平均 目的端處理持續期間,以毫秒為單位 EventSubscriptionName
DroppedEventCount Yes 卸除的事件 計數 總數 與此事件訂閱相符的已卸除事件總數 DropReason, EventSubscriptionName
MatchedEventCount Yes 相符的事件 計數 總數 與此事件訂閱相符的事件總數 EventSubscriptionName
PublishFailCount Yes 發行失敗的事件 計數 總數 發佈至本主題失敗的事件總數 ErrorType、Error
PublishSuccessCount Yes 已發佈的事件 計數 總數 發佈至本主題的事件總數 無維度
PublishSuccessLatencyInMs Yes 發行成功延遲 毫秒 總數 發佈成功延遲 (以毫秒計) 無維度
UnmatchedEventCount Yes 不相符的事件 計數 總數 不符合本主題中任何事件訂閱的事件總數 無維度

Microsoft.EventGrid/topics

計量 是否可透過診斷設定匯出? 計量顯示名稱 單位 彙總類型 描述 維度
AdvancedFilterEvaluationCount Yes 進階篩選評估 計數 總數 針對此主題事件訂閱評估的進階篩選總數。 EventSubscriptionName
DeadLetteredCount Yes 失效信件事件 計數 總數 與此事件訂閱相符的失效信件事件總數 DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount No 傳遞失敗的事件 計數 總數 傳遞到此事件訂閱失敗的事件總數 Error、ErrorType、EventSubscriptionName
DeliverySuccessCount Yes 已傳遞的事件 計數 總數 已傳遞到此事件訂閱的事件總數 EventSubscriptionName
DestinationProcessingDurationInMs No 目的端處理持續期間 毫秒 平均 目的端處理持續期間,以毫秒為單位 EventSubscriptionName
DroppedEventCount Yes 卸除的事件 計數 總數 與此事件訂閱相符的已卸除事件總數 DropReason, EventSubscriptionName
MatchedEventCount Yes 相符的事件 計數 總數 與此事件訂閱相符的事件總數 EventSubscriptionName
PublishFailCount Yes 發行失敗的事件 計數 總數 發佈至本主題失敗的事件總數 ErrorType、Error
PublishSuccessCount Yes 已發佈的事件 計數 總數 發佈至本主題的事件總數 無維度
PublishSuccessLatencyInMs Yes 發行成功延遲 毫秒 總數 發佈成功延遲 (以毫秒計) 無維度
UnmatchedEventCount Yes 不相符的事件 計數 總數 不符合本主題中任何事件訂閱的事件總數 無維度

資源記錄

診斷設定可讓事件方格使用者擷取和檢視儲存體帳戶、事件中樞或 Log Analytics 工作區中的 [發佈和傳遞失敗] 記錄。 本文提供記錄和範例記錄項目的結構描述。

發佈/傳遞失敗記錄的結構描述

屬性名稱 資料類型 描述
Time Datetime 產生記錄項目時的時間

範例值:01-29-2020 09:52:02.700

EventSubscriptionName String 事件訂用帳戶的名稱

範例值:"EVENTSUB1"

此屬性僅適用於傳遞失敗記錄。

類別 String 記錄類別名稱。

範例值:"DeliveryFailures" 或 "PublishFailures"

OperationName String 造成失敗作業的名稱。

範例值:傳遞失敗為 "Deliver"。

訊息 String 使用者的記錄訊息,說明失敗的原因和其他詳細資料。
ResourceId String 主題/網域資源的資源識別碼

範例值: /SUBSCRIPTIONS/SAMPLE-SUBSCRIPTION-ID/RESOURCEGROUPS/SAMPLE-RESOURCEGROUP/PROVIDERS/MICROSOFT.EVENTGRID/TOPICS/TOPIC1

範例 - 發佈/傳遞失敗記錄的結構描述

{
    "time": "2019-11-01T00:17:13.4389048Z",
    "resourceId": "/SUBSCRIPTIONS/SAMPLE-SUBSCRIPTION-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 可能的值為 NotFoundAbortedTimedOutGenericErrorBusy。 事件方格會將其從事件處理常式接收的任何資訊記錄在 message 中。 例如,針對 GenericError,其會記錄 HTTP 狀態碼、錯誤碼和錯誤訊息。

資料平面作業記錄的結構描述

屬性名稱 資料類型 描述
NetworkAccess String 允許的值包括:
- PublicAccess - 透過公用 IP 連線時
- PrivateAccess - 透過私人連結連線時
ClientIpAddress String 連入要求的來源 IP
TlsVersion String 用戶端連線所使用的傳輸層安全性 (TLS) 版本。 可能的值為:1.01.11.2
Authentication/Type String 發佈訊息時用於驗證的秘密類型。
-Key – 要求會使用 SAS 金鑰
- SASToken – 要求會使用 SAS 金鑰所產生的 SAS 權杖
- AADAccessToken – Microsoft Entra ID 發行的 JSON Web 權杖 (JWT) 權杖
- Unknown – 上述驗證類型皆非。 OPTIONS 要求擁有此驗證類型
Authentication/ObjectId String 驗證類型設定為 AADAccessToken 時所使用服務主體的 ObjectId
OperationResult String 發佈的結果。 可能的值包括:
- 成功
- 未經授權
- 禁止
- RequestEntityTooLarge
- BadRequest
- InternalServerError
TotalOperations String 不會針對每個發佈要求發出這些追蹤。 每個唯一組合 (每分鐘都會發出上述值) 的彙總

範例:資料平面要求的結構描述

{
    "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 診斷設定之後,事件方格資源會開始發佈資料平面作業的稽核追蹤,包括公用和私人存取作業。 此追蹤可能會視需要記錄一或多個要求。

下一步

若要了解如何啟用主題或網域的診斷記錄,請參閱啟用診斷記錄