Scaricare i log sul gateway dati della rete virtuale (VNet)

È possibile scaricare i log di diagnostica per il gateway dati di rete virtuale dalla pagina Gestisci connessioni e gateway . Le sezioni seguenti descrivono ogni tipo di log, il relativo periodo di conservazione e il formato di file e come interpretarne i campi.

Note

  • Per scaricare i log, è necessario essere un amministratore del gateway dati di rete virtuale. Selezionare l'opzione Gestisci utenti per determinare se si è un amministratore.
  • I periodi di conservazione dei log sono fissi e non possono essere modificati.
  • Il gateway deve essere online e in esecuzione per generare i log. I log raccolti in precedenza possono essere scaricati mentre il gateway è offline, entro il periodo di conservazione. Controllare lo stato della rete virtuale selezionando l'icona nella colonna Stato.
  • Il download non è disponibile se il collegamento privato Fabric è abilitato nel tenant.
  • Se il download non viene visualizzato, verificare che i popup non siano disabilitati nel browser.
  • Questa funzionalità non è disponibile in determinate aree geografiche e nelle aree US Gov Virginia.

Come scaricare i log

  1. Nell'intestazione della pagina nel servizio Power BI, selezionare l'icona Impostazioni e quindi selezionare Gestisci connessioni e gateway.

  2. Selezionare la scheda Gateway dati di rete virtuale.

  3. Trovare il gateway dati della rete virtuale e, nella stessa riga, selezionare l'icona di download.

    Screenshot della pagina Gestisci connessioni e gateway che mostra l'icona di download della diagnostica

  4. Nella finestra popup è possibile scegliere la categoria di log specifica necessaria o selezionare tutti i log disponibili. Inoltre, è possibile scegliere un intervallo di tempo predefinito o personalizzare l'intervallo di tempo in base alle proprie esigenze.

    Screenshot della finestra di dialogo di diagnostica di download in cui si sceglie la categoria di log e l'intervallo di tempo

  5. Selezionare il pulsante Scarica diagnostica e visualizzare i log nella cartella scaricata.

Contatori di Sistema

I contatori di sistema forniscono misurazioni della CPU e della memoria per singole istanze del gateway.

  • Periodo di conservazione: 29 giorni
  • Formato: Parquet
Attributo Descrizione
Timestamp L'ora in cui è stato emesso il contatore.
Documento d'identità Identificatore univoco dell'istanza del gateway (nodo) che ha segnalato la misurazione.
MemoriaImpegnataInMB Memoria usata su un totale di 8 GB di RAM riservata per VNet.
PercentualeUtilizzoCPU CPU utilizzata.
MemoryAvailableinMB Memoria disponibile.

MashupLogs

I log mashup contengono informazioni dettagliate sulle azioni eseguite dal motore di Power Query. Usare questi log per analizzare l'esecuzione delle query e risolvere gli errori.

  • Periodo di conservazione: 48 ore
  • Formato: JSONL
Attributo Descrizione
Inizio Inizio dell'azione.
Azione Nome dell'azione.
VersioneDelProdotto Versione di Mashup.
ID di Attività Identificatore dell'attività.
IdentificatoreDiCorrelazione Identificatore di correlazione.
Procedura Nome del processo.
PID Identificatore del processo.
Tempo Identificatore del thread.
Durata Durata dell'azione.

QueryExecutionReport

I report di esecuzione delle query forniscono informazioni sulle singole query elaborate dal gateway, inclusi i tempi di esecuzione e lo stato. Usare questi report per analizzare le query lente o non riuscite e identificare l'istanza del gateway che li ha gestiti.

  • Periodo di conservazione: 29 giorni
  • Formato: Parquet
Attributo Descrizione
Documento d'identità Identificatore del log.
Timestamp Inizio dell'esecuzione della query.
QueryId Identificatore di query.
ID dell’istanza Identificatore univoco dell'istanza del gateway (nodo) che ha segnalato il record di diagnostica.
ID di richiesta Identificatore della richiesta.
TipoDiRichiesta Tipo di query, ad esempio DirectQuery o Operazioni di aggiornamento dati, inclusi gli aggiornamenti semantici del modello e del flusso di dati.
ConnectionPath Tipi e percorsi delle origini dati.
stato Indica se la query non è riuscita o ha avuto esito positivo.
Ora di Inizio Inizio dell'esecuzione della query.
DurataMS Durata della query in millisecondi.
OraDiInizioEsecuzione Inizio dell'esecuzione della query.
ExecutionDurationMS Durata della query in millisecondi.
DataReadingAndSerializationStartTime Inizio della serializzazione dei dati.
DurataLetturaDatiESerializzazioneMS Durata della serializzazione dei dati.
StreamingDurationMS Durata del flusso di dati.

