Partager via

Traçage des clients de données

  • Article

Il existe plusieurs options de traçage qui permettent de capturer les problèmes liés au consommateur, aux composants de service, au fournisseur, au réseau et à la source de données hôte.

Traçage du consommateur SQL à l'aide de SQL Server Profiler

SQL Server Profiler est une interface utilisateur graphique de SQL Trace qui permet de surveiller une instance du moteur de base de données ou d'Analysis Services. Vous pouvez capturer et enregistrer des données sur chaque événement dans un fichier ou dans une table en vue d'une analyse ultérieure. Pour plus d’informations, consultez Présentation de SQL Server Profiler (https://go.microsoft.com/fwlink/?LinkID=180433).

Traçage du fournisseur de données à l’aide de l’utilitaire de trace du fournisseur

L’utilitaire de trace HIS capture et enregistre les informations de Microsoft DB2 and Informix concernant les connexions des clients réseau, les interfaces de fournisseurs et les messages de données. Pour plus d’informations, consultez les pages Aide sur l’utilitaire de trace et Utilitaire de trace SNA.

Traçage du réseau à l'aide du moniteur réseau

Le moniteur réseau capture le trafic réseau à des fins d'affichage et d'analyse. Il vous permet d'effectuer des tâches telles que l'analyse des données précédemment capturées dans des méthodes définies par l'utilisateur, en extrayant des données depuis des analyseurs de protocole définis. Il comprend un analyseur DDM (gestion des données distribuée) à utiliser avec les clients réseau de données HIS. Pour obtenir une copie de l'analyseur DDM, contactez le support technique de Microsoft. Pour plus d’informations, consultez Moniteur réseau (https://go.microsoft.com/fwlink/?LinkID=180448).

Traçage du serveur DB2 à l'aide d'outils IBM

Pour plus d'informations, consultez le guide d'administration d'IBM DB2 pour la plateforme et la version DB2 applicables.

Traçage de serveur Informix à l’aide des outils IBM

Pour plus d’informations, consultez le Guide d’administration d’IBM Informix pour la plateforme et la version Informix applicables.

Événements Windows Server à l'aide de l'observateur d'événements

L’observateur d’événements est un composant logiciel enfichable de la console MMC (Microsoft Management Console) qui vous permet de naviguer dans les journaux des événements et de les gérer. Pour plus d’informations, consultez observateur d'événements (https://go.microsoft.com/fwlink/?LinkID=131274).

Traçage du client de fichiers hôtes et du fournisseur de données

Le fournisseur de données ADO.NET pour Host Files (client de fichiers hôtes) prend en charge un écouteur de trace de texte Microsoft Host Integration, qui est configuré à l’aide d’un fichier config HIDT (Host Integration Tracing Definition) référencé dans l’élément de diagnostic système du fichier app.config relatif au consommateur de données.

Fichier App.Config du consommateur de données

Le fichier app.config du consommateur de données contient un élément de section de configuration pour Microsoft Host Integration Tracing ainsi qu’un élément d’écouteur de fichier texte Host Integration Server. Tous deux permettent de contrôler le traçage du client de fichiers hôtes. Dans cet exemple, le fichier MsHostFileClient.HITD (Host Integration Tracing Definition) doit se trouver dans le répertoire de programme du consommateur de données.

<?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>

Section de configuration

L’élément configSections contient la section de configuration ainsi que les déclarations d’espaces de noms du composant Microsoft Host Integration Tracing.

Nom de la section de configuration

L’attribut name de la section définit le nom du composant Microsoft Host Integration Tracing. Cet attribut obligatoire accepte une chaîne ayant la valeur Microsoft.hostintegration.tracing.

Type de la section de configuration

L’attribut type définit le type de l’écouteur de trace de texte pour Microsoft Host Integration Tracing. Cet attribut obligatoire accepte une chaîne ayant la valeur Microsoft.HostIntegration.Tracing.TraceSection, Microsoft.HostIntegration.Tracing.Configuration, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35.

Section de traçage de l’intégration de l’hôte

L’élément microsoft.hostintegration.tracing contient les informations de configuration relatives à l’écouteur de trace de texte du composant Microsoft Host Integration Tracing.

Fichier de définition de trace

L’attribut traceDefinitionFile définit le nom du fichier de sortie de l’écouteur de trace de texte pour Microsoft Host Integration Tracing. Cet attribut obligatoire accepte une chaîne dont la valeur représente un chemin de sortie de trace et un nom de fichier.

Notes

Chaque compte d’utilisateur doit disposer d’un accès en écriture au dossier de traces, pour pouvoir insérer des lignes dans le fichier de trace au format texte. Chaque compte d’utilisateur a besoin des paramètres de la liste de contrôle d’accès au dossier, qui sont associés au groupe local des utilisateurs du runtime HIS. Pour plus d’informations, consultez la section intitulée Sécurité et protection.

Diagnostic système

L’élément system.diagnostics contient la configuration supplémentaire relative à l’écouteur de trace de texte du composant Microsoft Host Integration Tracing.

Nom de l’écouteur de trace

L’attribut name définit le nom de l’écouteur de trace de texte pour le client de fichiers hôtes. Cet attribut obligatoire accepte une chaîne ayant la valeur HisTextFileListener.

Type de l’écouteur de trace

L’attribut type définit le type de l’écouteur de trace de texte pour le service DRDA. Cet attribut obligatoire accepte une chaîne ayant la valeur Microsoft.HostIntegration.Tracing.HisTextFileTraceListener, Microsoft.HostIntegration.Tracing.Runtime, Culture=neutral, Version=7.0.2300.0, PublicKeyToken=31bf3856ad364e35, processorArchitecture=MSIL.

Nombre maximal d’entrées de trace

L’attribut maxTraceEntries indique au client de fichiers hôtes de tracer un nombre maximal d’entrées, puis d’arrêter le traçage. Cet attribut facultatif accepte un entier. La valeur par défaut est 1000000.

Dossier du fichier de trace

L’attribut traceFileFolder indique à l’écouteur de trace de texte du client de fichiers hôtes où écrire le fichier de sortie de trace de l’écouteur de texte. Cet attribut facultatif accepte une valeur de type chaîne. La valeur par défaut est C:\Program Files\Microsoft Host Integration Server 2013\traces.

Notes

Chaque compte d’utilisateur doit disposer d’un accès en écriture au dossier de traces, pour pouvoir insérer des lignes dans le fichier de trace au format texte. Chaque compte d’utilisateur a besoin des paramètres de la liste de contrôle d’accès au dossier, qui sont associés au groupe local des utilisateurs du runtime HIS. Pour plus d’informations, consultez la section intitulée Sécurité et protection.

Vidage automatique

L’attribut autoFlush indique au service DRDA de vider automatiquement les données dans l’écouteur de trace. Cet attribut facultatif accepte une valeur de type booléen. La valeur par défaut est false.

Notes

L’écouteur de trace de texte du client de fichiers hôtes peut vider automatiquement les données de trace vers les écouteurs de trace, ce qui permet de garantir la capture des données de trace. Toutefois, cela entraîne une augmentation des E/S de disque et une réduction des performances globales du système. Pour améliorer les performances, définissez autoFlush=false afin de désactiver le vidage de trace automatique.

Nom du fichier de trace

L’attribut name définit le nom du fichier de sortie de trace de texte pour le client de fichiers hôtes. Cet attribut obligatoire accepte une chaîne.

Initialisation de l’écouteur de trace

L’attribut allowNonHisTracingToCreateFile définit si le traçage peut être lancé par un autre composant que le client de fichiers hôtes et Microsoft Host Integration Tracing. Cet attribut obligatoire accepte un booléen dont la valeur par défaut est false.

Fichier HITD (Host Integration Tracing Definition)

Le fichier config HIDT (Host Integration Tracing Definition) définit le niveau de trace pour l’écouteur de fichier texte Host Integration Server.

Conteneurs de trace

L’élément containers comprend des éléments conteneurs qui définissent les niveaux de trace pour chaque point de trace.

Nom du conteneur de trace

L’attribut name définit le nom du conteneur de trace. Cet attribut obligatoire accepte une chaîne ayant la valeur HostFiles.

Nom du point de trace

L’attribut name définit le nom du point source de trace. Cet attribut obligatoire accepte une chaîne. La valeur par défaut est une chaîne vide.

Valeur Description
HostFiles Fournisseur ADO.NET pour Host Files
Transport Client de fichiers hôtes pour DDM RLIO
Aggregate Converter Convertisseur d’agrégats pour encodeur Host Integration Server
Primitive Converter Convertisseur de primitives pour encodeur Host Integration Server

Tableau 1. Noms des points sources de trace des fichiers hôtes.

Niveau de suivi

L’attribut traceLevel indique au client de fichiers hôtes de tracer des collections d’informations définies, d’un niveau de traçage minimal à un niveau maximal. Cet attribut facultatif accepte une valeur de type chaîne. La valeur par défaut est une chaîne vide.

Valeur Description
Erreur irrécupérable Sortie des messages d’erreur irrécupérable.
Error Sortie des messages d’erreur.
Avertissement Sortie des messages d’avertissement, des messages d’erreur et des messages d’erreur irrécupérable.
Information Sortie des messages d’information, des messages d’avertissement, des messages d’erreur et des messages d’erreur irrécupérable.
Commentaires Sortie de tous les messages.
Données Sortie de tous les messages et des données utilisateur.
Débogage Sortie de tous les messages, des données utilisateur et des données de débogage.

Tableau 2. Niveaux d’écouteur de trace de texte de fichiers hôtes.

<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>

Voir aussi

Intégration de données (résolution des problèmes)