API Management 모니터링 데이터 참조
적용 대상: 모든 API Management 계층
이 문서에는 이 서비스에 대한 모든 모니터링 참조 정보가 포함되어 있습니다.
Azure API Management에 대해 수집할 수 있는 데이터 및 사용 방법에 대한 자세한 내용은 Monitor API Management를 참조하세요.
메트릭
이 섹션에는 이 서비스에 대해 자동으로 모은 플랫폼 메트릭이 모두 나열되어 있습니다. 이러한 메트릭은 Azure Monitor에서 지원되는 모든 플랫폼 메트릭의 전역 목록의 일부이기도 합니다.
메트릭 보존에 관한 자세한 내용은 Azure Monitor 메트릭 개요를 참조하세요.
Microsoft.ApiManagement/service에 대해 지원되는 메트릭
다음 표에서는 Microsoft.ApiManagement/서비스 리소스 종류에 사용할 수 있는 메트릭을 나열합니다.
- 모든 테이블에 모든 열이 있는 것은 아닙니다.
- 일부 열은 페이지의 보기 영역 밖에 있을 수 있습니다. 사용 가능한 모든 열을 보려면 테이블 확장을 선택합니다.
테이블 제목
- 범주 - 메트릭 그룹 또는 분류입니다.
- 메트릭 - Azure Portal에 표시되는 메트릭 표시 이름입니다.
- REST API의 이름 - REST API에서 참조되는 메트릭 이름입니다.
- 단위 - 측정 단위입니다.
- 집계 - 기본 집계 형식입니다. 유효한 값은 평균(Avg), 최소(Min), 최대(Max), 합계(Sum), 개수입니다.
- 차원 - 메트릭에 사용할 수 있는 차원입니다.
- 시간 조직 - 메트릭이 샘플링되는 간격입니다. 예를 들어,
PT1M은 메트릭이 1분마다,PT30M은 30분마다,PT1H는 1시간마다 샘플링됨을 나타냅니다. - DS 내보내기- 진단 설정을 통해 메트릭을 Azure Monitor 로그로 내보낼 수 있는지 여부를 나타냅니다. 메트릭 내보내기에 대한 자세한 내용은 Azure Monitor의 진단 설정 생성을 참조하세요.
| 범주 | 메트릭 | REST API의 이름 | 단위 | 집계 | 차원 | 시간 조직 | DS 내보내기 |
|---|---|---|---|---|---|---|---|
| 게이트웨이 요청 | 백 엔드 요청 기간 밀리초 단위의 백 엔드 요청 기간 |
BackendDuration |
밀리초 | 평균, 최대, 최소 | Location, , HostnameApiId |
PT1M | 예 |
| 용량 | 생산 능력 ApiManagement 서비스에 대한 사용률 메트릭입니다. 참고: Premium 이외의 skus의 경우, 'Max' 집계는 값을 0으로 표시합니다. |
Capacity |
Percent | 평균, 최대 | Location |
PT1M | 예 |
| Gateway WebSocket | WebSocket 연결 시도(미리 보기) 선택한 원본 및 대상에 따른 WebSocket 연결 시도 횟수 |
ConnectionAttempts |
Count | 합계(합계), 평균 | Location, Source, DestinationState |
PT1M | 예 |
| 용량 | 게이트웨이의 CPU 비율 SKUv2 서비스에 대한 게이트웨이의 CPU 백분율 |
CpuPercent_Gateway |
Percent | 평균, 최대 | <없음> | PT1M | 예 |
| 게이트웨이 요청 | 게이트웨이 요청의 전체 기간 게이트웨이 요청의 전체 기간(밀리초) |
Duration |
밀리초 | 평균, 최대, 최소 | Location, , HostnameApiId |
PT1M | 예 |
| EventHub 이벤트 | 삭제된 EventHub 이벤트 큐 크기 제한에 도달하여 건너뛴 이벤트 수 |
EventHubDroppedEvents |
Count | 합계(Sum) | Location |
PT1M | 예 |
| EventHub 이벤트 | 거부된 EventHub 이벤트 거부된 EventHub 이벤트 수(잘못 구성되었거나 권한 없음) |
EventHubRejectedEvents |
Count | 합계(Sum) | Location |
PT1M | 예 |
| EventHub 이벤트 | 성공적인 EventHub 이벤트 성공한 EventHub 이벤트 수 |
EventHubSuccessfulEvents |
Count | 합계(Sum) | Location |
PT1M | 예 |
| EventHub 이벤트 | 제한된 EventHub 이벤트 제한된 EventHub 이벤트 수 |
EventHubThrottledEvents |
Count | 합계(Sum) | Location |
PT1M | 예 |
| EventHub 이벤트 | Timed Out EventHub 이벤트 시간이 초과된 EventHub 이벤트 수 |
EventHubTimedoutEvents |
Count | 합계(Sum) | Location |
PT1M | 예 |
| EventHub 이벤트 | EventHub 이벤트 크기 EventHub 이벤트의 총 크기(바이트) |
EventHubTotalBytesSent |
바이트 | 합계(Sum) | Location |
PT1M | 예 |
| EventHub 이벤트 | Total EventHub 이벤트 EventHub로 전송된 이벤트 수 |
EventHubTotalEvents |
Count | 합계(Sum) | Location |
PT1M | 예 |
| EventHub 이벤트 | 실패한 EventHub 이벤트 실패한 EventHub 이벤트 수 |
EventHubTotalFailedEvents |
Count | 합계(Sum) | Location |
PT1M | 예 |
| 게이트웨이 요청 | 실패한 게이트웨이 요청(사용되지 않음) 게이트웨이 요청의 오류 수 - GatewayResponseCodeCategory 차원에서 다차원 요청 메트릭을 대신 사용 |
FailedRequests |
Count | 합계(Sum) | Location, Hostname |
PT1M | 예 |
| 용량 | 게이트웨이의 메모리 비율 SKUv2 서비스에 대한 게이트웨이의 메모리 비율 |
MemoryPercent_Gateway |
Percent | 평균, 최대 | <없음> | PT1M | 예 |
| 네트워크 상태 | 리소스의 네트워크 연결 상태(미리 보기) API Management 서비스에서 종속 리소스 유형의 네트워크 연결 상태 |
NetworkConnectivity |
Count | 합계(합계), 평균 | Location, ResourceType |
PT1M | 예 |
| 게이트웨이 요청 | 기타 게이트웨이 요청(사용되지 않음) 다른 게이트웨이 요청 수 - GatewayResponseCodeCategory 차원과 다차원 요청 메트릭을 대신 사용 |
OtherRequests |
Count | 합계(Sum) | Location, Hostname |
PT1M | 예 |
| 게이트웨이 요청 | 요청 다차원을 사용하는 게이트웨이 요청 메트릭 |
Requests |
Count | 합계(합계), 최대값, 최소값 | Location, Hostname, LastErrorReason, BackendResponseCode, GatewayResponseCode, BackendResponseCodeCategory, GatewayResponseCodeCategoryApiId |
PT1M | 예 |
| 게이트웨이 요청 | 성공적인 게이트웨이 요청(사용되지 않음) 성공한 게이트웨이 요청 횟수 - GatewayResponseCodeCategory 차원에서 다차원 요청 메트릭을 대신 사용합니다. |
SuccessfulRequests |
Count | 합계(Sum) | Location, Hostname |
PT1M | 예 |
| 게이트웨이 요청 | 총 게이트웨이 요청(사용되지 않음) 게이트웨이 요청 횟수 - GatewayResponseCodeCategory 차원에서 다차원 요청 메트릭을 대신 사용합니다. |
TotalRequests |
Count | 합계(Sum) | Location, Hostname |
PT1M | 예 |
| 게이트웨이 요청 | 권한 없는 게이트웨이 요청(사용되지 않음) 권한 없는 게이트웨이 요청 수 - 대신 GatewayResponseCodeCategory 차원과 다차원 요청 메트릭 사용 |
UnauthorizedRequests |
Count | 합계(Sum) | Location, Hostname |
PT1M | 예 |
| Gateway WebSocket | WebSocket 메시지(미리 보기) 선택한 원본 및 대상에 따른 WebSocket 메시지 수 |
WebSocketMessages |
Count | 합계(합계), 평균 | Location, , SourceDestination |
PT1M | 예 |
메트릭 차원
메트릭 차원에 대한 자세한 내용은 다차원 메트릭을 참조하세요.
이 서비스에는 메트릭과 관련된 다음과 같은 차원이 있습니다.
- ApiId
- BackendResponseCode
- BackendResponseCodeCategory
- 대상
- GatewayResponseCode
- GatewayResponseCodeCategory
- Hostname
- LastErrorReason
- 위치
- ResourceType
- Source
- State(상태)
리소스 로그
이 섹션에는 이 서비스에 대해 모을 수 있는 리소스 로그 유형이 나열되어 있습니다. 이 섹션은 Azure Monitor에서 지원되는 모든 리소스 로그 범주 유형 목록에서 가져옵니다.
Microsoft.ApiManagement/service에 대해 지원되는 리소스 로그
| 범주 | 범주 표시 이름 | 로그 테이블 | 기본 로그 플랜 지원 | 수집 시간 변환 지원 | 예시 쿼리 | 내보낼 비용 |
|---|---|---|---|---|---|---|
DeveloperPortalAuditLogs |
개발자 포털 사용과 관련된 로그 | APIMDevPortalAuditDiagnosticLog API Management 개발자 포털 API에 대한 진단 로그입니다. |
예 | 아니요 | 예 | |
GatewayLlmLogs |
생성 AI 게이트웨이와 관련된 로그 | 아니요 | 아니요 | 예 | ||
GatewayLogs |
ApiManagement 게이트웨이와 관련된 로그 | ApiManagementGatewayLogs Azure ApiManagement 게이트웨이 로그. |
예 | 예 | 쿼리 | 아니요 |
WebSocketConnectionLogs |
Websocket 연결과 관련된 로그 | ApiManagementWebSocketConnectionLogs Websocket 연결 로그는 API Management 게이트웨이에 대한 websocket 연결 이벤트에 대한 로그를 제공합니다. 로깅은 요청이 핸드셰이크를 위해 API Management 게이트웨이에 도착하고 요청이 종료될 때까지 시작됩니다. 모든 요청 로그는 CorrelationId를 사용하여 고유하게 식별할 수 있습니다. |
예 | 아니요 | 예 |
Microsoft.ApiManagement/service/workspaces에 대해 지원되는 리소스 로그
| 범주 | 범주 표시 이름 | 로그 테이블 | 기본 로그 플랜 지원 | 수집 시간 변환 지원 | 예시 쿼리 | 내보낼 비용 |
|---|---|---|---|---|---|---|
GatewayLogs |
API Management 작업 영역에 대한 게이트웨이 로그 | 아니요 | 아니요 | 예 |
Azure Monitor 로그 테이블
이 섹션은 이 서비스와 관련이 있고 Kusto 쿼리를 사용하는 Log Analytics의 쿼리에 사용할 수 있는 Azure Monitor 로그 테이블을 나열합니다. 테이블에는 리소스 로그 데이터가 포함되며 수집 및 라우팅되는 항목에 따라 더 많은 데이터가 포함될 수 있습니다.
API Management Microsoft.ApiManagement/service
- APIMDevPortalAuditDiagnosticLog
- AzureActivity
- AzureMetrics
- AzureDiagnostics
- ApiManagementGatewayLogs
- ApiManagementWebSocketConnectionLogs
활동 로그
연결된 테이블에는 이 서비스의 활동 로그에 기록할 수 있는 작업이 나열되어 있습니다. 이 작업은 활동 로그에서 가능한 모든 리소스 공급자 작업의 하위 집합입니다.
활동 로그 항목의 스키마에 대한 자세한 내용은 활동 로그 스키마를 참조하세요.
관련 콘텐츠
- Azure API Management 모니터링에 대한 설명은 모니터 API Management를 참조하세요.
- Azure 리소스 모니터링에 대한 자세한 내용은 Azure Monitor를 사용한 Azure 리소스 모니터링을 참조하세요.