Utiliser les journaux de réplica

Disponible avec une licence Standard ou Advanced.

Lorsque vous utilisez la réplication de géodatabase dans ArcGIS Pro, les types de journaux suivants sont utilisés pour assurer le suivi des informations concernant les traitements détaillés qui ont lieu lors de la création et de la synchronisation des réplicas :

• Journal d’activité de réplica
  • Enregistre le moment de la création ou de la suppression d’un réplica.
  • Enregistre des informations détaillées concernant la synchronisation entre les réplicas.
  • Vous pouvez utiliser ces informations pour résoudre des erreurs ou des problèmes performances lors de la création et la synchronisation de réplicas.
• Journal du réplica
  • Enregistre les événements de synchronisation de réplicas, par exemple, les envois et les réceptions de modifications.
  • Si une erreur ou un conflit se produit lors de la synchronisation de réplicas, une description de l’erreur et une solution sont fournies.

Pour en savoir plus sur ces types de journaux, reportez-vous aux sections Journal d’activité de réplica et Journal du réplica ci-dessous.

Journal d’activité de réplica

Lorsqu’un processus de création ou de synchronisation de réplicas est exécuté dans ArcGIS, des informations détaillées sur le processus sont enregistrées dans le journal d’activité de réplica ArcGIS Pro.

Un processus de réplica peut concerner plusieurs ordinateurs. Aussi, les informations relatives au processus peuvent-elles être divisées entre les journaux d’activité de deux ordinateurs ou davantage. Par exemple, dans un environnement déconnecté, la synchronisation des mouvements s'effectue en les exportant à partir d'un expéditeur de données, puis en les important dans un destinataire de données. Dans ce cas, les informations relatives aux mouvements d'exportation sont consignées sur l'ordinateur sur lequel le processus d'exportation a été effectué, tandis que les informations relatives aux mouvements d'importation sont stockées sur l'ordinateur où le processus d'exportation a eu lieu. Au fil du temps, les informations de chaque nouveau processus de réplica sont ajoutées au fichier journal d'activité de réplica, qui grossit. Vous pouvez utiliser ces informations pour résoudre des erreurs ou examiner les performances de création et de synchronisation de réplicas.

Le journal d’activité de réplica dans ArcGIS Pro est plus détaillé que le journal du réplica et mentionne chaque opération exécutée, ainsi que les informations correspondantes comme les éventuelles erreurs survenues. Pour contrôler l’emplacement et le niveau de détail enregistré dans le journal d’activité de réplica, vous devez accéder aux propriétés de consignation, qui sont décrites dans la section suivante.

Accéder aux propriétés de consignation de réplica

Vous pouvez choisir différents niveaux de détail pour votre enregistrement et décider de la destination pour la création et la mise à jour du journal d’activité de réplica ArcGIS Pro sur votre machine. Vous pouvez accéder au paramètre Logging Properties (Propriétés de consignation) du réplica et le définir à partir de l’onglet Geodatabase Replication (Réplication de géodatabase) de la boîte de dialogue Options du projet ArcGIS Pro ou à partir du menu Manage Replicas (Gérer les réplicas) situé dans la fenêtre Manage Replicas (Gérer les réplicas). Les sections suivantes indiquent la procédure pour chaque méthode d’accès :

Onglet Geodatabase Replication (Réplication de géodatabase)

Suivez la procédure ci-après pour accéder aux propriétés de consignation de réplica et les définir à partir de l’onglet Geodatabase Replication (Réplication de géodatabase) :

