Controllo e eliminazione della traccia sul lato client di Kusto SDK

Le librerie client Kusto usano una piattaforma comune per la traccia. La piattaforma usa un numero elevato di origini di traccia (System.Diagnostics.TraceSource) e ognuna è connessa al set predefinito di listener di traccia (System.Diagnostics.Trace.Listeners) durante la costruzione.

Se un'applicazione dispone di listener di traccia associati all'istanza predefinita System.Diagnostics.Trace (ad esempio, tramite il relativo app.config file), le librerie client Kusto genereranno tracce a tali listener.

La traccia può essere eliminata o controllata a livello di codice o tramite un file di configurazione.

Eliminare la traccia a livello di codice

Per eliminare la traccia dalle librerie client Kusto a livello di codice, richiamare questo frammento di codice durante il caricamento della libreria pertinente:

TraceSourceManager.SetTraceVerbosityForAll(TraceVerbosity.Fatal);

Usare un file di configurazione per eliminare la traccia

Per eliminare la traccia dalle librerie client tramite un file di configurazione, modificare il file Kusto.Cloud.Platform.dll.tweaks (incluso nella Kusto.Data libreria).

    <!--Overrides the default trace verbosity level-->
    <add key="Kusto.Cloud.Platform.Utils.Tracing.OverrideTraceVerbosityLevel" value="0" />

Nota

Per rendere effettiva la modifica, non deve esserci un segno meno nel valore di key

Un'alternativa è:

Anchor.Tweaks.SetProgrammaticAppSwitch(
    "Kusto.Cloud.Platform.Utils.Tracing.OverrideTraceVerbosityLevel",
    "0"
);

Abilitare la traccia delle librerie client

Per abilitare la traccia delle librerie client, abilitare la traccia .NET nel file diapp.config dell'applicazione. Si supponga, ad esempio, che l'applicazione MyApp.exe usi la libreria client Kusto.Data. Se si modifica ilMyApp.exe.config di file in modo da includere quanto segue, si abiliterà Kusto.Data la traccia alla successiva avvio dell'applicazione.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.diagnostics>
    <trace indentsize="4">
      <listeners>
        <add type="Kusto.Cloud.Platform.Utils.RollingCsvTraceListener2, Kusto.Cloud.Platform" name="RollingCsvTraceListener" initializeData="RollingLogs" />
        <remove name="Default" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

Il codice configurerà un listener di traccia che scrive nei file CSV in una sottodirectory denominata RollingLogs. La sottodirectory si trova nella directory del processo.

Nota

Qualsiasi. È anche possibile usare la classe listener di traccia compatibile con NET.

Abilitare la traccia MSAL (Microsoft Authentication Library)

Dopo aver abilitato la traccia per le librerie client, la traccia per MSAL (Microsoft Authentication Library) viene abilitata automaticamente.