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.

Remarque :

Lorsque vous mettez hors connexion un service d’entités acceptant les synchronisations qui contient des données versionnées hors connexion dans ArcGIS Pro, un réplica de service d’entités est créé. Les informations des processus de création et de synchronisation des réplicas de service d'entités effectués dans ArcGIS Pro sont également écrites dans le journal d’activité de réplica.

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. Vous pouvez utiliser ces informations pour résoudre des erreurs ou examiner les performances de création et de synchronisation de réplicas.

Emplacement du journal d’activité de réplica

Le journal d’activité de réplica est le fichier ProReplicaActivityLog.dat, qui est stocké sur disque. Vous pouvez définir l'emplacement de stockage de ce fichier en mettant à jour le chemin d'accès au fichier journal dans la boîte de dialogue Logging Properties (Propriétés du journal).

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.

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

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. Modifiez le niveau de consignation dans la boîte de dialogue Logging Properties (Propriétés du journal) pour contrôler la quantité d'informations écrites dans le journal d'activité de réplica.

Définir les propriétés du journal d’activité de réplica

Vous pouvez choisir l'emplacement de stockage du fichier journal d’activité de réplica ArcGIS Pro (ProReplicaActivityLog.dat), ainsi que le niveau de détail enregistré dans le fichier.

1. Accédez aux propriétés de consignation de réplica à l'aide de l'une des méthodes suivantes :
   • Ouvrez la boîte de dialogue Options du projet ArcGIS Pro, puis cliquez sur l’onglet Geodatabase Replication (Réplication de géodatabase).

     

   • Ouvrez la fenêtre Manage Replicas (Gérer les réplicas), cliquez sur le menu Manage Replicas (Gérer les réplicas), puis cliquez sur Logging Properties (Propriétés du journal).

     

     

   Approfondissement :

   Les administrateurs système peuvent gérer les paramètres de l’application pour les utilisateurs d’une organisation. Ces paramètres peuvent être verrouillés et leur valeur par défaut peut être différente de celles de l’application. Pour en savoir plus, reportez-vous aux rubriques Gérer les paramètres de l’application et Paramètres de réplication de géodatabase.
2. Saisissez ou collez un chemin d'accès local ou le chemin d'accès à un répertoire de fichiers partagé dans le champ Log file path (Chemin d’accès au fichier journal) pour modifier l'emplacement de stockage du fichier journal d'activité de réplica.

   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.

3. Dans le menu déroulant Log level (Niveau de consignation), sélectionnez le niveau de détail à enregistrer dans le journal d’activité de réplica ArcGIS Pro.

   Les options de niveau de consignation stockent une quantité de détails de plus en plus importante : pas d'informations (None (Aucun)) à Debug (Déboguer).

   

   Info: Simple (Informations : simples) représente le niveau de consignation par défaut. Dans la plupart des cas, ce paramètre 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 sélectionner Info: Standard (Informations : standard) ou Info: Detailed (Informations : détaillées).

   À des fins 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é.

   Gardez à l'esprit que la taille du fichier journal d’activité de réplica augmente plus rapidement à des niveaux de consignation plus élevés qu'à des niveaux de consignation plus faibles.

Afficher le journal d’activité de réplica

Vous pouvez afficher le contenu du fichier journal d’activité de réplica (ProReplicaActivityLog.dat) dans un éditeur de texte.

Vous trouverez ci-après un exemple d’informations capturées dans le fichier journal d’activité de réplica ArcGIS Pro lors de la création d’un réplica monodirectionnel parent vers enfant. Dans cet exemple, le niveau de consignation est défini sur Debug (Déboguer).

Journal du réplica

Le journal du réplica est disponible uniquement pour les réplicas monodirectionnels et bidirectionnels. Il affiche les informations stockées dans la géodatabase relatives aux événements de synchronisation et contient des informations sur les éventuelles erreurs. 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.

Pour afficher le journal du réplica, ouvrez les propriétés du réplica pour un réplica monodirectionnel ou bidirectionnel et cliquez sur l'onglet Replica Log (Journal du réplica).

Utiliser le journal du réplica

Dans l’onglet Replica Log (Journal du réplica) de la boîte de dialogue Replica Properties (Propriétés du réplica), vous pouvez choisir le nombre de jours de consignation à afficher 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é (Sent Changes (Modifications envoyées)) ou reçu (Rec Changes (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 est affiché dans la colonne Results (Résultats), cliquez avec le bouton droit sur la ligne pour accéder au rapport d’erreurs.

Accéder à un rapport d’erreurs du journal du réplica

Si un conflit ou une erreur système est affiché dans la colonne Results (Résultats), cliquez avec le bouton droit sur la ligne, puis sélectionnez le bouton 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.

La boîte de dialogue 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.