GraphQL 작업
GraphQL 작업 로그는 작업 영역 모니터링 로그의 일부이며 실시간 인텔리전스 솔루션의 일부인 Eventhouse KQL 데이터베이스에 등록됩니다. 이러한 로그를 사용하여 작업 영역의 사용량 및 성능을 모니터링할 수 있습니다.
GraphQL 작업 로그
연결된 데이터 원본에서 GraphQL용 Fabric API에서 실행하는 각 쿼리에 대한 로그 이벤트는 GraphQLMetrics 및 GraphQLLog의 두 테이블에 저장됩니다.
쿼리 로그를 사용하여 다음을 수행합니다.
- 동작 변경 및 잠재적인 API 저하를 식별합니다.
- 비정상적이거나 리소스가 많은 쿼리를 검색합니다.
- 쿼리 수가 가장 많은 사용자 및 애플리케이션 식별
- 쿼리 성능 및 추세를 분석합니다.
- 느린 쿼리 문제를 해결합니다.
- 특정 GraphQL 쿼리 관련 문제를 진단합니다.
이 표에는 GraphQL 로그가 나열됩니다.
| 열 이름 | Type | 설명 |
|---|---|---|
| 타임스탬프 | 날짜/시간 | 데이터 원본에서 레코드를 만들 때 로그 항목이 생성된 시점의 타임스탬프(UTC)입니다. |
| ItemId | string | 데이터를 로깅하는 리소스의 고유 ID입니다. |
| ItemKind | string | 작업을 로깅하는 아티팩트 형식입니다. |
| ItemName | string | 이 작업을 로깅하는 패브릭 아티팩트 이름입니다. |
| WorkspaceId | string | 작업 중인 아티팩트가 포함된 패브릭 작업 영역의 고유 식별자 |
| WorkspaceName | string | 아티팩트가 포함된 패브릭 작업 영역의 이름입니다. |
| CapacityId | string | 작동 중인 아티팩트 호스팅 용량의 고유 식별자입니다. |
| CustomerTenantId | string | 작업이 수행된 고객 테넌트 ID입니다. |
| PlatformMonitoringTableName | string | 레코드에 속하는 테이블의 이름(또는 레코드의 인증된 이벤트 유형)입니다. Format은 <WorkloadName> + [OperationType>]+ <TelemetryType입니다.> |
| 지역 | string | 이벤트를 내보내는 리소스의 영역입니다. 예를 들어 미국 동부 또는 프랑스 남부입니다. |
| MetricTimeGrain | string | 메트릭의 시간 조직(ISO 8601 기간)입니다. |
| MetricUnitName | string | 메트릭의 단위. |
| MetricSumValue | long | 1분 동안 메트릭의 집계된 합계 값입니다. |
| DatasourceTypes | dynamic | 모델에서 사용되는 DataSource 형식의 배열입니다. |
| ResultCode | string | 사용량을 안정성으로 확장하는 데 사용되는 실패한 활동의 오류 코드입니다. |
| 상태 | string | 작업의 상태입니다. 쿼리가 오류/실패와 함께 성공적으로/성공적으로 실행되었습니다. |
GraphQL 로그 특성
이 표에서는 GraphQLLogs 특성에 대해 설명합니다. 이벤트 및 이벤트에 대한 드릴다운 ExecutionMetrics 에 대한 자세한 내용은 이벤트 및 스키마를 참조하세요.
| 열 이름 | Type | 설명 |
|---|---|---|
| 타임스탬프 | 날짜/시간 | 데이터 원본에서 레코드를 만들 때 로그 항목이 생성된 시점의 타임스탬프(UTC)입니다. |
| OperationName | string | 작업 이름입니다. |
| ItemId | string | 데이터를 로깅하는 리소스의 고유 ID입니다. |
| ItemKind | string | 작업을 로깅하는 아티팩트 형식입니다. |
| ItemName | string | 이 작업을 로깅하는 패브릭 아티팩트 이름입니다. |
| WorkspaceId | string | 작업 중인 아티팩트가 포함된 패브릭 작업 영역의 고유 식별자입니다. |
| WorkspaceName | string | 아티팩트가 포함된 패브릭 작업 영역의 이름입니다. |
| CapacityId | string | 작동 중인 아티팩트 호스팅 용량의 고유 식별자입니다. |
| CorrelationId | string | 루트 활동 ID입니다. |
| OperationId | string | 기록 중인 작업에 대한 고유 식별자입니다. |
| ID | dynamic | 사용자 및 클레임 세부 정보입니다. 보고되는 작업과 연결된 사용자입니다. |
| CustomerTenantId | string | 작업이 수행된 고객 테넌트 ID입니다. |
| DurationMs | long | 필요한 모든 작업이 처리되는 동안 경과된 경과된 CPU 시간입니다. 단위는 밀리초 단위입니다. |
| 상태 | string | 작업의 상태입니다. 쿼리가 오류/실패와 함께 성공적으로/성공적으로 실행되었습니다. |
| 수준 | string | 플랫폼 모니터링 팀에 필요한 메타데이터입니다. |
| 지역 | string | 이벤트를 내보내는 리소스의 영역입니다. 예를 들어 미국 동부 또는 프랑스 남부입니다. |
| PlatformMonitoringTableName | string | 레코드에 속하는 테이블의 이름(또는 레코드의 인증된 이벤트 유형)입니다. Format은 <WorkloadName> + [OperationType>]+ <TelemetryType입니다.> |
| QueryText | string | 쿼리 텍스트입니다. |
| GraphQLOverheadDurationMs | long | 데이터 평면 요청에 대한 GraphQL 오버헤드(ms)입니다. |
| ProcessedBytes | long | 처리된 데이터 볼륨(바이트)입니다. |
| TransportProtocol | string | 요청에 대한 전송 프로토콜입니다. |
| QueryResultMessage | string | 이 차원은 쿼리 작업의 결과에 대한 추가 컨텍스트를 제공하는 데 사용됩니다. |
샘플 쿼리
패브릭 샘플 GitHub 리포지토리에서 샘플 쿼리를 찾을 수 있습니다.