Ler em inglês

Compartilhar via


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.