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 예제 값: |
예제 - 게시/전달 오류 로그의 스키마
{
"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 리소스는 퍼블릭 및 프라이빗 액세스 작업을 포함한 데이터 평면 작업의 감사 추적 게시를 시작합니다. 이 추적은 필요한 경우 하나 이상의 요청을 로그할 수 있습니다.
다음 단계
토픽 또는 도메인에 대해 진단 로그를 사용하도록 설정하는 방법을 알아보려면 진단 로그 사용을 참조하세요.