Azure Event Hubs 모니터링 데이터 참조
이 문서에는 이 서비스에 대한 모든 모니터링 참조 정보가 포함되어 있습니다.
Event Hubs에 대해 수집할 수 있는 데이터 및 사용 방법에 대한 자세한 내용은 Azure Event Hubs 모니터링을 참조하세요.
Azure Event Hubs는 Azure의 전체 스택 모니터링 서비스인 Azure Monitor를 사용하여 모니터링 데이터를 만듭니다. Azure Monitor는 Azure 리소스를 모니터링하기 위한 완전한 기능 세트를 제공합니다. 또한 다른 클라우드 및 온-프레미스의 리소스도 모니터링할 수 있습니다.
Azure Event Hubs는 Azure 리소스의 모니터링 데이터에 설명된 다른 Azure 리소스와 동일한 종류의 모니터링 데이터를 수집합니다.
메트릭
이 섹션에는 이 서비스에 대해 자동으로 모은 플랫폼 메트릭이 모두 나열되어 있습니다. 이러한 메트릭은 Azure Monitor에서 지원되는 모든 플랫폼 메트릭의 전역 목록의 일부이기도 합니다.
메트릭 보존에 관한 자세한 내용은 Azure Monitor 메트릭 개요를 참조하세요.
Microsoft.EventHub/클러스터에 대해 지원되는 메트릭
다음 표에서는 Microsoft.EventHub/클러스터 리소스 종류에 사용할 수 있는 메트릭을 나열합니다.
- 모든 테이블에 모든 열이 있는 것은 아닙니다.
- 일부 열은 페이지의 보기 영역 밖에 있을 수 있습니다. 사용 가능한 모든 열을 보려면 테이블 확장을 선택합니다.
테이블 제목
- 범주 - 메트릭 그룹 또는 분류입니다.
- 메트릭 - Azure Portal에 표시되는 메트릭 표시 이름입니다.
- REST API의 이름 - REST API에서 참조되는 메트릭 이름입니다.
- 단위 - 측정 단위입니다.
- 집계 - 기본 집계 형식입니다. 유효한 값은 평균(Avg), 최소(Min), 최대(Max), 합계(Sum), 개수입니다.
- 차원 - 메트릭에 사용할 수 있는 차원입니다.
- 시간 조직 - 메트릭이 샘플링되는 간격입니다. 예를 들어,
PT1M은 메트릭이 1분마다,PT30M은 30분마다,PT1H는 1시간마다 샘플링됨을 나타냅니다. - DS 내보내기- 진단 설정을 통해 메트릭을 Azure Monitor 로그로 내보낼 수 있는지 여부를 나타냅니다. 메트릭 내보내기에 대한 자세한 내용은 Azure Monitor의 진단 설정 생성을 참조하세요.
| 메트릭 | REST API의 이름 | 단위 | 집계 | 차원 | 시간 조직 | DS 내보내기 |
|---|---|---|---|---|---|---|
| ActiveConnections Microsoft.EventHub에 대한 총 활성 연결입니다. |
ActiveConnections |
Count | 평균 | <없음> | PT1M | 아니요 |
| 사용 가능한 메모리 이벤트 허브 클러스터에 사용할 수 있는 메모리. 총 메모리의 백분율로 표시합니다. |
AvailableMemory |
Percent | 최대 | Role |
PT1M | 아니요 |
| 캡처 백로그. Microsoft.EventHub에 대한 캡처 백로그입니다. |
CaptureBacklog |
Count | 합계(Sum) | <없음> | PT1M | 아니요 |
| 캡처된 바이트입니다. Microsoft.EventHub에 대해 캡처된 바이트입니다. |
CapturedBytes |
바이트 | 합계(Sum) | <없음> | PT1M | 아니요 |
| 캡처된 메시지입니다. Microsoft.EventHub에 대한 캡처된 메시지. |
CapturedMessages |
Count | 합계(Sum) | <없음> | PT1M | 아니요 |
| 연결이 닫혔습니다. Microsoft.EventHub에 대한 연결이 닫혔습니다. |
ConnectionsClosed |
Count | 평균 | <없음> | PT1M | 아니요 |
| 연결이 열렸습니다. Microsoft.EventHub에 대해 열린 연결입니다. |
ConnectionsOpened |
Count | 평균 | <없음> | PT1M | 아니요 |
| CPU 이벤트 허브 클러스터에 대한 CPU 사용률(백분율) |
CPU |
Percent | 최대 | Role |
PT1M | 아니요 |
| 들어오는 바이트입니다. Microsoft.EventHub에 대한 들어오는 바이트입니다. |
IncomingBytes |
바이트 | 합계(Sum) | <없음> | PT1M | 예 |
| 들어오는 메시지 Microsoft.EventHub에 대한 들어오는 메시지입니다. |
IncomingMessages |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 들어오는 요청 Microsoft.EventHub에 대한 들어오는 요청입니다. |
IncomingRequests |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 나가는 바이트입니다. Microsoft.EventHub에 대한 나가는 바이트입니다. |
OutgoingBytes |
바이트 | 합계(Sum) | <없음> | PT1M | 예 |
| 보내는 메시지 Microsoft.EventHub에 대한 보내는 메시지입니다. |
OutgoingMessages |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 할당량 초과 오류입니다. Microsoft.EventHub에 대한 할당량 초과 오류입니다. |
QuotaExceededErrors |
Count | 합계(Sum) | OperationResult |
PT1M | 아니요 |
| 서버 오류입니다. Microsoft.EventHub에 대한 서버 오류입니다. |
ServerErrors |
Count | 합계(Sum) | OperationResult |
PT1M | 아니요 |
| 크기 EventHub의 크기(바이트)입니다. |
Size |
바이트 | 평균, 최소, 최대 | Role |
PT1M | 아니요 |
| 성공한 요청 Microsoft.EventHub에 대한 성공한 요청. |
SuccessfulRequests |
Count | 합계(Sum) | OperationResult |
PT1M | 아니요 |
| 제한된 요청. Microsoft.EventHub에 대한 제한된 요청입니다. |
ThrottledRequests |
Count | 합계(Sum) | OperationResult |
PT1M | 아니요 |
| 사용자 오류입니다. Microsoft.EventHub에 대한 사용자 오류입니다. |
UserErrors |
Count | 합계(Sum) | OperationResult |
PT1M | 아니요 |
Microsoft.EventHub/네임스페이스에 대해 지원되는 메트릭
다음 표에서는 Microsoft.EventHub/Namespaces 리소스 종류에 사용할 수 있는 메트릭을 나열합니다.
- 모든 테이블에 모든 열이 있는 것은 아닙니다.
- 일부 열은 페이지의 보기 영역 밖에 있을 수 있습니다. 사용 가능한 모든 열을 보려면 테이블 확장을 선택합니다.
테이블 제목
- 범주 - 메트릭 그룹 또는 분류입니다.
- 메트릭 - Azure Portal에 표시되는 메트릭 표시 이름입니다.
- REST API의 이름 - REST API에서 참조되는 메트릭 이름입니다.
- 단위 - 측정 단위입니다.
- 집계 - 기본 집계 형식입니다. 유효한 값은 평균(Avg), 최소(Min), 최대(Max), 합계(Sum), 개수입니다.
- 차원 - 메트릭에 사용할 수 있는 차원입니다.
- 시간 조직 - 메트릭이 샘플링되는 간격입니다. 예를 들어,
PT1M은 메트릭이 1분마다,PT30M은 30분마다,PT1H는 1시간마다 샘플링됨을 나타냅니다. - DS 내보내기- 진단 설정을 통해 메트릭을 Azure Monitor 로그로 내보낼 수 있는지 여부를 나타냅니다. 메트릭 내보내기에 대한 자세한 내용은 Azure Monitor의 진단 설정 생성을 참조하세요.
| 메트릭 | REST API의 이름 | 단위 | 집계 | 차원 | 시간 조직 | DS 내보내기 |
|---|---|---|---|---|---|---|
| ActiveConnections Microsoft.EventHub에 대한 총 활성 연결입니다. |
ActiveConnections |
Count | 최대, 최소, 평균 | <없음> | PT1M | 아니요 |
| 캡처 백로그. Microsoft.EventHub에 대한 캡처 백로그입니다. |
CaptureBacklog |
Count | 합계(Sum) | EntityName |
PT1M | 아니요 |
| 캡처된 바이트입니다. Microsoft.EventHub에 대해 캡처된 바이트입니다. |
CapturedBytes |
바이트 | 합계(Sum) | EntityName |
PT1M | 아니요 |
| 캡처된 메시지입니다. Microsoft.EventHub에 대한 캡처된 메시지. |
CapturedMessages |
Count | 합계(Sum) | EntityName |
PT1M | 아니요 |
| 연결이 닫혔습니다. Microsoft.EventHub에 대한 연결이 닫혔습니다. |
ConnectionsClosed |
Count | 최댓값 | EntityName |
PT1M | 아니요 |
| 연결이 열렸습니다. Microsoft.EventHub에 대해 열린 연결입니다. |
ConnectionsOpened |
Count | 최댓값 | EntityName |
PT1M | 아니요 |
| 백로그 메시지 보관(사용되지 않음) 네임스페이스에 대한 백로그의 Event Hub 보관 메시지(사용되지 않음) |
EHABL |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 메시지 처리량 보관(사용되지 않음) 네임스페이스의 Event Hub 보관된 메시지 처리량(사용되지 않음) |
EHAMBS |
바이트 | 합계(Sum) | <없음> | PT1M | 예 |
| 메시지 보관(사용되지 않음) 네임스페이스의 Event Hub 보관 메시지 수(사용되지 않음) |
EHAMSGS |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 들어오는 바이트(사용되지 않음) 네임스페이스에 대한 Event Hub 수신 메시지 처리량(사용되지 않음) |
EHINBYTES |
바이트 | 합계(Sum) | <없음> | PT1M | 예 |
| 들어오는 바이트(사용되지 않음)(사용되지 않음) 네임스페이스에 대한 Event Hub 들어오는 메시지 처리량입니다. 이 메트릭은 더 이상 사용되지 않습니다. 대신 들어오는 바이트 메트릭을 사용하세요(사용되지 않음). |
EHINMBS |
바이트 | 합계(Sum) | <없음> | PT1M | 예 |
| 들어오는 메시지(사용되지 않음) 네임스페이스에 대한 총 수신 메시지 수(사용되지 않음) |
EHINMSGS |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 나가는 바이트(사용되지 않음) 네임스페이스에 대한 Event Hub 나가는 메시지 처리량(사용되지 않음) |
EHOUTBYTES |
바이트 | 합계(Sum) | <없음> | PT1M | 예 |
| 나가는 바이트(사용되지 않음)(사용되지 않음) 네임스페이스에 보내는 Event Hub 메시지 처리량 이 메트릭은 더 이상 사용되지 않습니다. 대신 나가는 바이트 메트릭을 사용하세요(사용되지 않음). |
EHOUTMBS |
바이트 | 합계(Sum) | <없음> | PT1M | 예 |
| 보내는 메시지(사용되지 않음) 네임스페이스에 대한 총 발신 메시지(사용되지 않음) |
EHOUTMSGS |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 실패한 요청(사용되지 않음) 네임스페이스에 대해 실패한 총 요청(사용되지 않음) |
FAILREQ |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 들어오는 바이트입니다. Microsoft.EventHub에 대한 들어오는 바이트입니다. |
IncomingBytes |
바이트 | 합계(Sum) | EntityName |
PT1M | 예 |
| 들어오는 메시지 Microsoft.EventHub에 대한 들어오는 메시지입니다. |
IncomingMessages |
Count | 합계(Sum) | EntityName |
PT1M | 예 |
| 들어오는 요청 Microsoft.EventHub에 대한 들어오는 요청입니다. |
IncomingRequests |
Count | 합계(Sum) | EntityName |
PT1M | 예 |
| 들어오는 메시지(사용되지 않음)(사용되지 않음) 네임스페이스에 들어오는 총 메시지 수 이 메트릭은 더 이상 사용되지 않습니다. 대신 들어오는 메시지 메트릭을 사용하세요(사용되지 않음). |
INMSGS |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 들어오는 요청(사용되지 않음) 네임스페이스에 대해 들어오는 총 송신 요청(사용되지 않음) |
INREQS |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 내부 서버 오류(사용되지 않음) 네임스페이스에 대한 총 내부 서버 오류(사용되지 않음) |
INTERR |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 기타 오류(사용되지 않음) 네임스페이스에 대해 실패한 총 요청(사용되지 않음) |
MISCERR |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| CPU 프리미엄 SKU 네임스페이스에 대한 CPU 사용량 메트릭입니다. |
NamespaceCpuUsage |
Percent | 최대, 최소, 평균 | Replica |
PT1M | 아니요 |
| 메모리 사용량 프리미엄 SKU 네임스페이스에 대한 메모리 사용량 메트릭입니다. |
NamespaceMemoryUsage |
Percent | 최대, 최소, 평균 | Replica |
PT1M | 아니요 |
| 나가는 바이트입니다. Microsoft.EventHub에 대한 나가는 바이트입니다. |
OutgoingBytes |
바이트 | 합계(Sum) | EntityName |
PT1M | 예 |
| 보내는 메시지 Microsoft.EventHub에 대한 보내는 메시지입니다. |
OutgoingMessages |
Count | 합계(Sum) | EntityName |
PT1M | 예 |
| 보내는 메시지(사용되지 않음)(사용되지 않음) 네임스페이스에 대한 총 발신 메시지입니다. 이 메트릭은 더 이상 사용되지 않습니다. 이 메트릭 대신 보내는 메시지 메트릭을 사용하세요. |
OUTMSGS |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 할당량 초과 오류입니다. Microsoft.EventHub에 대한 할당량 초과 오류입니다. |
QuotaExceededErrors |
Count | 합계(Sum) | EntityName, OperationResult |
PT1M | 아니요 |
| ReplicationLagCount 메시지 수별 복제 지연 |
ReplicationLagCount |
Count | 최대, 최소, 평균 | EntityName |
PT1M | 아니요 |
| ReplicationLagDuration 기간별 복제 지연 |
ReplicationLagDuration |
초 | 최대, 최소, 평균 | EntityName |
PT1M | 예 |
| 서버 오류입니다. Microsoft.EventHub에 대한 서버 오류입니다. |
ServerErrors |
Count | 합계(Sum) | EntityName, OperationResult |
PT1M | 아니요 |
| 크기 EventHub의 크기(바이트)입니다. |
Size |
바이트 | 평균, 최소, 최대 | EntityName |
PT1M | 아니요 |
| 성공한 요청 Microsoft.EventHub에 대한 성공한 요청. |
SuccessfulRequests |
Count | 합계(Sum) | EntityName, OperationResult |
PT1M | 아니요 |
| 성공한 요청(사용되지 않음) 네임스페이스에 대한 총 성공한 요청(사용되지 않음) |
SUCCREQ |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 서버 사용 중 오류(사용되지 않음) 네임스페이스에 대한 총 서버 작업 중 오류 수(사용되지 않음) |
SVRBSY |
Count | 합계(Sum) | <없음> | PT1M | 예 |
| 제한된 요청. Microsoft.EventHub에 대한 제한된 요청입니다. |
ThrottledRequests |
Count | 합계(Sum) | EntityName, OperationResult |
PT1M | 아니요 |
| 사용자 오류입니다. Microsoft.EventHub에 대한 사용자 오류입니다. |
UserErrors |
Count | 합계(Sum) | EntityName, OperationResult |
PT1M | 아니요 |
다음 표에는 Azure Event Hubs에 대해 수집된 모든 자동으로 수집된 플랫폼 메트릭이 나열되어 있습니다. 이러한 메트릭에 대한 리소스 공급자는 Microsoft.EventHub/clusters 다음과 Microsoft.EventHub/namespaces같습니다.
요청 메트릭은 데이터 및 관리 작업 요청 수를 계산합니다. 이 표에서는 이전 테이블의 값에 대한 자세한 정보를 제공합니다.
| 메트릭 이름 | 설명 |
|---|---|
| 들어오는 요청 | 지정된 기간 동안 Event Hubs 서비스에 대한 요청 수입니다. 이 메트릭에는 모든 데이터 및 관리 평면 작업이 포함됩니다. |
| 성공한 요청 | 지정된 기간 동안 Event Hubs 서비스에 대한 성공한 요청 수입니다. |
| 제한된 요청 | 사용량 초과로 인해 제한된 요청 수입니다. |
이 표에서는 이전 테이블의 메시지 메트릭에 대한 자세한 정보를 제공합니다.
| 메트릭 이름 | 설명 |
|---|---|
| 들어오는 메시지 | 지정된 기간 동안 Event Hubs로 전송된 이벤트 또는 메시지 수입니다. |
| 보내는 메시지 | 지정된 기간 동안 Event Hubs에서 받은 이벤트 또는 메시지 수입니다. |
| 캡처된 메시지 | 캡처된 메시지의 수입니다. |
| 들어오는 바이트 | 지정된 기간 동안 이벤트 허브의 들어오는 바이트입니다. |
| 나가는 바이트 | 지정된 기간 동안 이벤트 허브에 대해 나가는 바이트입니다. |
| 크기 | 이벤트 허브의 크기(바이트)입니다. |
참고 항목
- 이러한 값은 지정 시간 값입니다. 해당 지정 시간 직후에 사용되는 들어오는 메시지는 이러한 메트릭에 반영되지 않을 수 있습니다.
- 들어오는 요청 메트릭에는 모든 데이터 및 관리 평면 작업이 포함됩니다. 들어오는 메시지 메트릭은 이벤트 허브로 전송되는 총 이벤트 수를 제공합니다. 예를 들어 이벤트 허브에 100개의 이벤트 일괄 처리를 보내는 경우 들어오는 요청 1개와 들어오는 메시지 100개로 계산됩니다.
이 표에서는 이전 테이블의 캡처 메트릭에 대한 자세한 정보를 제공합니다.
| 메트릭 이름 | 설명 |
|---|---|
| 캡처된 메시지 | 캡처된 메시지의 수입니다. |
| 캡처된 바이트 | 이벤트 허브에 대해 캡처된 바이트입니다. |
| 캡처 백로그 | 이벤트 허브에 대한 백로그를 캡처합니다. |
이 표에서는 이전 테이블의 연결 메트릭에 대한 자세한 정보를 제공합니다.
| 메트릭 이름 | 설명 |
|---|---|
| 활성 연결 | 네임스페이스와 네임스페이스의 엔터티(이벤트 허브)에 대한 활성 연결 수입니다. 해당 메트릭의 값은 지정 시간 값입니다. 해당 시점 직후에 활성화된 연결은 이 메트릭에 반영되지 않을 수 있습니다. |
| 열린 연결 | 열린 연결 수입니다. |
| 닫힌 연결 | 닫힌 연결 수입니다. |
이 표에서는 이전 테이블의 오류 메트릭에 대한 자세한 정보를 제공합니다.
| 메트릭 이름 | 설명 |
|---|---|
| 서버 오류 | 지정된 기간 동안 Event Hubs 서비스의 오류로 인해 처리되지 않은 요청 수입니다. |
| User Errors | 지정된 기간 동안 사용자 오류로 인해 처리되지 않은 요청 수입니다. |
| 할당량 초과 오류 | 지정된 기간 동안 할당량을 초과하여 발생한 오류 수입니다. |
다음 두 가지 유형의 오류는 사용자 오류로 분류됩니다.
- 클라이언트 쪽 오류(HTTP에서 400개 오류).
- 메시지를 처리하는 동안 발생하는 오류입니다.
참고 항목
Logic Apps는 Epoch 수신기를 만듭니다. 수신기는 서비스 부하에 따라 한 노드에서 다른 노드로 이동할 수 있습니다. 이러한 이동 중에 예외가 ReceiverDisconnection 발생할 수 있습니다. Event Hubs 서비스 쪽에서 사용자 오류로 계산됩니다. Logic Apps는 Event Hubs 클라이언트에서 오류를 수집하여 사용자 로그에서 볼 수 있습니다.
메트릭 차원
메트릭 차원에 대한 자세한 내용은 다차원 메트릭을 참조하세요.
이 서비스에는 메트릭과 관련된 다음과 같은 차원이 있습니다.
| 차원 이름 | 설명 |
|---|---|
| EntityName | 이벤트 허브의 이름입니다. '들어오는 요청' 메트릭을 사용하면 엔터티 이름 차원에 -NamespaceOnlyMetric- 모든 이벤트 허브 외에도 값이 있습니다. 네임스페이스 수준에서 만들어진 요청을 나타냅니다. 네임스페이스에 모든 이벤트 허브를 나열하라는 요청이나 인증 또는 권한 부여에 실패한 엔터티에 대한 요청을 예로 들 수 있습니다. |
| OperationResult | 표시하거나 적절한 오류 상태(예: serverbusy또는 clienterror quotaexceeded.)를 나타냅니다success. |
메트릭에 차원을 추가하는 것은 선택 사항입니다. 차원을 추가하지 않을 경우, 메트릭은 네임스페이스 수준에서 지정됩니다.
참고 항목
진단 설정에서 메트릭을 사용하도록 설정하는 경우 차원 정보는 현재 스토리지 계정, 이벤트 허브 또는 로그 분석으로 전송되는 정보의 일부로 포함되지 않습니다.
리소스 로그
이 섹션에는 이 서비스에 대해 모을 수 있는 리소스 로그 유형이 나열되어 있습니다. 이 섹션은 Azure Monitor에서 지원되는 모든 리소스 로그 범주 유형 목록에서 가져옵니다.
Microsoft.EventHub/Namespaces에 대해 지원되는 리소스 로그
| 범주 | 범주 표시 이름 | 로그 테이블 | 기본 로그 플랜 지원 | 수집 시간 변환 지원 | 예시 쿼리 | 내보낼 비용 |
|---|---|---|---|---|---|---|
ApplicationMetricsLogs |
애플리케이션 메트릭 로그 | AZMSApplicationMetricLogs Azure Event Hubs 및 Azure Service Bus에 대한 애플리케이션 메트릭(수신/발신, 성공/실패 등 메시지 배달)을 캡처합니다. |
예 | 아니요 | 예 | |
ArchiveLogs |
보관 로그 | AZMSArchiveLogs Event Hubs 캡처 작업, 특히 캡처 오류와 관련된 로그에 대한 정보를 캡처합니다. |
예 | 아니요 | 아니요 | |
AutoScaleLogs |
로그 자동 크기 조정 | AZMSAutoscaleLogs Event Hubs 네임스페이스에서 수행된 자동 확장 작업을 캡처합니다. |
예 | 아니요 | 아니요 | |
CustomerManagedKeyUserLogs |
고객 관리형 키 로그 | 아니요 | 아니요 | 아니요 | ||
DataDRLogs |
DataDR 로그 | AzureDiagnostics 여러 Azure 리소스의 로그. |
아니요 | 아니요 | 쿼리 | 예 |
DiagnosticErrorLogs |
진단 오류 로그 | AZMSDiagnosticErrorLogs Azure Event Hubs 및 Azure Service Bus에서 다양한 데이터 평면 액세스 작업(예: 메시지 보내기 또는 받기)에 대한 클라이언트 오류, 서버 사용 중 오류 및 할당량 초과 오류와 같은 집계된 진단 정보를 캡처합니다. |
예 | 아니요 | 쿼리 | 예 |
EventHubVNetConnectionEvent |
VNet/IP 필터링 연결 로그 | AZMSVnetConnectionEvents Azure Event Hubs 및 Azure Service Bus에 대한 모든 가상 네트워크 및 IP 필터링 로그를 캡처합니다. 네임스페이스가 선택한 네트워크 또는 특정 IP 주소(IP 필터 규칙)에서 액세스를 허용하는 경우에만 내보내집니다. |
예 | 아니요 | 쿼리 | 아니요 |
KafkaCoordinatorLogs |
Kafka 코디네이터 로그 | AZMSKafkaCoordinatorLogs Event Hubs와 관련된 kafka 코디네이터 작업을 캡처합니다. |
예 | 아니요 | 아니요 | |
KafkaUserErrorLogs |
Kafka 사용자 오류 로그 | AZMSKafkaUserErrorLogs Event Hubs에서 호출된 kafka API에 대한 정보를 캡처합니다. |
예 | 아니요 | 아니요 | |
OperationalLogs |
작업 로그 | AZMSOperationalLogs Azure Event Hubs/Azure Service Bus 네임스페이스 및 해당 엔터티에서 수행되는 모든 관리 작업을 캡처합니다. |
예 | 아니요 | 쿼리 | 아니요 |
RuntimeAuditLogs |
런타임 감사 로그 | AZMSRunTimeAuditLogs Azure Event Hubs 및 Azure Service Bus에서 다양한 데이터 평면 액세스 작업(예: 메시지 보내기 또는 받기)에 대한 집계된 진단 정보를 캡처합니다. 런타임 감사 로그는 현재 프리미엄 계층에서만 사용할 수 있습니다. |
예 | 아니요 | 쿼리 | 예 |
Azure Monitor 로그 테이블
이 섹션은 이 서비스와 관련이 있고 Kusto 쿼리를 사용하는 Log Analytics의 쿼리에 사용할 수 있는 Azure Monitor 로그 테이블을 나열합니다. 테이블에는 리소스 로그 데이터가 포함되며 수집 및 라우팅되는 항목에 따라 더 많은 데이터가 포함될 수 있습니다.
Event Hubs Microsoft.EventHub/namespaces
- AzureActivity
- AzureMetrics
- AzureDiagnostics
- AZMSApplicationMetricLogs
- AZMSOperationalLogs
- AZMSRunTimeAuditLogs
- AZMSDiagnosticErrorLogs
- AZMSVnetConnectionEvents
- AZMSArchiveLogs
- AZMSAutoscaleLogs
- AZMSKafkaCoordinatorLogs
- AZMSKafkaUserErrorLogs
- AZMSCustomerManagedKeyUserLogs
Event Hubs 리소스 로그
이제 Azure Event Hubs에는 Log Analytics의 Azure Diagnostic 또는 리소스별 테이블이라는 두 개의 대상 테이블 중 하나에 로그를 디스패치하는 기능이 있습니다. Azure Portal에서 사용할 수 있는 토글을 사용하여 대상 테이블을 선택할 수 있습니다.
Azure Event Hubs는 Azure Monitor 로그의 Kusto 테이블을 사용합니다. Log Analytics를 사용하여 이러한 테이블을 쿼리할 수 있습니다.
샘플 쿼리를 보고 다른 로그 범주를 시작할 수 있습니다.
Important
차원은 Log Analytics 작업 영역으로 내보내지지 않습니다.
Event Hubs는 다음 범주에 대한 진단 로그를 캡처합니다.
| 범주 | 설명 |
|---|---|
| 보관 로그 | Event Hubs 캡처 작업에 대한 정보, 특히 캡처 오류와 관련된 로그를 캡처합니다. |
| 작업 로그 | Azure Event Hubs 네임스페이스에서 수행되는 모든 관리 작업을 캡처합니다. 데이터 작업은 Azure Event Hubs에서 수행되는 대량의 데이터 작업으로 인해 캡처되지 않습니다. |
| 자동 크기 조정 로그 | Event Hubs 네임스페이스에서 수행된 자동 인플레이션 작업을 캡처합니다. |
| Kafka 코디네이터 로그 | Event Hubs와 관련된 Kafka 코디네이터 작업을 캡처합니다. |
| Kafka 사용자 오류 로그 | Event Hubs에서 호출된 Kafka API에 대한 정보를 캡처합니다. |
| Event Hubs 가상 네트워크 연결 이벤트 | Event Hubs로 트래픽을 전송하는 IP 주소 및 가상 네트워크에 대한 정보를 캡처합니다. |
| 고객 관리형 키 사용자 로그 | 고객 관리형 키와 관련된 작업을 캡처합니다. |
| 런타임 감사 로그 | Event Hubs에서 모든 데이터 평면 액세스 작업(예: 이벤트 보내기 또는 받기)에 대한 집계된 진단 정보를 캡처합니다. |
| 애플리케이션 메트릭 로그 | 데이터 평면 작업과 관련된 특정 메트릭에 대해 집계된 정보를 캡처합니다. |
모든 로그는 JSON(JavaScript Object Notation) 형식으로 저장됩니다. 각 항목에는 다음 섹션에 설명된 형식을 사용하는 문자열 필드가 있습니다.
보관 로그 스키마
보관 로그 JSON 문자열에는 다음 표에 나열된 요소가 포함됩니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | AZMSArchiveLogs에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
TaskName |
실패한 작업에 대한 설명 | 예 | 예 |
ActivityId |
추적에 사용되는 내부 ID | 예 | 예 |
trackingId |
추적에 사용되는 내부 ID | 예 | 예 |
resourceId |
Azure Resource Manager 리소스 ID | 예 | 예 |
eventHub |
이벤트 허브 전체 이름(네임스페이스 이름 포함) | 예 | 아니요 |
EventhubName |
이벤트 허브 엔터티의 이름 | 예 | 예 |
partitionId |
에 기록되는 이벤트 허브의 파티션 | 예 | 예 |
archiveStep |
가능한 값: ArchiveFlushWriter, DestinationInit | 예 | 예 |
startTime |
실패 시작 시간 | 예 | 아니요 |
Time Generated (UTC) |
작업 타임스탬프 | 예 | 예 |
failures |
실패가 발생한 횟수 | 예 | 예 |
durationInSeconds |
실패 기간 | 예 | 예 |
message |
오류 메시지 | 예 | 예 |
category |
로그 범주 | 예 | 아니요 |
Provider |
로그를 내보내는 서비스의 이름(예: Event Hubs) | 예 | 예 |
Type |
내보낸 로그의 유형 | 예 | 예 |
다음 코드는 보관 로그 JSON 문자열에 대한 예입니다.
AzureDiagnostics:
{
"TaskName": "EventHubArchiveUserError",
"ActivityId": "000000000-0000-0000-0000-0000000000000",
"trackingId": "0000000-0000-0000-0000-00000000000000000",
"resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
"eventHub": "<Event Hub full name>",
"partitionId": "1",
"archiveStep": "ArchiveFlushWriter",
"startTime": "9/22/2016 5:11:21 AM",
"failures": 3,
"durationInSeconds": 360,
"message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n --- End of inner exception stack trace ---\r\n at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at System.",
"category": "ArchiveLogs"
}
리소스별 테이블 항목:
{
"TaskName": "EventHubArchiveUserError",
"ActivityId": "000000000-0000-0000-0000-0000000000000",
"trackingId": "0000000-0000-0000-0000-00000000000000000",
"resourceId": "/SUBSCRIPTIONS/000000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs Namespace Name>",
"EventHubName": "<Event Hub full name>",
"partitionId": "1",
"archiveStep": "ArchiveFlushWriter",
"TimeGenerated(UTC)": "9/22/2016 5:11:21 AM",
"failures": 3,
"durationInSeconds": 360,
"message": "Microsoft.WindowsAzure.Storage.StorageException: The remote server returned an error: (404) Not Found. ---> System.Net.WebException: The remote server returned an error: (404) Not Found.\r\n at Microsoft.WindowsAzure.Storage.Shared.Protocol.HttpResponseParsers.ProcessExpectedStatusCodeNoException[T](HttpStatusCode expectedStatusCode, HttpStatusCode actualStatusCode, T retVal, StorageCommandBase`1 cmd, Exception ex)\r\n at Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob.<PutBlockImpl>b__3e(RESTCommand`1 cmd, HttpWebResponse resp, Exception ex, OperationContext ctx)\r\n at Microsoft.WindowsAzure.Storage.Core.Executor.Executor.EndGetResponse[T](IAsyncResult getResponseResult)\r\n --- End of inner exception stack trace ---\r\n at Microsoft.WindowsAzure.Storage.Core.Util.StorageAsyncResult`1.End()\r\n at Microsoft.WindowsAzure.Storage.Core.Util.AsyncExtensions.<>c__DisplayClass4.<CreateCallbackVoid>b__3(IAsyncResult ar)\r\n--- End of stack trace from previous location where exception was thrown ---\r\n at System.",
"Provider":"EVENTHUB",
"Type":"AZMSArchiveLogs"
}
운영 로그 스키마
작업 로그 JSON 문자열에는 다음 표에 나열된 요소가 포함되어 있습니다.
| 속성 | 설명 | AzureDiagnostics에서 지원됨 | AZMSOperationalLogs에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
ActivityId |
추적 목적으로 사용되는 내부 ID | 예 | 예 |
EventName |
작업 이름. 이 요소에 대한 값 목록은 이벤트 이름을 참조 하세요. | 예 | 예 |
resourceId |
Azure Resource Manager 리소스 ID | 예 | 예 |
SubscriptionId |
구독 ID | 예 | 예 |
EventTimeString |
작업 시간 | 예 | 아니요 |
Time Generated (UTC) |
작업 타임스탬프 | 예 | 예 |
EventProperties |
작업에 대한 속성입니다. 이 요소는 다음 예제와 같이 이벤트에 대한 자세한 정보를 제공합니다. | 예 | 예 |
Status |
작업 상태입니다. 이 값은 Succeeded 또는 Failed일 수 있습니다. | 예 | 예 |
Caller |
작업 호출자(Azure Portal 또는 관리 클라이언트) | 예 | 예 |
Category |
로그 범주 | 예 | 아니요 |
Provider |
로그를 내보내는 서비스의 이름(예: Event Hubs) | 예 | 예 |
Type |
내보낸 로그의 유형 | 예 | 예 |
다음 코드는 작업 로그 JSON 문자열의 예입니다.
AzureDiagnostics:
Example:
{
"ActivityId": "00000000-0000-0000-0000-00000000000000",
"EventName": "Create EventHub",
"resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
"SubscriptionId": "000000000-0000-0000-0000-000000000000",
"EventTimeString": "9/28/2016 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"category": "OperationalLogs"
}
리소스별 테이블 항목:
Example:
{
"ActivityId": "00000000-0000-0000-0000-00000000000000",
"EventName": "Create EventHub",
"resourceId": "/SUBSCRIPTIONS/00000000-0000-0000-0000-0000000000000/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace name>",
"SubscriptionId": "000000000-0000-0000-0000-000000000000",
"TimeGenerated (UTC)": "9/28/2016 8:40:06 PM +00:00",
"EventProperties": "{\"SubscriptionId\":\"0000000000-0000-0000-0000-000000000000\",\"Namespace\":\"<Namespace Name>\",\"Via\":\"https://<Namespace Name>.servicebus.windows.net/f8096791adb448579ee83d30e006a13e/?api-version=2016-07\",\"TrackingId\":\"5ee74c9e-72b5-4e98-97c4-08a62e56e221_G1\"}",
"Status": "Succeeded",
"Caller": "ServiceBus Client",
"Provider": "EVENTHUB",
"Type":"AZMSOperationalLogs"
}
이벤트 이름
이벤트 이름은 다음 열거형에서 작업 유형 + 리소스 종류로 채워집니다. 예를 들어 Create Queue, Retrieve Event Hub 또는 Delete Rule입니다.
| 작업 유형 | 리소스 종류 |
|---|---|
| - 만들기 - 업데이트 - 삭제 -되찾다 - 알 수 없음 |
-Namespace -큐 -주제 -구독 - Event Hubs - SharedAccessPolicy - UsageCredit -규칙 - ConsumerGroup |
자동 크기 조정 로그 스키마
자동 크기 조정 로그 JSON에는 다음 표에 나열된 요소가 포함되어 있습니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | AZMSAutoscaleLogs에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
TrackingId |
추적 목적으로 사용되는 내부 ID | 예 | 예 |
ResourceId |
Azure Resource Manager 리소스 ID입니다. | 예 | 예 |
Message |
자동 인플레이트 작업에 대한 세부 정보를 제공하는 정보 메시지입니다. 메시지에는 지정된 네임스페이스에 대한 처리량 단위의 이전 및 현재 값과 TU의 확장을 트리거한 항목이 포함됩니다. | 예 | 예 |
Time Generated (UTC) |
작업 타임스탬프 | 예 | 예 |
Provider |
로그를 내보내는 서비스 이름(예: Event Hubs) | 예 | 예 |
Type |
내보낸 로그의 유형 | 예 | 예 |
다음은 자동 크기 조정 이벤트의 예입니다.
AzureDiagnostics:
{
"TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
"Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name"
}
리소스별 테이블 항목:
{
"TrackingId": "fb1b3676-bb2d-4b17-85b7-be1c7aa1967e",
"Message": "Scaled-up EventHub TUs (UpdateStartTimeUTC: 5/13/2021 7:48:36 AM, PreviousValue: 1, UpdatedThroughputUnitValue: 2, AutoScaleReason: 'IncomingMessagesPerSecond reached 2170')",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"timeGenerated (UTC) : "9/28/2022 8:40:06 PM +00:00",
"Provider" : "EVENTHUB",
"Type" : "AZMSAutoscaleLogs"
}
Kafka 코디네이터 로그 스키마
Kafka 코디네이터 로그 JSON에는 다음 표에 나열된 요소가 포함되어 있습니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | AZMSKafkaCoordinatorLogs에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
RequestId |
추적 목적으로 사용되는 요청 ID | 예 | 예 |
ResourceId |
Azure Resource Manager 리소스 ID | 예 | 예 |
Operation |
그룹 조정 중에 수행된 작업의 이름 | 예 | 예 |
ClientId |
클라이언트 ID | 예 | 예 |
NamespaceName |
네임스페이스 이름 | 예 | 예 |
SubscriptionId |
Azure 구독 ID | 예 | 예 |
Message |
그룹 조정 중에 수행된 작업에 대한 세부 정보를 제공하는 정보 또는 경고 메시지입니다. | 예 | 예 |
Time Generated (UTC) |
작업 타임스탬프 | 예 | 예 |
Provider |
로그를 내보내는 서비스 이름(예: ServiceBus) | 예 | 예 |
Type |
내보낸 로그의 유형 | 예 | 예 |
예시
AzureDiagnostics:
{
"RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
"Operation": "Join.Start",
"ClientId": "KafkaExampleConsumer#0",
"Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Category": "KafkaCoordinatorLogs"
}
리소스별 테이블 항목:
{
"RequestId": "FE01001A89E30B020000000304620E2A_KafkaExampleConsumer#0",
"Operation": "Join.Start",
"ClientId": "KafkaExampleConsumer#0",
"Message": "Start join group for new member namespace-name:c:$default:I:KafkaExampleConsumer#0-cc40856f7f3c4607915a571efe994e82, current group size: 0, API version: 2, session timeout: 10000ms, rebalance timeout: 300000ms.",
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Provider" : "EVENTHUB",
"Type" : "AZMSKafkaCoordinatorLogs"
}
Kafka 사용자 오류 로그 스키마
Kafka 사용자 오류 로그 JSON에는 다음 표에 나열된 요소가 포함되어 있습니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | AZMSKafkaUserErrorLogs에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
TrackingId |
추적 목적으로 사용되는 추적 ID입니다. | 예 | 예 |
NamespaceName |
네임스페이스 이름 | 예 | 예 |
Eventhub |
이벤트 허브 이름 | 예 | 예 |
PartitionId |
파티션 ID | 예 | 예 |
GroupId |
그룹 ID | 예 | 예 |
ClientId |
클라이언트 ID | 예 | 예 |
ResourceId |
Azure Resource Manager 리소스 ID입니다. | 예 | 예 |
Message |
오류에 대한 세부 정보를 제공하는 정보 메시지 | 예 | 예 |
TimeGenerated (UTC) |
실행된 작업에 대한 타임스탬프 | 예 | 예 |
Provider |
로그를 내보내는 서비스 이름(예: Event Hubs) | 예 | 예 |
Type |
내보낸 로그의 유형 | 아니오 | 예 |
Event Hubs 가상 네트워크 연결 이벤트 스키마
Event Hubs 가상 네트워크(가상 네트워크) 연결 이벤트 JSON에는 다음 표에 나열된 요소가 포함되어 있습니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | AZMSVNetConnectionevents에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
SubscriptionId |
Azure 구독 ID | 예 | 예 |
NamespaceName |
네임스페이스 이름 | 예 | 예 |
IPAddress |
Event Hubs 서비스에 연결하는 클라이언트의 IP 주소 | 예 | 예 |
Action |
연결 요청을 평가할 때 Event Hubs 서비스에서 수행한 작업입니다. 지원되는 작업은 연결 허용 및 연결 거부입니다. | 예 | 예 |
Reason |
작업이 완료된 이유를 제공합니다. | 예 | 아니요 |
Message |
작업이 완료된 이유를 제공합니다. | 예 | 예 |
Count |
지정된 작업의 발생 수 | 예 | 예 |
ResourceId |
Azure Resource Manager 리소스 ID입니다. | 예 | 예 |
Time Generated (UTC) |
작업 타임스탬프 | 예 | 예 |
Provider |
로그를 내보내는 서비스 이름(예: ServiceBus) | 예 | 예 |
Type |
AZMSVNetConnectionevents | 예 | 예 |
가상 네트워크 로그는 네임스페이스가 선택한 네트워크 또는 특정 IP 주소(IP 필터 규칙)에서 액세스를 허용하는 경우에만 생성됩니다. 해당 기능을 사용하여 네임스페이스에 대한 액세스를 제한하지 않고, Event Hubs 네임스페이스에 연결하는 클라이언트의 IP 주소를 추적하는 가상 네트워크 로그를 계속 가져오려는 경우 다음 해결 방법을 사용할 수 있습니다. IP 필터링을 사용하도록 설정하고 주소 지정 가능한 총 IPv4 범위( - 0.0.0.0/1128.0.0.0/1) 및 IPv6 범위(::/1 - 8000::/1)를 추가합니다. Event Hubs IP 필터링은 IPv6 범위를 지원하지 않습니다. 로그에 IPv6 형식의 프라이빗 엔드포인트 주소가 표시될 수 있습니다.
예시
AzureDiagnostics:
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"IPAddress": "1.2.3.4",
"Action": "Deny Connection",
"Reason": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
"Count": "65",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Category": "EventHubVNetConnectionEvent"
}
리소스별 테이블 항목:
{
"SubscriptionId": "0000000-0000-0000-0000-000000000000",
"NamespaceName": "namespace-name",
"IPAddress": "1.2.3.4",
"Action": "Deny Connection",
"Message": "IPAddress doesn't belong to a subnet with Service Endpoint enabled.",
"Count": "65",
"ResourceId": "/subscriptions/0000000-0000-0000-0000-000000000000/resourcegroups/testrg/providers/microsoft.eventhub/namespaces/namespace-name",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSKafkauserErrorlogs"
}
고객 관리형 키 사용자 로그 스키마
고객 관리형 키 사용자 로그 JSON에는 다음 표에 나열된 요소가 포함되어 있습니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | AZMSCustomerManagedKeyUserLogs에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
Category |
메시지의 범주 유형입니다. 오류 및 정보 값 중 하나입니다. 예를 들어, 키 자격 증명 모음의 키를 사용하지 않도록 설정하는 경우에는 정보 범주이거나, 키를 래핑 해제할 수 없는 경우에는 오류가 발생할 수 있습니다. | 예 | 예 |
ResourceId |
Azure 구독 ID 및 네임스페이스 이름을 포함하는 내부 리소스 ID | 예 | 예 |
KeyVault |
Key Vault 리소스의 이름 | 예 | 예 |
Key |
Event Hubs 네임스페이스를 암호화하는 데 사용되는 Key Vault 키의 이름입니다. | 예 | 예 |
Version |
Key Vault 키의 버전입니다. | 예 | 예 |
Operation |
키 자격 증명 모음의 키에 대해 수행되는 작업입니다. 예를 들어 키, 래핑 또는 래핑 해제를 사용하거나 사용하지 않도록 설정합니다. | 예 | 예 |
Code |
작업과 연결된 코드입니다. 예: 오류 코드, 404는 키를 찾을 수 없음을 의미합니다. | 예 | 예 |
Message |
오류 또는 정보 메시지에 대한 세부 정보를 제공하는 메시지 | 예 | 예 |
Time Generated (UTC) |
작업 타임스탬프 | 예 | 예 |
Provider |
로그를 내보내는 서비스 이름(예: ServiceBus) | 예 | 예 |
Type |
내보낸 로그의 유형 | 예 | 예 |
고객 관리형 키에 대한 로그의 예시는 다음과 같습니다.
AzureDiagnostics:
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111-1111-1111-1111-111111111111",
"category": "error"
"resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "1111111111111111111111111111111",
"operation": "wrapKey",
"code": "404",
"message": "Key not found: ehbyok0/111111111111111111111111111111"
}
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111111111-1111-1111-1111111111111",
"category": "info"
"resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "111111111111111111111111111111",
"operation": "disable | restore",
"code": "",
"message": ""
}
리소스별 테이블 항목:
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111-1111-1111-1111-111111111111",
"category": "error"
"resourceId": "/SUBSCRIPTIONS/11111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "1111111111111111111111111111111",
"operation": "wrapKey",
"code": "404",
"message": "Key not found: ehbyok0/111111111111111111111111111111",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSCustomerManagedKeyUserLogs"
}
{
"TaskName": "CustomerManagedKeyUserLog",
"ActivityId": "11111111111111-1111-1111-1111111111111",
"category": "info"
"resourceId": "/SUBSCRIPTIONS/111111111-1111-1111-1111-11111111111/RESOURCEGROUPS/DEFAULT-EVENTHUB-CENTRALUS/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/FBETTATI-OPERA-EVENTHUB",
"keyVault": "https://mykeyvault.vault-int.azure-int.net",
"key": "mykey",
"version": "111111111111111111111111111111",
"operation": "disable | restore",
"code": "",
"message": "",
"Provider": "EVENTHUB",
"Time Generated (UTC) ": "9/28/2022 8:40:06 PM +00:00",
"Type" : "AZMSCustomerManagedKeyUserLogs"
}
BYOK 암호화를 사용하는 경우 찾을 수 있는 일반적인 오류 코드는 다음과 같습니다.
| 작업 | 오류 코드 | 결과 데이터 상태 |
|---|---|---|
| 키 자격 증명 모음에서 래핑/래핑 해제 권한을 제거하세요. | 403 | 액세스할 |
| 래핑/래핑 해제 권한을 부여한 Microsoft Entra 보안 주체에서 Microsoft Entra ID 역할 멤버 자격 제거 | 403 | 액세스할 |
| 키 자격 증명 모음에서 암호화 키를 삭제하세요. | 404 | 액세스할 |
| 키 자격 증명 모음을 삭제하세요. | 404 | 액세스할 수 없음(필요한 설정인 일시 삭제가 사용하도록 설정되어 있다고 가정). |
| 암호화 키가 이미 만료되도록 암호화 키의 만료 기간 변경 | 403 | 액세스할 |
| 키 암호화 키가 활성화되지 않도록 NBF 변경(이전이 아님) | 403 | 액세스할 |
| 키 자격 증명 모음 방화벽에 대해 MSFT 서비스 허용 옵션을 선택하거나, 암호화 키가 있는 키 자격 증명 모음으로 연결되는 네트워크 액세스를 차단합니다. | 403 | 액세스할 |
| 키 자격 증명 모음을 다른 테넌트로 이동 | 404 | 액세스할 |
| 간헐적인 네트워크 문제 또는 DNS/AAD/MSI 중단 | 캐시된 데이터 암호화 키를 사용하여 액세스할 수 있음 |
런타임 감사 로그
런타임 감사 로그는 Event Hubs의 모든 데이터 평면 액세스 작업(예: 이벤트 보내기 또는 받기)에 대해 집계된 진단 정보를 캡처합니다.
참고 항목
런타임 감사 로그는 프리미엄 및 전용 계층에서만 사용할 수 있습니다.
런타임 감사 로그에는 다음 표에 나열된 요소가 포함됩니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | 리소스별 테이블에서 지원됨 |
|---|---|---|---|
ActivityId |
감사 활동에 대한 고유성을 보장하는 임의로 생성된 UUID입니다. | 예 | 예 |
ActivityName |
런타임 작업 이름입니다. | 예 | 예 |
ResourceId |
활동과 연결된 리소스입니다. | 예 | 예 |
Timestamp |
집계 시간입니다. | 예 | 아니요 |
TimeGenerated [UTC] |
실행된 작업의 시간(UTC) | 예 | 예 |
Status |
활동의 상태(성공 또는 실패)입니다. | 예 | 예 |
Protocol |
작업과 연결된 프로토콜의 유형입니다. | 예 | 예 |
AuthType |
인증 유형(Microsoft Entra ID 또는 SAS 정책). | 예 | 예 |
AuthKey |
리소스에 인증하는 데 사용되는 Microsoft Entra ID 애플리케이션 ID 또는 SAS 정책 이름입니다. | 예 | 예 |
NetworkType |
네트워크 액세스 유형(Public 또는 Private)입니다. |
예 | 예 |
ClientIP |
클라이언트 애플리케이션의 IP 주소입니다. | 예 | 예 |
Count |
집계된 1분 동안 수행된 총 작업 수입니다. | 예 | 예 |
Properties |
데이터 평면 작업과 관련이 있는 메타데이터입니다. | 예 | 예 |
Category |
로그 범주 | 예 | 아니요 |
Provider |
로그를 내보내는 서비스 이름(예: EventHubs) | 예 | 예 |
Type |
내보낸 로그의 유형 | 예 | 예 |
다음은 런타임 감사 로그 항목의 예입니다.
AzureDiagnostics:
{
"ActivityId": "<activity id>",
"ActivityName": "ConnectionOpen | Authorization | SendMessage | ReceiveMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
"Time": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | KAFKA | HTTP | Web Sockets",
"AuthType": "SAS | Azure Active Directory",
"AuthId": "<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",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event Hubs namespace>/eventhubs/<event hub name>",
"TimeGenerated (UTC)": "1/1/2021 8:40:06 PM +00:00",
"Status": "Success | Failure",
"Protocol": "AMQP | KAFKA | HTTP | Web Sockets",
"AuthType": "SAS | Azure Active Directory",
"AuthId": "<AAD application name | SAS policy name>",
"NetworkType": "Public | Private",
"ClientIp": "x.x.x.x",
"Count": 1,
"Type": "AZMSRuntimeAUditLogs",
"Provider":"EVENTHUB"
}
애플리케이션 메트릭 로그
애플리케이션 메트릭 로그는 데이터 평면 작업과 관련된 특정 메트릭에 대한 집계된 정보를 캡처합니다. 캡처된 정보에는 다음 런타임 메트릭이 포함됩니다.
참고 항목
애플리케이션 메트릭 로그는 프리미엄 및 전용 계층에서만 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
ConsumerLag |
소비자와 생산자 간의 시차를 나타냅니다. |
NamespaceActiveConnections |
클라이언트에서 이벤트 허브로 설정된 활성 연결의 세부 정보입니다. |
GetRuntimeInfo |
Event Hubs에서 런타임 정보를 가져옵니다. |
GetPartitionRuntimeInfo |
이벤트 허브의 논리 파티션에 대한 대략적인 런타임 정보를 가져옵니다. |
IncomingMessages |
Event Hubs에 게시된 메시지 수에 대한 세부 정보입니다. |
IncomingBytes |
Event Hubs로 전송된 게시자 처리량의 세부 정보 |
OutgoingMessages |
Event Hubs에서 사용된 메시지 수에 대한 세부 정보입니다. |
OutgoingBytes |
Event Hubs의 소비자 처리량에 대한 세부 정보입니다. |
OffsetCommit |
이벤트 허브에 대한 오프셋 커밋 호출 수 |
OffsetFetch |
이벤트 허브에 대한 오프셋 페치 호출 수 |
진단 오류 로그
진단 오류 로그는 클라이언트 쪽, 제한 및 할당량 초과 오류에 대한 오류 메시지를 캡처합니다. 오류 식별에 대한 자세한 진단을 제공합니다.
진단 오류 로그에는 다음 표에 나열된 요소가 포함됩니다.
| 속성 | 설명 | Azure Diagnostics에서 지원됨 | AZMSDiagnosticErrorLogs에서 지원됨(리소스 관련 테이블) |
|---|---|---|---|
ActivityId |
감사 활동에 대한 고유성을 보장하는 임의로 생성된 UUID입니다. | 예 | 예 |
ActivityName |
작업 이름 | 예 | 예 |
NamespaceName |
네임스페이스 이름 | 예 | 예 |
EntityType |
엔터티 형식 | 예 | 예 |
EntityName |
엔터티 이름 | 예 | 예 |
OperationResult |
작업의 오류 유형(clienterror 또는 serverbusy quotaexceeded) |
예 | 예 |
ErrorCount |
집계 기간 1분 동안 동일한 오류의 수입니다. | 예 | 예 |
ErrorMessage |
자세한 오류 메시지 | 예 | 예 |
ResourceProvider |
로그를 내보내는 서비스의 이름입니다. 가능한 값: Microsoft.EventHub 및 Microsoft.ServiceBus |
예 | 예 |
Time Generated (UTC) |
작업 시간 | 예 | 예 |
EventTimestamp |
작업 시간 | 예 | 아니요 |
Category |
로그 범주 | 예 | 아니요 |
Type |
내보낸 로그의 유형 | 예 | 예 |
진단 오류 로그 항목의 예는 다음과 같습니다.
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"SubscriptionId": "<Azure Subscription Id",
"NamespaceName": "Name of Event Hubs Namespace",
"EntityType": "EventHub",
"EntityName": "Name of Event Hub",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
"OperationResult": "ServerBusy",
"ErrorCount": 1,
"EventTimestamp": "3/27/2024 1:02:29.126 PM +00:00",
"ErrorMessage": "the request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
"category": "DiagnosticErrorLogs"
}
리소스별 테이블 항목:
{
"ActivityId": "0000000000-0000-0000-0000-00000000000000",
"NamespaceName": "Name of Event Hubs Namespace",
"EntityType": "Event Hub",
"EntityName": "Name of Event Hub",
"ActivityName": "SendMessage",
"ResourceId": "/SUBSCRIPTIONS/xxx/RESOURCEGROUPS/<Resource Group Name>/PROVIDERS/MICROSOFT.EVENTHUB/NAMESPACES/<Event hub namespace name>",,
"OperationResult": "ServerBusy",
"ErrorCount": 1,
"TimeGenerated [UTC]": "1/27/2024 4:02:29.126 PM +00:00",
"ErrorMessage": "The request was terminated because the entity is being throttled by the application group with application group name <application group name> and policy name <throttling policy name>.error code: 50013.",
"Type": "AZMSDiagnosticErrorLogs"
}
활동 로그
연결된 테이블에는 이 서비스의 활동 로그에 기록할 수 있는 작업이 나열되어 있습니다. 이 작업은 활동 로그에서 가능한 모든 리소스 공급자 작업의 하위 집합입니다.
활동 로그 항목의 스키마에 대한 자세한 내용은 활동 로그 스키마를 참조하세요.
관련 콘텐츠
- Event Hubs 모니터링에 대한 설명은 Azure Event Hubs 모니터링을 참조하세요.
- Azure 리소스 모니터링에 대한 자세한 내용은 Azure Monitor를 사용한 Azure 리소스 모니터링을 참조하세요.