1. Dans ArcGIS Pro, accédez à l’onglet Project (Projet) et sélectionnez Options.
2. Sélectionnez l’onglet Geodatabase Replication (Réplication de géodatabase). Cet onglet permet de définir les paramètres log file path (Chemin d’accès du fichier journal) et log level (Niveau de consignation).

   

   Remarque :

   Si vous faites appel aux processus hors connexion dans ArcGIS Pro, comme l’utilisation hors connexion d’une carte avec la fonctionnalité de synchronisation avec les services d’entités, vous pouvez également écrire dans le fichier journal ProReplicaActivityLog. Dans ce cas, utilisez l’onglet Geodatabase Replication (Réplication de géodatabase) de la boîte de dialogue Options du projet ArcGIS Pro pour configurer l’endroit où créer et mettre à jour ce fichier journal, ainsi que le niveau de détail à enregistrer. Pour plus d’informations, reportez-vous à la rubrique Utiliser les couches d’entités en mode hors connexion.

Menu Manage Replicas (Gérer les réplicas)

Suivez la procédure ci-après pour accéder aux propriétés de consignation de réplica et les définir à partir du menu Manage Replicas (Gérer les réplicas) :

1. Dans la fenêtre Catalog (Catalogue), cliquez avec le bouton droit sur une connexion à une géodatabase existante, pointez sur Distributed Geodatabase (Géodatabase distribuée), puis cliquez sur Manage Replicas (Gérer les réplicas) .

   

2. Cliquez sur le menu Manage Replicas (Gérer les réplicas) et sélectionnez Logging Properties (Propriétés de consignation).

   

Reportez-vous à la rubrique Présentation rapide de la gestion des réplicas pour plus d’informations sur les outils disponibles dans la fenêtre Manage Replicas (Gérer les réplicas).

Définir les propriétés de consignation de réplica

Vous pouvez choisir où stocker le fichier journal d’activité de réplica ArcGIS Pro ainsi que le niveau de détail enregistré en définissant les valeurs suivantes dans la boîte de dialogue Logging Properties (Propriétés de consignation) :

• Log file path (Chemin d’accès au fichier journal) : l’emplacement par défaut du fichier journal d’activité de réplica ArcGIS Pro est C:\Users\<user_profile>\AppData\Local\ESRI\ProReplicaActivityLog.dat. Vous pouvez modifier cet emplacement en entrant le chemin d’accès à l’emplacement dans lequel vous souhaitez enregistrer le fichier journal d’activité de réplica, qui peut également correspondre à un emplacement de fichier partagé.
• Log level (Niveau de consignation) : sélectionnez le niveau de détail souhaité pour l’enregistrement dans le journal d’activité de réplica ArcGIS Pro. Info: Simple (Infor : simple) est le niveau de consignation par défaut. Dans la plupart des cas, il suffit à comprendre ce qu’il se passe au cours du processus de création ou de synchronisation de réplicas. Si vous avez besoin d’informations supplémentaires, vous pouvez choisir un autre niveau de consignation. En cas de résolution de problèmes, l’équipe de support technique Esri peut vous demander de définir le niveau de consignation sur Debug (Déboguer) afin que le fichier journal d’activité de réplica ArcGIS Pro puisse être analysé.

Afficher le journal d’activité de réplica

Les informations stockées dans le journal d’activité de réplica ArcGIS Pro sont les suivantes :

• Errors (Erreurs) : nombre d’erreurs qui se sont produites lors de l’exécution d’un traitement
• Warnings (Avertissements) : nombre d’avertissements survenus lors de l’exécution d’un traitement
• Operation name (Nom de l’opération) : nom du traitement exécuté
• Time completed (Heure de fin) : date et heure de fin du traitement
• Operation info (Informations sur l’opération) : informations générales sur le processus

Afficher le fichier journal d’activité de réplica dans un éditeur de texte

Vous pouvez consulter le contenu du fichier ProReplicaActivityLog dans un éditeur de texte.

Voici un exemple d’informations capturées dans le fichier journal d’activité de réplica ArcGIS Pro selon le niveau de consignation Debug (Déboguer), lors de la création d’un réplica monodirectionnel parent vers enfant.

Afficher le fichier journal d’activité de réplica dans une vue mise en forme

