다음을 통해 공유


Azure Event Grid의 푸시 이벤트 배달에 대한 데이터 참조 모니터링

이 문서에서는 Azure Event Grid 푸시 배달의 성능 및 가용성을 분석하기 위해 수집된 로그 및 메트릭 데이터에 대한 참조를 제공합니다.

Important

이 기능은 현재 미리 보기로 제공됩니다.

메트릭

Microsoft.EventGrid/domains

메트릭 진단 설정을 통해 내보내기 가능? 메트릭 표시 이름 단위 집계 유형 설명 차원
AdvancedFilterEvaluationCount 고급 필터 평가 Count 합계 이 토픽의 이벤트 구독에서 평가되는 총 고급 필터 수. 토픽, EventSubscriptionName, DomainEventSubscriptionName
DeadLetteredCount 배달 못한 편지 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 배달 못한 이벤트 토픽, EventSubscriptionName, DomainEventSubscriptionName, DeadLetterReason
DeliveryAttemptFailCount 아니요 배달 실패 이벤트 Count 합계 이 이벤트 구독에 배달하지 못한 총 이벤트 토픽, EventSubscriptionName, DomainEventSubscriptionName, 오류, ErrorType
DeliverySuccessCount 배달된 이벤트 Count 합계 이 이벤트 구독에 배달된 총 이벤트 토픽, EventSubscriptionName, DomainEventSubscriptionName
DestinationProcessingDurationInMs 아니요 대상 처리 기간 밀리초 평균 대상 처리 기간(밀리초) 토픽, EventSubscriptionName, DomainEventSubscriptionName
DroppedEventCount 삭제된 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 삭제된 이벤트 토픽, EventSubscriptionName, DomainEventSubscriptionName, DropReason
MatchedEventCount 일치하는 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 이벤트 토픽, EventSubscriptionName, DomainEventSubscriptionName
PublishFailCount 실패한 이벤트 게시 Count 합계 이 토픽에 게시하지 못한 총 이벤트 토픽, ErrorType, 오류
PublishSuccessCount 게시된 이벤트 Count 합계 이 토픽에 게시된 총 이벤트 항목
PublishSuccessLatencyInMs 게시 성공 대기 시간 밀리초 총계 게시 성공 대기 시간(밀리초) 차원 없음

Microsoft.EventGrid/eventSubscriptions

메트릭 진단 설정을 통해 내보내기 가능? 메트릭 표시 이름 단위 집계 유형 설명 차원
DeadLetteredCount 배달 못한 편지 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 배달 못한 이벤트 DeadLetterReason
DeliveryAttemptFailCount 아니요 배달 실패 이벤트 Count 합계 이 이벤트 구독에 배달하지 못한 총 이벤트 Error, ErrorType
DeliverySuccessCount 배달된 이벤트 Count 합계 이 이벤트 구독에 배달된 총 이벤트 차원 없음
DestinationProcessingDurationInMs 아니요 대상 처리 기간 밀리초 평균 대상 처리 기간(밀리초) 차원 없음
DroppedEventCount 삭제된 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 삭제된 이벤트 DropReason
MatchedEventCount 일치하는 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 이벤트 차원 없음

Microsoft.EventGrid/extensionTopics

메트릭 진단 설정을 통해 내보내기 가능? 메트릭 표시 이름 단위 집계 유형 설명 차원
PublishFailCount 실패한 이벤트 게시 Count 합계 이 토픽에 게시하지 못한 총 이벤트 ErrorType, Error
PublishSuccessCount 게시된 이벤트 Count 합계 이 토픽에 게시된 총 이벤트 차원 없음
PublishSuccessLatencyInMs 게시 성공 대기 시간 밀리초 총계 게시 성공 대기 시간(밀리초) 차원 없음
UnmatchedEventCount 일치하지 않는 이벤트 Count 합계 이 토픽에 대한 이벤트 구독과 일치하지 않는 총 이벤트 차원 없음

Microsoft.EventGrid/partnerNamespaces

메트릭 진단 설정을 통해 내보내기 가능? 메트릭 표시 이름 단위 집계 유형 설명 차원
PublishFailCount 실패한 이벤트 게시 Count 합계 이 파트너 네임스페이스에 게시되지 않은 총 이벤트 ErrorType, Error
PublishSuccessCount 게시된 이벤트 Count 합계 이 파트너 네임스페이스에 게시된 총 이벤트 차원 없음
PublishSuccessLatencyInMs 게시 성공 대기 시간 밀리초 총계 게시 성공 대기 시간(밀리초) 차원 없음
UnmatchedEventCount 일치하지 않는 이벤트 Count 합계 파트너 토픽과 일치하지 않는 총 이벤트 차원 없음

