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.