Vous pouvez également utiliser Replica Log Viewer (Visionneuse des journaux de réplica), un complément personnalisé ArcGIS Pro, pour afficher une vue mise en forme du journal d’activité de réplica. Lorsque vous consultez le journal d’activité de réplica ArcGIS Pro, les commandes supplémentaires suivantes sont disponibles dans la visionneuse des journaux de réplica présente :

• Open Log (Ouvrir le journal) : permet d’accéder à l’emplacement du fichier journal d’activité de réplica ArcGIS Pro.
• Filter by replica name or date range (Filtrer par nom de réplica ou plage de dates) : filtrez en fonction des noms de réplica trouvés dans le fichier journal ou par activité de réplica selon une plage de dates.
• Show Only Errors & Warnings (Afficher uniquement les erreurs et les avertissements) : permet d’afficher uniquement les erreurs et avertissements capturés dans le fichier journal d’activité de réplica.

Voici une vue mise en forme du même fichier journal d’activité de réplica ArcGIS Pro qui présente les informations capturées lors de la création d’un réplica monodirectionnel parent vers enfant avec le niveau de consignation Debug (Déboguer) :

Pour accéder au complément personnalisé Replica Log Viewer (Visionneuse des journaux de réplica) et obtenir une vue mise en forme des informations contenues dans le journal d’activité de réplica ArcGIS Pro, consultez l’article technique How To: Get a formatted view of the Replica Activity Log.

Journal du réplica

L’onglet Replica Log (Journal du réplica) de la boîte de dialogue Replica Properties (Propriétés du réplica) affiche des informations stockées dans la géodatabase relatives aux événements de synchronisation et contient des informations sur les erreurs éventuelles. Il indique dans les modifications ont été envoyées et reçues et, comme le journal d’activité de réplica, les éventuelles erreurs survenues.

Remarque :

L’onglet Replica Log (Journal du réplica) est disponible uniquement pour les réplicas monodirectionnels et bidirectionnels.

Afficher le journal du réplica

Sur l’onglet Replica Log (Journal du réplica), vous pouvez choisir le nombre de jours de consignation que vous voulez voir ou afficher tous les journaux d’un réplica en particulier en cochant l’option Show All Messages (Afficher tous les messages). Si la case Show All Messages (Afficher tous les messages) est cochée, la zone de texte List messages since (Afficher les messages depuis) n’est pas disponible.

Vous pouvez en outre filtrer les résultats affichés dans l’onglet Replica Log (Journal du réplica) par type de résultat.

Le journal du réplica afficher les éléments Log Date (Date du journal), Event (Événement) et Results (Résultats) pour chaque message.

• Log Date (Date du journal) : date et heure d’envoi et de réception des messages
• Event (Événement) : indique si le message a été envoyé (modifications envoyés) ou reçu (modifications reçues) par ce réplica.
• Results (Résultats) : indique si le message a été envoyé ou reçu avec succès ou si un conflit de réplica est survenu lors de la tentative d’événement.

Si un conflit ou une erreur système s’affiche dans la colonne Results (Résultats), cliquez avec le bouton droit sur la ligne pour accéder au rapport d’erreurs.

Accéder au rapport d’erreurs du journal du réplica

Si un conflit ou une erreur système s’affiche dans la colonne Results (Résultats), cliquez avec le bouton droit sur la ligne pour accéder à Error Report (Rapport d’erreurs).

Le rapport d’erreurs des conflits explique pourquoi le conflit existe et, le cas échéant, indique une solution permettant de le résoudre.

Le rapport Error Report (Rapport d’erreurs) contient également des informations sur les numéros de génération associés au réplica. Les numéros de génération de début et de fin précisent la plage des mises à jour envoyées au réplica destinataire et la génération cible indique le numéro de génération sur le réplica cible ayant reçu les mises à jour.

Informations supplémentaires

Pour plus d’informations, consultez les ressources suivantes :

• Présentation rapide de la gestion des réplicas
• Présentation rapide de la synchronisation de réplicas
• Réplication et compatibilité des géodatabases
• Préparer les données à répliquer