Configurare i file di log per il gateway dati locale

Il gateway dati locale ha tre categorie di log del servizio: informazioni, errori e rete. Questa categorizzazione offre un'esperienza di risoluzione dei problemi che consente di concentrarsi sull'area specifica di un errore o problema.

Per controllare le configurazioni di registrazione, seguire questa procedura:

1. Aprire il file Microsoft.PowerBI.EnterpriseGateway.exe.configdi configurazione del gateway. Per impostazione predefinita, è possibile trovare questo file in \Program Files\On-premises data gateway.
2. Creare una copia di questo file nel caso in cui sia necessario ripristinarla in un secondo momento.
3. Trovi il listener ApplicationFileTraceListener, che si trova sotto system.diagnostics.

Le sezioni seguenti forniscono i dettagli di configurazione per tipo di conservazione, che dipende dalla versione del gateway.

Conservazione basata sull'età

A partire da febbraio 2023, il gateway introduce un nuovo concetto di conservazione basato sull'età. Questo concetto è il tipo di conservazione predefinito per le nuove installazioni del gateway.

Per questo tipo di conservazione, considerare due aspetti principali (in ordine di precedenza):

• Spazio su disco massimo per i log del gateway (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log), con un valore predefinito di 5 GB.
• Periodo di conservazione in giorni, con un valore predefinito di 30 giorni.

In questa nuova logica, il gateway garantisce che per ogni nuovo giorno crei un nuovo file di log. Questo provisioning garantisce che le informazioni per un determinato giorno siano presenti nei file di log in cui il nome file corrisponde alle date di immissione del log. Inoltre, il gateway esegue il partizionamento dei file entro il giorno se viene raggiunta la dimensione massima del file (valore predefinito di 100 MB).

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener" type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.AgeBasedRetentionRotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common" initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,30,5120,100" />
      </listeners>
    </trace>
  </system.diagnostics>

Per modificare i valori dei parametri predefiniti di conservazione, modificare il initializeData valore. L'elenco seguente descrive ogni parametro:

• Periodo di conservazione in giorni (valore compreso tra 1 e 365 giorni).
• Dimensione totale massima in MB che i tre tipi di file di log possono utilizzare.
• Dimensioni massime in MB che ogni file di log può avere singolarmente. Ogni volta che viene raggiunto il limite, il gateway crea un nuovo file con un numero sequenziale aggiunto.

Conservazione basata sul conteggio dei file

Questo stile era la logica di conservazione dei log predefinita all'interno di un gateway per le versioni di dicembre 2022 e precedenti. Questa logica ha due concetti principali:

