Controllo e eliminazione della traccia del lato client di Kusto SDKControlling and suppressing Kusto SDK client-side tracing

Le librerie client di Kusto usano una piattaforma comune per la traccia.The Kusto Client Libraries use a common platform for tracing. La piattaforma usa un numero elevato di origini di traccia ( System.Diagnostics.TraceSource ) e ciascuna è connessa al set predefinito di listener di traccia ( System.Diagnostics.Trace.Listeners ) durante la costruzione.The platform uses a large number of trace sources (System.Diagnostics.TraceSource), and each is connected to the default set of trace listeners (System.Diagnostics.Trace.Listeners) during its construction.

Se un'applicazione dispone di listener di traccia associati all' System.Diagnostics.Trace istanza predefinita (ad esempio, tramite il relativo app.config file), le librerie client di Kusto emetteranno tracce per tali listener.If an application has trace listeners associated with the default System.Diagnostics.Trace instance (for example, through its app.config file), then the Kusto Client Libraries will emit traces to those listeners.

La traccia può essere evitata o controllata a livello di codice o tramite un file di configurazione.The tracing can be suppressed or controlled programmatically or through a config file.

Disattiva traccia a livello di codiceSuppress tracing programmatically

Per disattivare la traccia dalle librerie client di Kusto a livello di codice, richiamare questa parte di codice durante il caricamento della libreria pertinente:To suppress tracing from the Kusto client libraries programmatically, invoke this piece of code when loading the relevant library:

Kusto.Cloud.Platform.Utils.TraceSourceManager.SetTraceVerbosityForAll(
    Kusto.Cloud.Platform.Utils.TraceVerbosity.Fatal
    );

Usare un file di configurazione per disattivare la tracciaUse a config file to suppress tracing

Per disattivare la traccia dalle librerie client di Kusto tramite un file di configurazione, modificare il file Kusto.Cloud.Platform.dll.tweaks (incluso nella Kusto.Data libreria).To suppress tracing from the Kusto client libraries through a config file, modify the file Kusto.Cloud.Platform.dll.tweaks (which is included with the Kusto.Data library).

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

Nota

Per rendere effettiva la modifica, non è necessario un segno meno nel valore dikeyFor the tweak to take effect, there must not be a minus sign in the value of key

Un'alternativa è:An alternative, is:

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

Abilitare la traccia delle librerie client kustoEnable the Kusto client libraries tracing

Per abilitare la traccia dalle librerie client di Kusto, abilitare la traccia di .NET nel file app. configdell'applicazione.To enable tracing out of the Kusto client libraries, enable .NET tracing in your application's app.config file. Si supponga, ad esempio, che l'applicazione MyApp.exe utilizzi la libreria client kusto. Data.For example, assume that the application MyApp.exe uses the Kusto.Data client library. Se si modifica il file MyApp. exe. config in modo da includere quanto segue, la traccia verrà abilitata Kusto.Data al successivo avvio dell'applicazione.Changing file MyApp.exe.config to include the following, will enable Kusto.Data tracing the next time that the application starts.

<?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 consente di configurare un listener di traccia che scrive nei file CSV in una sottodirectory denominata RollingLogs.The code will configure a trace listener that writes to CSV files in a subdirectory called RollingLogs. La sottodirectory si trova nella directory Process.The subdirectory is located in the process' directory.

Nota

Qualsiasi. È possibile utilizzare anche la classe del listener di traccia compatibile con NETAny .NET-compatible trace listener class may be used as well

Abilitare la traccia delle librerie client di Azure AD (ADAL)Enable the Azure AD client libraries (ADAL) tracing

Una volta abilitata la traccia per le librerie client di Kusto, è quindi la traccia eseguita dalle librerie client di Azure AD.Once tracing for the Kusto client libraries is enabled, so is the tracing by the Azure AD client libraries. Le librerie client di Kusto configurano automaticamente la traccia ADAL.The Kusto client libraries automatically configure ADAL tracing.