Microsoft.EventGrid/partnerTopics

메트릭 진단 설정을 통해 내보내기 가능? 메트릭 표시 이름 단위 집계 유형 설명 차원
AdvancedFilterEvaluationCount 고급 필터 평가 Count 합계 이 파트너 토픽의 모든 이벤트 구독에서 평가된 총 고급 필터 수입니다. EventSubscriptionName
DeadLetteredCount 배달 못한 편지 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 배달 못한 이벤트 DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount 아니요 배달 실패 이벤트 Count 합계 이 이벤트 구독에 배달하지 못한 총 이벤트 오류, ErrorType, EventSubscriptionName
DeliverySuccessCount 배달된 이벤트 Count 합계 이 이벤트 구독에 배달된 총 이벤트 EventSubscriptionName
DestinationProcessingDurationInMs 아니요 대상 처리 기간 밀리초 평균 대상 처리 기간(밀리초) EventSubscriptionName
DroppedEventCount 삭제된 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 삭제된 이벤트 DropReason, EventSubscriptionName
MatchedEventCount 일치하는 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 이벤트 EventSubscriptionName
PublishSuccessCount 게시된 이벤트 Count 합계 이 파트너 토픽에 게시된 총 이벤트 차원 없음
UnmatchedEventCount 일치하지 않는 이벤트 Count 합계 이 파트너 토픽의 이벤트 구독과 일치하지 않는 총 이벤트 차원 없음

Microsoft.EventGrid/systemTopics

메트릭 진단 설정을 통해 내보내기 가능? 메트릭 표시 이름 단위 집계 유형 설명 차원
AdvancedFilterEvaluationCount 고급 필터 평가 Count 합계 이 토픽의 이벤트 구독에서 평가되는 총 고급 필터 수. EventSubscriptionName
DeadLetteredCount 배달 못한 편지 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 배달 못한 이벤트 DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount 아니요 배달 실패 이벤트 Count 합계 이 이벤트 구독에 배달하지 못한 총 이벤트 오류, ErrorType, EventSubscriptionName
DeliverySuccessCount 배달된 이벤트 Count 합계 이 이벤트 구독에 배달된 총 이벤트 EventSubscriptionName
DestinationProcessingDurationInMs 아니요 대상 처리 기간 밀리초 평균 대상 처리 기간(밀리초) EventSubscriptionName
DroppedEventCount 삭제된 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 삭제된 이벤트 DropReason, EventSubscriptionName
MatchedEventCount 일치하는 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 이벤트 EventSubscriptionName
PublishFailCount 실패한 이벤트 게시 Count 합계 이 토픽에 게시하지 못한 총 이벤트 ErrorType, Error
PublishSuccessCount 게시된 이벤트 Count 합계 이 토픽에 게시된 총 이벤트 차원 없음
PublishSuccessLatencyInMs 게시 성공 대기 시간 밀리초 총계 게시 성공 대기 시간(밀리초) 차원 없음
UnmatchedEventCount 일치하지 않는 이벤트 Count 합계 이 토픽에 대한 이벤트 구독과 일치하지 않는 총 이벤트 차원 없음

Microsoft.EventGrid/topics