• Numero di file da conservare per tipo di log (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
• Spazio su disco massimo da utilizzare per tipo di log (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

I file vengono partizionati in base a questi criteri. Pertanto, ogni volta che si raggiunge il numero massimo di file, in genere si raggiunge lo spazio massimo su disco.

L'estratto seguente del file di configurazione del gateway Microsoft.PowerBI.EnterpriseGateway.exe.config contiene le tre categorie: GatewayInfo.log, GatewayErrors.log e GatewayNetwork.log.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener"
             type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.RotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common"
             initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50" />
      </listeners>
    </trace>
  </system.diagnostics>

Per impostazione predefinita, il file di configurazione del gateway si trova nella directory \Programmi\Gateway dati locale. Per impostare il numero di file di log da conservare, modificare il primo numero nel valore del initializeData file. Per configurare le dimensioni di ogni file di log, modificare il secondo numero.

Nell'esempio seguente viene specificato che vengono conservati 20 file di log e che la somma totale di tutti i file in ogni categoria non è superiore a 50 MB di dimensioni: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

La nuova logica di conservazione basata sull'età viene applicata per impostazione predefinita all'installazione del gateway dati locale esistente?

No Questa logica di conservazione si applica attualmente solo alle nuove installazioni di gateway. I gateway esistenti che si aggiornano a febbraio 2023 o versioni successive mantengono la logica di conservazione dei log corrente (conservazione basata sul numero di file).

Consenso dell'amministratore per la diagnostica del gateway (Anteprima)

Il consenso amministratore per la diagnostica del gateway è una funzionalità usata dagli amministratori per controllare in modo esplicito se i dati di diagnostica dai gateway dati locali vengono raccolti e inviati al cloud.

La funzionalità diagnostica del gateway introduce un modello basato sul consenso per garantire che i dati potenzialmente sensibili, ad esempio i log Mashup, vengano trasmessi solo dopo l'approvazione amministrativa. Consente anche funzionalità future di monitoraggio e diagnostica. Per il momento, questa funzionalità è applicabile solo all'artefatto Dataflows Gen2. Per altre informazioni, vedere Scaricare i log di aggiornamento dettagliati.

Come funziona

Gli amministratori del gateway possono abilitare la diagnostica del gateway nelle impostazioni del gateway. Quando si abilita questa impostazione, il gateway inizia a raccogliere e inviare dati di diagnostica al cloud.

Gli amministratori tenant offrono un livello aggiuntivo di governance controllando il consenso a livello di organizzazione per la diagnostica. Per impostazione predefinita, gli amministratori del gateway possono abilitare la diagnostica senza richiedere l'approvazione a livello di tenant. Tuttavia, gli amministratori tenant possono revocare il consenso in qualsiasi momento per arrestare la raccolta dei dati di diagnostica in tutti i gateway dell'organizzazione.

Se il consenso a livello di tenant viene revocato, tutti i gateway interrompono immediatamente l'invio dei dati di diagnostica e qualsiasi trasferimento di dati in corso viene interrotto.

Per l'immediata attuazione, il riavvio del gateway dati locale termina tutti i caricamenti di diagnostica in corso.

Il servizio archivia i dati di diagnostica del gateway per 24 ore in un Azure Data Lake Storage gestito dal servizio. Dopo 24 ore, i dati non sono più disponibili per il download.

Comportamento di caricamento

Quando si attiva la diagnostica del gateway, il gateway carica i file di diagnostica periodicamente in batch. I caricamenti non sono in streaming continuo e non sono in tempo reale. Il gateway verifica la presenza di file di diagnostica caricabili circa ogni 60 secondi, quindi in genere si verifica un ritardo di circa 1-2 minuti tra la generazione di traccia e la disponibilità nell'archiviazione gestita Microsoft.

Ogni caricamento è una richiesta HTTPS in uscita di breve durata dal computer gateway. Dopo che un file di diagnostica viene caricato correttamente, il gateway elimina immediatamente la copia locale nell'area di staging.

Requisiti di rete

Aggiungere la riga seguente alla tabella dei requisiti di rete:

L'account di archiviazione usato per il caricamento dei dati di diagnostica è gestito da Microsoft e può variare a seconda dell'area geografica. Poiché il nome dell'account dipende dall'area, consentire il traffico HTTPS in uscita a *.dfs.core.windows.net o usare il tag del servizio Archiviazione di Azure.

Se il tuo ambiente utilizza un proxy che ispeziona il traffico TLS, assicurati che il proxy preservi l'URL completo della richiesta, inclusa la stringa di query SAS. Il token SAS è necessario affinché il gateway possa caricare i file diagnostici.

Abilitare la diagnostica del gateway

È possibile abilitare la diagnostica del gateway solo nel cloud da Gestisci connessioni e gateway nel servizio Power BI o Microsoft Fabric. L'applicazione del gateway dati locale non dispone di un'impostazione per abilitare questa funzionalità.

Prima di abilitare la diagnostica del gateway, verificare i prerequisiti seguenti:

• Il gateway è in esecuzione in modalità standard. I gateway in modalità personale non sono supportati.
• Il tracciamento ETW è abilitato sul gateway.
• Per i cluster gateway, ogni membro del cluster carica la diagnostica in modo indipendente. Assicurarsi che il firewall in uscita e le regole proxy siano configurati per ogni nodo del gateway nel cluster.

Spazio su disco e occupazione di archiviazione

I dati di staging della diagnostica del gateway vengono scritti nel percorso LOCALAPPDATA dell'account del servizio del gateway, non nella directory di installazione del gateway. La sottocartella MSessions contiene i file locali di preparazione utilizzati per il caricamento dei dati diagnostici.

In stato stabile, la conservazione locale è in genere di circa uno o due minuti perché i file vengono eliminati immediatamente dopo il caricamento riuscito. In caso di errore o di nuovo tentativo, i dati temporanei locali possono rimanere presenti fino a circa un'ora.

Questo spazio di archiviazione è distinto da e si aggiunge al limite di 5 GB per la conservazione locale dei log documentato per i log del gateway. Come punto di partenza, pianificare da circa 5 a 10 GB di spazio disponibile su disco aggiuntivo in ogni computer gateway, quindi monitorare l'utilizzo effettivo nell'ambiente e regolare in base alle esigenze.

Livello di sicurezza del caricamento dei dati diagnostici

Il caricamento dei dati di diagnostica del gateway usa un token SAS limitato a una directory e di breve durata tramite HTTPS. Il token SAS è valido per un periodo limitato, attualmente fino a nove ore, e concede solo autorizzazioni di scrittura, ad esempio Aggiungi, Scrivi e Crea.

Il gateway può caricare i file di diagnostica, ma non può leggere, elencare o enumerare i dati di diagnostica caricati.

Domande frequenti sulla diagnostica del gateway per i gateway dati locali in Fabric

Le impostazioni di diagnostica dei gateway dati on-premises consentono di raccogliere log di diagnostica dettagliati per risolvere i problemi relativi alle operazioni di aggiornamento di Dataflow Gen2 in Fabric. Questa sezione risponde alle domande comuni su dove vengono archiviati i log caricati, quali informazioni vengono raccolte, chi può accedere ai log e se l'archiviazione ha costi aggiuntivi.

È necessaria una registrazione aggiuntiva per la diagnostica del gateway?

La diagnostica del gateway e la registrazione aggiuntiva sono funzionalità separate. La registrazione aggiuntiva non è necessaria per il caricamento della diagnostica.

Le due funzionalità scrivono in destinazioni diverse: la registrazione aggiuntiva produce log locali più dettagliati, mentre la diagnostica del gateway archivia temporaneamente in locale i dati di diagnostica e li carica in un archivio gestito da Microsoft previo consenso del tenant e abilitazione a livello di gateway.

Qual è la relazione tra le impostazioni di diagnostica dei gateway dati locali e i flussi di dati?

Le impostazioni di diagnostica dei gateway dati locali si applicano attualmente solo a Fabric Dataflow Gen2. Quando viene eseguito un aggiornamento di Dataflow Gen2:

• Il gateway raccoglie le informazioni di diagnostica necessarie per la risoluzione dei problemi.
• Il sistema carica i log mashup pertinenti nell'archiviazione gestita da Microsoft.
• I log associati all'esecuzione dell'aggiornamento.
• Gli utenti possono scaricare la diagnostica dettagliata dalla pagina della cronologia degli aggiornamenti di Dataflow Gen2.

Questa funzionalità potrebbe anche supportare scenari di diagnostica futuri.

Quali log vengono raccolti e caricati?

Attualmente, le impostazioni di diagnostica dei gateway dati locali caricano principalmente i log di Mashup Engine associati alle operazioni di aggiornamento di Fabric Dataflow Gen2.

Esempi di informazioni raccolte includono:

• Dettagli sull'esecuzione dell'aggiornamento di Dataflow Gen2.

• Diagnostica del motore Mashup.

• Elaborazione delle query e tracce di esecuzione.

Dove vengono archiviati i log caricati?

L'area di registrazione a Power BI o Fabric del tenant determina la posizione di archiviazione. L'archiviazione gestita da Microsoft nell'area del tenant applicabile archivia i log caricati.

Quali aree Azure supportano questa funzionalità?

Tutte le aree supportate Fabric che offrono l'infrastruttura di archiviazione gestita supportano le impostazioni di diagnostica dei gateway dati locali. Questa funzionalità non è disponibile nell'area del Qatar.

I dati caricati contengono informazioni riservate?

Yes. La diagnostica caricata potrebbe contenere informazioni che i clienti considerano sensibili. La funzionalità è disabilitata per impostazione predefinita. Esaminare i criteri di gestione e supporto dei dati dell'organizzazione prima di scegliere le impostazioni di diagnostica dei gateway dati locali.

Quanto tempo vengono archiviati i log?

Il sistema conserva i dati di diagnostica per 24 ore. È possibile scaricare i dati dalle esecuzioni di Dataflow Gen2 in Fabric durante questo periodo di 24 ore.

Chi può accedere ai log caricati?

L'accesso è strettamente controllato. Microsoft personale non accede regolarmente ai log caricati. L'accesso è limitato per impostazione predefinita e concesso solo quando necessario nelle procedure operative approvate.

È previsto un costo aggiuntivo per l'archiviazione di questi log?

No A partire da oggi, le impostazioni di diagnostica dei gateway dati locali vengono fornite senza costi aggiuntivi.

Troubleshooting

La diagnostica è abilitata, ma non vengono visualizzati log

Se la diagnostica è abilitata ma i log di diagnostica non vengono visualizzati, controllare gli elementi seguenti:

1. Verificare l'accesso HTTPS in uscita sulla porta 443 a *.dfs.core.windows.net.

2. Verificare che il gateway sia in esecuzione in modalità standard. I gateway in modalità personale non sono supportati.

3. Verificare che il consenso del tenant per la diagnostica del gateway non sia stato revocato.

4. Verificare nel file GatewayInfo*.log la presenza delle righe di traccia di DiagnosticsUploader e DiagnosticsStorageClient. I messaggi di tracciamento utili includono: Trovati N file caricabili, AuthenticationFailed, Numero massimo di tentativi non riusciti raggiunto

5. Se si verificano tre errori di caricamento consecutivi, la raccolta di diagnostica si arresta fino al rinnovo dell'accesso. Questo comportamento può rendere la diagnostica disattivata in modo imprevisto, anche se la causa radice è un errore di caricamento ripetuto.

Contenuti correlati

Per informazioni su come esportare i log del gateway per la risoluzione dei problemi, vedere Strumenti per la risoluzione dei problemi.