Operaciones de GraphQL
Los registros de operaciones de GraphQL forman parte de la supervisión del área de trabajo de registros y se registran en la base de datos de KQL de Eventhouse, que forma parte de la solución Inteligencia en tiempo real. Puede usar estos registros para supervisar el uso y el rendimiento del área de trabajo.
Registros de operaciones de GraphQL
Un evento de registro para cada consulta ejecutada por Fabric API para GraphQL en sus orígenes de datos conectados se almacena en dos tablas: GraphQLMetrics y GraphQLLog.
Use los registros de consulta para lo siguiente:
- Identificar los cambios de comportamiento y la posible degradación de la API.
- Detectar consultas inusuales o intensivas en recursos.
- Identificar usuarios y aplicaciones con el mayor número de consultas
- Analizar el rendimiento y las tendencias de las consultas.
- Solucionar problemas de consultas lentas.
- Diagnosticar problemas con consultas de GraphQL específicas.
En esta tabla se enumeran los registros de GraphQL.
| Nombre de la columna | Tipo | Descripción |
|---|---|---|
| Marca de tiempo | datetime | Marca de tiempo (UTC) de cuándo se generó la entrada de registro cuando el origen de datos creó el registro. |
| ItemId | string | Identificador único del recurso que registra los datos. |
| ItemKind | string | Tipo de artefacto que registra la operación. |
| ItemName | string | Nombre del artefacto de Fabric que registra esta operación. |
| WorkspaceId | string | Identificador único del área de trabajo de Fabric que contiene el artefacto en el que se está operando |
| WorkspaceName | string | Nombre del área de trabajo de Fabric que contiene el artefacto. |
| CapacityId | string | Identificador único de la capacidad en la que se hospeda el artefacto en el que se está operando. |
| CustomerTenantId | string | Id. de inquilino del cliente, donde se realizó la operación. |
| PlatformMonitoringTableName | string | El nombre de la tabla a los registros que pertenece (o al tipo de evento certificado del registro). El formato es <WorkloadName> + [OperationType>]+ <TelemetryType> |
| Region | string | La región del recurso que emite el evento, por ejemplo, "Este de EE. UU." o "Sur de Francia". |
| MetricTimeGrain | string | Intervalo de tiempo de la métrica (duración ISO 8601). |
| MetricUnitName | string | Unidad de la métrica. |
| MetricSumValue | long | Valor de suma agregado de una métrica durante un solo minuto. |
| DatasourceTypes | dinámico | Matriz de tipos DataSource que usa el modelo. |
| ResultCode | string | Código de error de las actividades con errores, que se usa para ampliar el uso a la confiabilidad. |
| Estado | string | Estado de la operación. La consulta se ejecutó correctamente o correctamente con errores o errores. |
Atributos de registro de GraphQL
En esta tabla se describen los atributos GraphQLLogs. Para obtener más información sobre los eventos y una exploración en profundidad del evento ExecutionMetrics, consulte Eventos y esquema.
| Nombre de la columna | Tipo | Descripción |
|---|---|---|
| Marca de tiempo | datetime | Marca de tiempo (UTC) de cuándo se generó la entrada de registro cuando el origen de datos creó el registro. |
| OperationName | string | Nombre de la operación. |
| ItemId | string | Identificador único del recurso que registra los datos. |
| ItemKind | string | Tipo de artefacto que registra la operación. |
| ItemName | string | Nombre del artefacto de Fabric que registra esta operación. |
| WorkspaceId | string | Identificador único del área de trabajo de Fabric que contiene el artefacto en el que se está operando. |
| WorkspaceName | string | Nombre del área de trabajo de Fabric que contiene el artefacto. |
| CapacityId | string | Identificador único de la capacidad en la que se hospeda el artefacto en el que se está operando. |
| CorrelationId | string | Id. de actividad raíz. |
| OperationId | string | Identificador único de la operación que se registra. |
| Identidad | dinámico | Detalles de usuario y notificación. Usuario asociado a la operación que se está notificando. |
| CustomerTenantId | string | Id. de inquilino del cliente, donde se realizó la operación. |
| DurationMs | long | Tiempo de CPU transcurrido que ha pasado mientras se han procesado todas las operaciones necesarias. La unidad está en milisegundos. |
| Estado | string | Estado de la operación. La consulta se ejecutó correctamente o correctamente con errores o errores. |
| Nivel | string | Metadatos requeridos por el equipo de supervisión de la plataforma. |
| Region | string | La región del recurso que emite el evento, por ejemplo, "Este de EE. UU." o "Sur de Francia". |
| PlatformMonitoringTableName | string | El nombre de la tabla a los registros que pertenece (o al tipo de evento certificado del registro). El formato es <WorkloadName> + [OperationType>]+ <TelemetryType> |
| QueryText | string | Texto de la consulta. |
| GraphQLOverheadDurationMs | long | Sobrecarga de GraphQL en ms para una solicitud de plano de datos. |
| ProcessedBytes | long | Volumen de datos procesado en byte. |
| TransportProtocol | string | Protocolo de transporte para una solicitud. |
| QueryResultMessage | string | Esta dimensión se usa para proporcionar contexto adicional al resultado de una operación de consulta. |
Consultas de ejemplo
Puede encontrar consultas de ejemplo en el repositorio de GitHub fabric-samples.