Définition des traces
Lorsqu'un job est exécuté, un journal de suivi est généré, fournissant des informations sur chaque étape.
Le niveau de détails affichés dépend de certaines options qui peuvent être définies dans les propriétés du job ou de l'exécution.
Voici quelques-unes des options de traçage disponibles :
| Trace | Description |
|---|---|
| Ligne | Ecrit un message lorsqu'une transformation importe ou exporte une ligne |
| Workflow | Ecrit un message lorsque la description du workflow est lue à partir du référentiel, lorsque le workflow est optimisé, lorsque le workflow est exécuté et à la fin du workflow |
| Flux de données | Ecrit un message lorsque le flux de données démarre et lorsque le flux de données se termine correctement ou s'interrompt en raison d'une erreur |
| Transformation | Ecrit un message lorsqu'une transformation démarre et se termine |
| Lecteurs SQL | Ecrit le bloc de requête SQL qu'un script, une transformation Query ou une fonction SQL soumet au système et écrit les résultats SQL |
| Tables | Ecrit un message lorsqu'une table est créée ou supprimée |
| Scripts et fonctions de script | Ecrit un message lorsqu'un script est appelé, une fonction est appelée par un script et un script est correctement terminé. |
| Effectuer le suivi de l'exécution parallèle | Ecrit des messages décrivant comment les données d'un flux de données sont traitées en parallèle |
| Procédure stockée | Ecrit un message lorsqu'une procédure stockée démarre et se termine, et inclut des valeurs clés |
| Données d'audit | Ecrit un message qui collecte une statistique à un point d'audit et détermine si une règle d'audit réussit ou échoue |
Définition de traces dans les propriétés d'exécution du job
- Détermine quelles informations sont écrites dans le journal.
- Peut être exécuté temporairement (Propriétés d'exécution) ou de manière permanente (Propriétés de job)
- Peut générer des traces individuelles pour chaque ligne (par exemple, Ligne de suivi, SQL...)
Une fois le job lancé, vous pouvez sélectionner les icônes Trace, Moniteur et Erreur pour afficher les fichiers journaux créés lors de l'exécution du job.
Je vais vous montrer comment configurer les traces :
Examen des journaux de trace
Utilisez les journaux de suivi pour déterminer où une exécution a échoué, si les étapes d'exécution se produisent dans l'ordre que vous attendez et quelles parties de l'exécution prennent le plus de temps, comme illustré dans la figure suivante.
Examen du moniteur et des journaux des erreurs
Utilisez les journaux de suivi pour quantifier les activités des composants du job, comme illustré dans cette autre figure. Il répertorie le temps passé dans un composant donné d'un job et le nombre de lignes de données qui ont été transférées via le composant.
Utilisez les journaux des erreurs pour déterminer comment une exécution a échoué. Si l'exécution s'est terminée sans erreur, le journal des erreurs est vide.
Fichiers journaux
Lors de l'exécution d'un job, Data Services produit 2 ou 3 fichiers journaux (en cas d'erreurs), qui sont, par défaut, définis pour s'afficher automatiquement dans l'espace de travail. Mais vous pouvez également les afficher à partir des onglets Suivi et Journal de la zone de projet.
Utilisation de l'onglet Suivi
L'onglet Moniteur répertorie les journaux de suivi de toutes les exécutions actuelles ou les plus récentes d'un job.
Les icônes de statut dans l'onglet Moniteur peuvent être lues comme suit :
- Une icône verte indique que le job est en cours d'exécution.
Cliquez avec le bouton droit de la souris et sélectionnez Interrompre job pour arrêter un job toujours en cours d'exécution. Après avoir sélectionné Interrompre job, l'icône de job devient un triangle jaune avec un point d'exclamation au milieu.
- Une icône de statut rouge indique que le job s'est arrêté.
Cliquez avec le bouton droit de la souris et sélectionnez Propriétés pour ajouter une description à un journal de suivi spécifique. Cette description est sauvegardée avec le journal auquel vous pouvez accéder ultérieurement à partir de l'onglet Journal.
- Une croix rouge indique que le job a rencontré une erreur.
Utilisation de l'onglet Journal
Sélectionnez l'onglet Journal pour afficher l'historique du journal d'un job.
Pour trouver le fichier journal de votre job :
- Sélectionnez le job pour lequel vous voulez afficher les journaux.
- Dans l'espace de travail, dans la liste déroulante +, sélectionnez le type de journal que vous souhaitez afficher.
- Dans la liste des journaux, double-cliquez sur le journal pour afficher les détails.
- Pour copier le contenu d'un journal ouvert, sélectionnez une ou plusieurs lignes et utilisez la commande de touche [CTRL+C ].