Condividi tramite


Traccia dei client di dati

Sono disponibili più opzioni per la traccia, che consentono di acquisire problemi nell'origine dati consumer, componenti del servizio, provider, rete e host.

Traccia del consumer SQL tramite SQL Server Profiler

SQL Server Profiler è un'interfaccia utente grafica di Traccia SQL che consente di monitorare un'istanza del motore di database o di Analysis Services. È possibile acquisire e salvare i dati di ogni evento in un file o in una tabella per operazioni di analisi successive. Per altre informazioni, vedere Introducing SQL Server Profiler (https://go.microsoft.com/fwlink/?LinkID=180433).

Traccia del provider di dati tramite l'utilità di traccia del provider

L'utilità di traccia HIS acquisisce e salva le informazioni dalle connessioni client di rete Microsoft DB2 e Informix, dalle interfacce del provider e dai messaggi di dati. Per altre informazioni, vedere Guida dell'utilità di traccia e Utilità traccia SNA.

Traccia di rete tramite Network Monitor

Network Monitor acquisisce il traffico di rete per la visualizzazione e l'analisi. Consente di eseguire attività quali l'analisi dei dati acquisiti in precedenza con i metodi definiti dall'utente e l'estrazione dei dati dai parser di protocollo definiti. Include un parser DDM (Distributed Gestione dati) da usare con i client di rete dati HIS. Contattare il Servizio Supporto Tecnico Clienti Microsoft per una copia del parser DDM. Per altre informazioni, vedere Monitoraggio di rete (https://go.microsoft.com/fwlink/?LinkID=180448).

Traccia del server DB2 tramite strumenti IBM

Per ulteriori informazioni, vedere la guida all'amministrazione di IBM DB2 per conoscere la versione e la piattaforma di DB2 applicabili.

Traccia server Informix con gli strumenti IBM

Per altre informazioni, vedere la Guida all'amministrazione di IBM Informix per la piattaforma e la versione informix applicabili.

Eventi di Windows Server tramite il Visualizzatore eventi

Il Visualizzatore eventi è uno snap-in di MMC (Microsoft Management Console) che consente all'utente di esplorare e gestire i registri eventi. Per altre informazioni, vedere Visualizzatore eventi (https://go.microsoft.com/fwlink/?LinkID=131274).

Traccia del client del file host e del provider di dati

Il client file host e ADO.NET provider di dati per i file host (client file host) supporta un listener di traccia del testo di integrazione host Microsoft configurato tramite un file di configurazione HIDT (Host Integration Tracing Definition) a cui viene fatto riferimento nell'elemento di diagnostica di sistema del file di app.config del consumer di dati.

File di App.Config consumer di dati

Il file di app.config consumer di dati contiene un elemento della sezione di configurazione di Microsoft Host Integration Tracing e un elemento Listener file di testo host integration server che controlla la traccia del client di file host. In questo esempio il file MsHostFileClient.HITD (Host Integration Tracing Definition) deve trovarsi nella directory del programma Data Consumer.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="microsoft.hostintegration.tracing" type="Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=9.0.1000.0, PublicKeyToken=31bf3856ad364e35" />
  </configSections>

  <microsoft.hostintegration.tracing
    traceDefinitionFile=" MsHostFileClient.HITD" />

  <system.diagnostics>
    <trace>
      <listeners>
        <add
          name="HisTextFileListener"
          type="Microsoft.HostIntegration.Tracing.HisTextFileTraceListener, Microsoft.HostIntegration.Tracing.Runtime, Culture=neutral, Version=9.0.1000.0, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL"
          maxTraceEntries="1000000"
          traceFileFolder="C:\Program Files\Microsoft Host Integration Server 2020\traces\"
          autoFlush="true"
          fileNamePreamble="MsHostFileClient"
          allowNonHisTracingToCreateFile="true"
    />
      </listeners>
    </trace>
  </system.diagnostics>
  <startup>
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
    </startup>
</configuration>

Sezione Di configurazione

L'elemento configSections contiene le dichiarazioni della sezione di configurazione e dello spazio dei nomi per il componente Microsoft Host Integration Tracing.

Nome sezione di configurazione

L'attributo del nome della sezione definisce il nome del componente Microsoft Host Integration Tracing. Questo attributo obbligatorio accetta una stringa, con il valore Microsoft.hostintegration.tracing.

Tipo di sezione di configurazione

L'attributo type definisce il tipo del listener di traccia del testo di Traccia integrazione host Microsoft. Questo attributo obbligatorio accetta una stringa, con il valore Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35.

Sezione Traccia integrazione host

L'elemento microsoft.hostintegration.tracing contiene informazioni di configurazione per il listener di traccia del testo del componente Microsoft Host Integration Tracing.

File di definizione di traccia

L'attributo traceDefinitionFile definisce il nome del file di output del listener di traccia di traccia dell'integrazione host Microsoft. Questo attributo obbligatorio accetta una stringa, con un valore che rappresenta un percorso di output di traccia e un nome file.

Nota

Ogni account utente deve avere accesso in scrittura alla cartella traces, per inserire righe nel file di traccia di testo. Ogni account utente richiede le impostazioni dell'elenco Controllo di accesso cartelle associate al gruppo locale Utenti runtime HIS. Per altre informazioni, vedere la sezione Sicurezza e protezione.

Diagnostica del sistema

L'elemento system.diagnostics contiene una configurazione aggiuntiva per il listener di traccia del testo del componente Analisi integrazione host Microsoft.

Nome listener di traccia

L'attributo name definisce il nome del listener di traccia di testo client del file host. Questo attributo obbligatorio accetta una stringa, con il valore HisTextFileListener.

Tipo di listener di traccia

L'attributo type definisce il tipo del listener di traccia del testo del servizio DRDA. Questo attributo obbligatorio accetta una stringa, con il valore Microsoft.HostIntegration.Tracing.HisTextFileTraceListener, Microsoft.HostIntegration.Tracing.Runtime, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL.

Numero massimo di voci di traccia

L'attributo maxTraceEntries indica al client file host di tracciare fino a un numero massimo di voci e quindi di arrestare la traccia. Questo attributo facoltativo accetta un numero intero. Il valore predefinito è 1000000.

Cartella file di traccia

L'attributo traceFileFolder indica al listener di traccia del testo client del file host dove scrivere il file di output di traccia del listener di testo. Questo attributo facoltativo accetta un valore stringa . Il valore predefinito è C:\Programmi\Microsoft Host Integration Server 2013\traces.

Nota

Ogni account utente deve avere accesso in scrittura alla cartella traces, per inserire righe nel file di traccia di testo. Ogni account utente richiede le impostazioni dell'elenco Controllo di accesso cartelle associate al gruppo locale Utenti runtime HIS. Per altre informazioni, vedere la sezione Sicurezza e protezione.

Scaricamento automatico

L'attributo autoFlush indica al servizio DRDA di scaricare automaticamente i dati nel listener di traccia. Questo attributo facoltativo accetta un valore booleano . Il valore predefinito è false.

Nota

Il listener di traccia di testo del client di file host può scaricare automaticamente i dati di traccia nei listener di traccia, garantendo l'acquisizione dei dati di traccia, ma aumenterà l'I/O del disco e ridurrà le prestazioni complessive del sistema. Per migliorare le prestazioni, impostare autoFlush=false per disabilitare lo scaricamento automatico della traccia.

Nome file di traccia

L'attributo name definisce il nome del file di output di traccia di testo del client del file host. Questo attributo obbligatorio accetta una stringa.

Inizializzazione del listener di traccia

L'attributo allowNonHisTracingToCreateFile definisce se la traccia può essere avviata da un componente diverso da Host File Client e Microsoft Host Integration Tracing. Questo attributo obbligatorio accetta un valore booleano, con un valore predefinito false.

File HITD (Host Integration Tracing Definition)

Il file di configurazione HIDT (Host Integration Tracing Definition) definisce il livello di traccia per il listener di file di testo host integration server.

Contenitori di traccia

L'elemento containers include elementi contenitore che definiscono i livelli di traccia per ogni punto di traccia.

Nome contenitore di traccia

L'attributo name definisce il nome del contenitore di traccia. Questo attributo obbligatorio accetta una stringa, con un valore HostFiles.

Nome punto di traccia

L'attributo name definisce il nome del punto di origine della traccia. Questo attributo obbligatorio accetta una stringa. Il valore predefinito è una stringa vuota.

Valore Descrizione
HostFiles provider ADO.NET per i file host
Trasporto Client file host per DDM RLIO
Convertitore di aggregazioni Convertitore di aggregazioni del codificatore host Integration Server
Convertitore primitivo Convertitore primitivo del codificatore host Integration Server

Tabella 1. Nomi dei punti di origine di traccia file host.

Livello di traccia

L'attributo traceLevel indica al client file host di tracciare raccolte definite di informazioni, da un minimo a un livello massimo di traccia. Questo attributo facoltativo accetta un valore stringa . Il valore predefinito è una stringa vuota.

Valore Descrizione
Fatal Output di messaggi irreversibili.
Errore Messaggi di errore di output.
Avviso Messaggi di avviso di output, messaggi di errore e messaggi irreversibili.
Informazioni Messaggi di informazioni di output, messaggi di avviso, messaggi di errore e messaggi irreversibili.
Dettagliato Output di tutti i messaggi.
Dati Restituisce tutti i messaggi e i dati utente.
Debug Restituisce tutti i messaggi, i dati utente e i dati di debug.

Tabella 2. Livelli di listener di traccia del testo del file host.

<containers>
  <container name="HostFiles">
    <tracePoint name="MsHostFileClient">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Transport">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Aggregate Converter">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
    <tracePoint name="Primitive Converter">
      <traceLevel level="All">
      </traceLevel>
    </tracePoint>
  </container>
</containers>

Vedere anche

Integrazione dei dati (risoluzione dei problemi)