Condividi tramite


Operazioni graphQL

I log delle operazioni graphQL fanno parte dei log di monitoraggio dell'area di lavoro e vengono registrati nel database KQL eventhouse, che fa parte della soluzione di intelligence in tempo reale. È possibile usare questi log per monitorare l'utilizzo e le prestazioni dell'area di lavoro.

Log delle operazioni graphQL

Un evento di log per ogni query eseguita dall'API fabric per GraphQL nelle origini dati connesse viene archiviato in due tabelle: GraphQLMetrics e GraphQLLog.

Usare i log di query per:

  • Identificare le modifiche del comportamento e la potenziale riduzione delle prestazioni dell'API.
  • Rilevare query insolite o con elevato carico di risorse.
  • Identificare utenti e applicazioni con il maggior numero di query
  • Analizzare le prestazioni e le tendenze delle query.
  • Risolvere i problemi relativi alle query lente.
  • Diagnosticare i problemi relativi a query GraphQL specifiche.

Questa tabella elenca i log graphQL.

Nome colonna Tipo Descrizione
Timestamp: datetime Timestamp (UTC) di quando la voce di log è stata generata quando il record è stato creato dall'origine dati.
ItemId string ID univoco della risorsa che registra i dati.
ItemKind string Tipo di elemento che registra l'operazione.
ItemName string Nome dell'artefatto fabric che registra questa operazione.
WorkspaceId string Identificatore univoco dell'area di lavoro Infrastruttura che contiene l'artefatto utilizzato
WorkspaceName string Nome dell'area di lavoro Infrastruttura contenente l'artefatto.
CapacityId string Identificatore univoco della capacità che ospita l'artefatto su cui viene eseguito l'esecuzione.
CustomerTenantId string ID tenant del cliente, in cui è stata eseguita l'operazione.
PlatformMonitoringTableName string Il nome della tabella ai record appartiene (o al tipo di evento certificato del record). Il formato è <WorkloadName> + [OperationType>]+ <TelemetryType>
Paese string Area della risorsa che emette l'evento; ad esempio Stati Uniti orientali o Francia meridionale.
MetricTimeGrain string Intervallo di tempo della metrica (durata ISO 8601).
MetricUnitName string Unità della metrica.
MetricSumValue long Valore di somma aggregato di una metrica durante un singolo minuto.
DatasourceTypes dynamic Matrice di tipi DataSource utilizzati dal modello.
ResultCode string Codice errore delle attività non riuscite, usato per estendere l'utilizzo all'affidabilità.
Stato string Stato dell'operazione. La query è stata eseguita correttamente con errori o errori.

Attributi del log GraphQL

Questa tabella descrive gli attributi GraphQLLogs. Per altre informazioni sugli eventi e un drill-down nell'evento ExecutionMetrics , vedere Eventi e schema.

Nome colonna Tipo Descrizione
Timestamp: datetime Timestamp (UTC) di quando la voce di log è stata generata quando il record è stato creato dall'origine dati.
OperationName string Nome dell'operazione.
ItemId string ID univoco della risorsa che registra i dati.
ItemKind string Tipo di elemento che registra l'operazione.
ItemName string Nome dell'artefatto fabric che registra questa operazione.
WorkspaceId string Identificatore univoco dell'area di lavoro Infrastruttura che contiene l'artefatto su cui viene eseguito l'operazione.
WorkspaceName string Nome dell'area di lavoro Infrastruttura contenente l'artefatto.
CapacityId string Identificatore univoco della capacità che ospita l'artefatto su cui viene eseguito l'esecuzione.
CorrelationId string ID attività radice.
OperationId string Identificatore univoco per l'operazione registrata.
Identità dynamic Dettagli utente e attestazione. Utente associato all'operazione segnalata.
CustomerTenantId string ID tenant del cliente, in cui è stata eseguita l'operazione.
DurationMs long Tempo di CPU trascorso che è trascorso mentre tutte le operazioni necessarie sono state elaborate. L'unità è espressa in millisecondi.
Stato string Stato dell'operazione. La query è stata eseguita correttamente con errori o errori.
Livello string Metadati richiesti dal team di monitoraggio della piattaforma.
Paese string Area della risorsa che emette l'evento; ad esempio Stati Uniti orientali o Francia meridionale.
PlatformMonitoringTableName string Il nome della tabella ai record appartiene (o al tipo di evento certificato del record). Il formato è <WorkloadName> + [OperationType>]+ <TelemetryType>
QueryText string Testo della query.
GraphQLOverheadDurationMs long Overhead graphQL in ms per una richiesta del piano dati.
ProcessedBytes long Volume di dati elaborato in byte.
TransportProtocol string Protocollo di trasporto per una richiesta.
QueryResultMessage string Questa dimensione viene utilizzata per fornire contesto aggiuntivo al risultato di un'operazione di query.

Query di esempio

È possibile trovare query di esempio nel repository GitHub fabric-samples .