Operações do GraphQL
Os logs de operação do GraphQL fazem parte dos logs de monitoramento do workspace e são registrados no banco de dados KQL do Eventhouse, que faz parte da solução inteligência em tempo real. Você pode usar esses logs para monitorar o uso e o desempenho do workspace.
Logs de operação do GraphQL
Um evento de log para cada consulta executado pela API do Fabric para GraphQL em suas fontes de dados conectadas é armazenado em duas tabelas: GraphQLMetrics e GraphQLLog.
Use logs de consulta para:
- Identificar alterações de comportamento e possível degradação da API.
- Detectar consultas incomuns ou pesadas de recursos.
- Identificar usuários e aplicativos com o maior número de consultas
- Analisar o desempenho e as tendências da consulta.
- Solucionar problemas de consultas lentas.
- Diagnosticar problemas com consultas específicas do GraphQL.
Esta tabela lista os logs do GraphQL.
| Nome da coluna | Type | Descrição |
|---|---|---|
| Timestamp | datetime | O carimbo de data/hora (UTC) de quando a entrada de log foi gerada quando o registro foi criado pela fonte de dados. |
| ItemId | string | ID exclusiva do recurso registrando os dados em log. |
| ItemKind | string | Tipo de artefato registrando a operação em log. |
| ItemName | string | O nome do artefato do Fabric registrando esta operação em log. |
| espaços de trabalhoId | string | Identificador exclusivo do workspace do Fabric que contém o artefato em que está sendo executada a operação |
| WorkspaceName | string | Nome do workspace do Fabric que contém o artefato. |
| CapacityId | string | Identificador exclusivo da capacidade em que o artefato está sendo operado. |
| CustomerTenantId | string | ID do Locatário do Cliente, em que a operação foi executada. |
| PlatformMonitoringTableName | string | O nome da tabela à qual os registros pertencem (ou o tipo de evento certificado do registro). O formato é <WorkloadName> + [OperationType>]+ <TelemetryType> |
| Region | string | A região do recurso que emite o evento; por exemplo, Leste dos EUA ou Sul da França. |
| MetricTimeGrain | string | Grão de tempo da métrica (Duração ISO 8601). |
| MetricUnitName | string | Unidade da métrica. |
| MetricSumValue | longo | O valor da soma agregada de uma métrica durante um único minuto. |
| DatasourceTypes | dinâmico | Matriz de tipos DataSource que são usados pelo modelo. |
| ResultCode | string | Código de erro das atividades com falha, usadas para estender o uso à confiabilidade. |
| Status | string | Status da operação. Consulta executada com sucesso/com sucesso com erros/falha. |
Atributos de log do GraphQL
Esta tabela descreve os atributos GraphQLLogs. Para obter mais informações sobre os eventos e uma busca detalhada sobre o evento ExecutionMetrics, confira Eventos e esquema.
| Nome da coluna | Type | Descrição |
|---|---|---|
| Timestamp | datetime | O carimbo de data/hora (UTC) de quando a entrada de log foi gerada quando o registro foi criado pela fonte de dados. |
| OperationName | string | O nome da operação. |
| ItemId | string | ID exclusiva do recurso registrando os dados em log. |
| ItemKind | string | Tipo de artefato registrando a operação em log. |
| ItemName | string | O nome do artefato do Fabric registrando esta operação em log. |
| espaços de trabalhoId | string | Identificador exclusivo do workspace do Fabric no qual o artefato está sendo operado. |
| WorkspaceName | string | Nome do workspace do Fabric que contém o artefato. |
| CapacityId | string | Identificador exclusivo da capacidade em que o artefato está sendo operado. |
| CorrelationId | string | ID da Atividade Raiz. |
| OperationId | string | Identificador exclusivo para a operação que está sendo registrada. |
| Identidade | dinâmico | Detalhes do usuário e da declaração. O usuário associado à operação que está sendo relatada. |
| CustomerTenantId | string | ID do Locatário do Cliente, em que a operação foi executada. |
| DurationMs | longo | Tempo decorrido da CPU que passou enquanto todas as operações necessárias foram processadas. A unidade está em milissegundos. |
| Status | string | Status da operação. Consulta executada com sucesso/com sucesso com erros/falha. |
| Nível | string | Metadados exigidos pela equipe de monitoramento da plataforma. |
| Region | string | A região do recurso que emite o evento; por exemplo, Leste dos EUA ou Sul da França. |
| PlatformMonitoringTableName | string | O nome da tabela à qual os registros pertencem (ou o tipo de evento certificado do registro). O formato é <WorkloadName> + [OperationType>]+ <TelemetryType> |
| QueryText | string | O texto da consulta. |
| GraphQLOverheadDurationMs | longo | A sobrecarga do GraphQL em ms para uma solicitação de plano de dados. |
| ProcessedBytes | longo | Volume de dados processados em bytes. |
| TransportProtocol | string | Protocolo de transporte para uma solicitação. |
| QueryResultMessage | string | Essa dimensão é usada para dar contexto adicional ao resultado de uma operação de consulta. |
Consultas de exemplo
Encontre consultas de amostra no repositório GitHub de exemplos de malha.