Configurare i file di log per il gateway dati locale

  • Articolo

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

Per controllare le configurazioni di registrazione, seguire questa procedura:

  1. Aprire il file di configurazione del gateway Microsoft.PowerBI.EnterpriseGateway.exe.config, che per impostazione predefinita deve trovarsi in \Programmi\Gateway dati locale.
  2. Prima di procedere, creare una copia di questo file solo nel caso in cui sia necessario ripristinarlo in un secondo momento.
  3. Individuare il listener ApplicationFileTraceListener 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, è stato introdotto il nuovo concetto di conservazione basato sull'età all'interno di un gateway. Questo concetto è il tipo di conservazione predefinito per le nuove installazioni del gateway.

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

  • Spazio massimo su disco da utilizzare dai 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 si garantisce che per ogni nuovo giorno venga effettuato il provisioning di 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. Viene inoltre eseguita la partizione di file entro il giorno se viene raggiunta la dimensione massima del singolo 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>

Se si desidera modificare i valori dei parametri predefiniti di conservazione, è necessario modificarli nel 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 può essere utilizzata dai tre tipi di file di log.
  • Dimensione massima in MB in cui ogni file di log può avere singolarmente. Ogni volta che viene raggiunto il limite, viene creato un nuovo file con un numero sequenziale aggiunto.

Nota

I log del gateway usano timestamp basati su UTC e la rotazione giornaliera dei file di log verrà eseguita alle 00:00 UTC.

Conservazione basata sul conteggio dei file

Si tratta della 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 massimo su disco da utilizzare per tipo di log (GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).

I file vengono partizionati di conseguenza con i criteri elencati in precedenza e pertanto, ogni volta che si raggiunge il numero massimo di file, in genere sarà anche a o vicino al massimo spazio su disco.

L'estratto seguente del file di configurazione del gateway Microsoft.PowerBI.EnterpriseGateway.exe.config contiene le tre categorie: GatewayInfo.log, GatewayErrors.loge 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 verranno conservati 20 file di log, il totale totale di tutti i file di ogni categoria che non supera i 50 MB di dimensioni: GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

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

Nr. Questa logica di conservazione per il momento viene applicata alle installazioni completamente nuove del gateway. I gateway esistenti durante l'aggiornamento a febbraio 2023 o versioni successive devono mantenere la logica di conservazione dei log corrente (conservazione basata sul numero di file).

Passaggi successivi

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