메트릭 진단 설정을 통해 내보내기 가능? 메트릭 표시 이름 단위 집계 유형 설명 차원
AdvancedFilterEvaluationCount 고급 필터 평가 Count 합계 이 토픽의 이벤트 구독에서 평가되는 총 고급 필터 수. EventSubscriptionName
DeadLetteredCount 배달 못한 편지 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 배달 못한 이벤트 DeadLetterReason, EventSubscriptionName
DeliveryAttemptFailCount 아니요 배달 실패 이벤트 Count 합계 이 이벤트 구독에 배달하지 못한 총 이벤트 오류, ErrorType, EventSubscriptionName
DeliverySuccessCount 배달된 이벤트 Count 합계 이 이벤트 구독에 배달된 총 이벤트 EventSubscriptionName
DestinationProcessingDurationInMs 아니요 대상 처리 기간 밀리초 평균 대상 처리 기간(밀리초) EventSubscriptionName
DroppedEventCount 삭제된 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 삭제된 이벤트 DropReason, EventSubscriptionName
MatchedEventCount 일치하는 이벤트 Count 합계 이 이벤트 구독에 일치하는 총 이벤트 EventSubscriptionName
PublishFailCount 실패한 이벤트 게시 Count 합계 이 토픽에 게시하지 못한 총 이벤트 ErrorType, Error
PublishSuccessCount 게시된 이벤트 Count 합계 이 토픽에 게시된 총 이벤트 차원 없음
PublishSuccessLatencyInMs 게시 성공 대기 시간 밀리초 총계 게시 성공 대기 시간(밀리초) 차원 없음
UnmatchedEventCount 일치하지 않는 이벤트 Count 합계 이 토픽에 대한 이벤트 구독과 일치하지 않는 총 이벤트 차원 없음

리소스 로그

진단 설정을 통해 Event Grid 사용자는 스토리지 계정, 이벤트 허브 또는 Log Analytics 작업 영역 중 하나에서 게시 및 전달 오류 로그를 캡처하고 볼 수 있습니다. 이 문서에서는 로그 및 예제 로그 항목에 대한 스키마를 제공합니다.

게시/전달 오류 로그의 스키마

속성 이름 데이터 형식 설명
Time DateTime 로그 항목이 생성된 시간

예제 값: 01-29-2020 09:52:02.700

EventSubscriptionName 문자열 이벤트 구독의 이름

예제 값: ‘EVENTSUB1’

이 속성은 전달 오류 로그에 대해서만 존재합니다.

범주 문자열 로그 카테고리 이름.

예제 값: ‘DeliveryFailures’ 또는 ‘PublishFailures’

OperationName 문자열 오류의 원인인 작업의 이름입니다.

예제 값: 전달 오류의 경우 ‘Deliver’.

메시지 문자열 오류의 원인과 추가 정보를 설명하는 사용자에 대한 로그 메시지입니다.
ResourceId 문자열 토픽/도메인 리소스에 대한 리소스 ID

예제 값: /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의 가능한 값은 NotFound, Aborted, TimedOut, GenericError, Busy입니다. Event Grid는 message의 이벤트 처리기에서 받은 모든 정보를 로그합니다. 예를 들어 GenericError의 경우 HTTP 상태 코드, 오류 코드 및 오류 메시지를 로그합니다.

데이터 평면 작업 로그에 대한 스키마

속성 이름 데이터 형식 설명
NetworkAccess 문자열 허용되는 값:
- PublicAccess - 공용 IP를 통해 연결할 때
- PrivateAccess - 프라이빗 링크를 통해 연결할 때
ClientIpAddress 문자열 들어오는 요청의 원본 IP
TlsVersion 문자열 클라이언트 연결에서 사용하는 TLS(전송 계층 보안) 버전. 가능한 값: 1.0, 1.1, 1.2
Authentication/Type 문자열 메시지를 게시할 때 인증에 사용되는 비밀 유형입니다.
-Key – 요청이 SAS 키를 사용합니다.
- SASToken – 요청이 SAS 에서 생성된 SAS 토큰을 사용합니다.
- AADAccessToken – Microsoft Entra ID에서 JWT(JSON Web Token) 토큰을 발급함
- Unknown – 위 인증 유형 중 해당 사항이 없습니다. OPTIONS 요청에는 이 인증 유형 포함
Authentication/ObjectId 문자열 인증 유형이 AADAccessToken으로 설정된 경우 사용되는 서비스 주체의 ObjectId
OperationResult 문자열 게시의 결과. 가능한 값은 다음과 같습니다.
- 성공
- Unauthorized
- Forbidden
- RequestEntityTooLarge
- BadRequest
- InternalServerError
TotalOperations 문자열 이 추적은 각 게시 요청에 대해 내보내지 않습니다. 위 값의 각 고유 조합에 대한 집계는 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 리소스는 퍼블릭 및 프라이빗 액세스 작업을 포함한 데이터 평면 작업의 감사 추적 게시를 시작합니다. 이 추적은 필요한 경우 하나 이상의 요청을 로그할 수 있습니다.

다음 단계

토픽 또는 도메인에 대해 진단 로그를 사용하도록 설정하는 방법을 알아보려면 진단 로그 사용을 참조하세요.