ResourceConsumption

I log di consumo delle risorse registrano il consumo di capacità attribuito al gateway. Usare questi log per esaminare il consumo nel tempo e identificare la capacità di Fabric associata.

  • Periodo di conservazione: 29 giorni
  • Formato: Parquet
Attributo Descrizione
ID capacità ID della capacità addebitata.
UnitDiCapacitàSecondi Il consumo di capacità viene emesso come CapacityUnitSeconds.
GatewayId Identificatore del cluster del gateway.
GatewayName Nome del cluster del gateway.
id Identificatore del log.
Timestamp Il consumo di tempo è stato emesso.

PipelineExecutionReport e CopyJobExecutionReport

Questi report forniscono informazioni sulle attività della pipeline e sulle attività dei processi di copia elaborate dal gateway. Questi report descrivono l'esecuzione dell'attività sul lato gateway. Non descrivono necessariamente l'intera pipeline o la durata end-to-end del processo di copia. Usali per analizzare la coda, la durata dell'esecuzione, lo stato e gli errori.

  • Periodo di conservazione: 29 giorni
  • Formato: Parquet
Attributo Descrizione
Id Identificatore univoco per il report di diagnostica.
Timestamp Ora in cui il gateway genera il report, in UTC.
InstanceId Identificatore univoco dell'istanza del gateway (nodo) che segnala il record di diagnostica.
RequestId Identificatore associato alla richiesta.
ArtifactType Tipo di artefatto associato all'esecuzione.
TaskId Identificatore dell'attività di esecuzione.
WorkspaceId Identificatore dell'area di lavoro associata, se disponibile.
PipelineRunId Identificatore dell'esecuzione della pipeline associata, se disponibile.
PipelineName Nome della pipeline associata, se disponibile.
ActivityRunId ID esecuzione attività.
ActivityType Tipo di attività.
QueueTime Tempo segnalato trascorso in coda, in secondi.
Status Stato di esecuzione segnalato.
ExecutionStartTime Ora di inizio dell'esecuzione, in formato UTC.
ExecutionDurationMS Durata dell'esecuzione, in millisecondi.
ErrorCode Codice di errore associato all'esecuzione, se disponibile.

InstanceLoad

La diagnostica del carico di istanza fornisce le misurazioni del carico di lavoro per ogni istanza del gateway, inclusi i segnali di carico usati dalla scalabilità automatica, le valutazioni medie in coda e le valutazioni in esecuzione e l'attività della pipeline. Usare questi log per esaminare l'accodamento e la domanda di carichi di lavoro e correlare il carico con le tendenze cronologiche del numero di istanze.

  • Periodo di conservazione: 29 giorni
  • Formato: Parquet
Attributo Descrizione
Timestamp Ora in cui il report di caricamento è stato generato, in formato UTC.
Id Identificatore univoco dell'istanza del gateway (nodo) che ha segnalato le misurazioni.
AggregateLoadPercent Segnale di carico complessivo che la scalabilità automatica usa per l'istanza del gateway, in base alla domanda di valutazione e all'attività della pipeline.
DefaultPoolLoadPercent Carico medio di valutazione nel pool predefinito, incluse le valutazioni in coda e in esecuzione, espresso come percentuale della capacità del pool.
DefaultPoolAveragePendingCount Numero medio di valutazioni in attesa di esecuzione nel pool predefinito.
DefaultPoolAverageRunningCount Numero medio di valutazioni in esecuzione nel pool predefinito.
DirectQueryPoolLoadPercent Carico medio di valutazione nel pool DirectQuery, incluse le valutazioni in coda e in esecuzione, espresso come percentuale della capacità del pool.
DirectQueryPoolAveragePendingCount Numero medio di valutazioni in attesa di esecuzione nel pool DirectQuery.
DirectQueryPoolAverageRunningCount Numero medio di valutazioni in esecuzione nel pool DirectQuery.
PipelinePoolActive Se il pool di pipeline ha segnalato lavoro attivo. Questo valore è un indicatore di attività booleano, non una percentuale di utilizzo.

Per comprendere le tendenze cronologiche del numero di istanze, raggruppare i record in intervalli di tempo e contare valori distinti Id all'interno di ogni intervallo. Questo metodo mostra quante istanze hanno segnalato log durante ogni intervallo, non necessariamente il numero di istanze in esecuzione simultaneamente.