Arbeiten mit Replikaktprotokollen

Mit der Standard- oder Advanced-Lizenz verfügbar.

Wenn Sie die Geodatabase-Replikation in ArcGIS Pro (verbunden oder nicht verbunden) verwenden, werden zur Nachverfolgung von Informationen über die detaillierten Prozesse, die bei der Erstellung und Synchronisierung ablaufen, folgende Protokolltypen verwendet:

• Replikataktivitäts-Protokoll
  • Protokollierung der Erstellung oder Löschung eines Replikats.
  • Protokollierung detaillierter Informationen zum Synchronisierungsprozess zwischen Replikaten.
  • Sie können die aufgezeichneten Informationen zur Fehlerbehebung oder zum Beheben von Problemen mit der Performance bei der Replikationserstellung und -synchronisierung verwenden.
• Replikatprotokoll
  • Protokollierung von Ereignissen, die bei der Replikatsynchronisierung eintreten, z. B. Senden und Empfangen von Änderungen.
  • Wenn bei der Replikatsynchronisierung ein Fehler oder Konflikt auftritt, wird eine Fehlerbeschreibung und eine Lösung bereitgestellt.

Weitere Informationen über diese Protokolltypen finden Sie unter Replikataktivitäts-Protokoll und Replikatprotokoll weiter unten.

Replikataktivitäts-Protokoll

Wenn eine Replikaterstellung oder -synchronisierung in ArcGIS durchgeführt wird, werden im Replikataktivitäts-Protokoll von ArcGIS Pro ausführliche Informationen zum Vorgang aufgezeichnet.

Hinweis:

Wenn Sie einen Feature-Service mit aktivierter Synchronisierung, der versionierte Daten enthält, in ArcGIS Pro offline nehmen, wird ein Feature-Service-Replikat erstellt. Informationen zur Erstellung von Feature-Service-Replikaten und zu den in ArcGIS Pro ausgeführten Synchronisierungsprozessen werden außerdem in das Replikataktivitäts-Protokoll geschrieben.

Das Replikataktivitäts-Protokoll von ArcGIS Pro ist detaillierter als das Replikatprotokoll; in Ersterem werden alle ausgeführten Operationen und die damit verknüpften Informationen einzeln aufgelistet, z. B. aufgetretene Fehler. Sie können diese Informationen zur Fehlerbehebung oder zum Beheben von Problemen mit der Performance bei der Replikationserstellung und -synchronisierung verwenden.

Speicherort des Replikataktivitäts-Protokolls

Das Replikataktivitäts-Protokoll befindet sich in der Datei ProReplicaActivityLog.dat, die auf der Festplatte gespeichert wird. Den Speicherort dieser Datei können Sie durch Bearbeiten des Protokolldateipfades im Dialogfeld Protokollierungseigenschaften definieren.

An einem einzelnen Replikatprozess können mehrere Computer beteiligt sein. Die Prozessinformationen sind daher unter Umständen auf die Replikataktivitäts-Protokolle auf mehreren Computern verteilt. In einer nicht verbundenen Umgebung werden Änderungen beispielsweise synchronisiert, indem sie von einem Datenabsender exportiert und anschließend in einen Datenempfänger importiert werden. In diesem Fall werden Informationen zu den Exportänderungen auf dem Computer protokolliert, auf dem der Exportvorgang stattgefunden hat, während die Importänderungen auf dem Computer protokolliert werden, auf dem der Importvorgang durchgeführt wurde.

Inhalt des Replikataktivitäts-Protokolls

Im Replikataktivitäts-Protokoll von ArcGIS Pro werden u. a. die folgenden Informationen gespeichert:

• Fehler: Wie viele Fehler während einer Prozessausführung aufgetreten sind
• Warnungen: Wie viele Warnungen während einer Prozessausführung aufgetreten sind
• Vorgangsname: Der Name des ausgeführten Prozesses
• Abschlusszeit: Datum und Uhrzeit des Prozessabschlusses
• Vorgangsinfo: Allgemeine Informationen über den Prozess

Das Replikataktivitäts-Protokoll wird mit zunehmender Menge an Informationen aus jeder neuen Replikaterstellung, die der Datei hinzugefügt werden, immer größer. Durch Ändern der Protokollierungsebene im Dialogfeld Protokollierungseigenschaften können Sie steuern, wie viele Informationen in das Replikataktivitäts-Protokoll geschrieben werden.

Festlegen der Eigenschaften für das Replikataktivitäts-Protokoll

Sie können den Speicherort und die Detaillierungsebene für die Aufzeichnungen in der Replikataktivitäts-Protokolldatei von ArcGIS Pro (ProReplicaActivityLog.dat) auswählen.

1. Greifen Sie mit einer der folgenden Methoden auf die Protokollierungseigenschaften für Replikate zu:
   • Öffnen Sie das Dialogfeld Optionen für ArcGIS Pro-Projekte, und klicken Sie auf die Registerkarte Geodatabase-Replikation.

     

   • Öffnen Sie den Bereich Replikate verwalten, klicken Sie auf das Menü Replikate verwalten , und klicken Sie auf Protokollierungseigenschaften.

     

     

2. Geben oder fügen Sie einen lokalen Pfad oder den Pfad eines freigegebenen Dateiverzeichnisses in das Feld Pfad der Protokolldatei ein, um den Speicherort der Replikataktivitäts-Protokolldatei zu ändern.

   Das Standardverzeichnis für die Replikataktivitäts-Protokolldatei von ArcGIS Pro ist C:\Users\<user_profile>\AppData\Local\ESRI\ProReplicaActivityLog.dat.

3. Wählen Sie im Dropdown-Menü Protokollierungsebene die Detaillierungsebene für die Aufzeichnungen im Replikataktivitäts-Protokoll von ArcGIS Pro aus.

   Die Optionen für die Protokollierungsebene bieten ansteigende Speicherungsstufen von Keine bis Debuggen.

   

   Info: Einfach ist die standardmäßige Protokollierungsebene. Diese Einstellung ist in den meisten Fällen ausreichend, wenn Sie verstehen möchten, was beim Replikaterstellungs- oder Synchronisierungsprozess geschieht. Wenn Sie weitere Informationen benötigen, können Sie Info: Standard oder Info: Detailliert auswählen.

   Zur Fehlerbehebung können Sie von Mitarbeitern des technischen Supports von Esri aufgefordert werden, die Protokollierungsebene auf Debuggen festzulegen, damit die Replikataktivitäts-Protokolldatei von ArcGIS Pro analysiert werden kann.

   Berücksichtigen Sie, dass die Größe der Replikataktivitäts-Protokolldatei bei höheren Protokollierungsebenen schneller zunimmt als bei niedrigeren Protokollierungsebenen.

Überprüfen des Replikataktivitäts-Protokolls

Sie können den Inhalt der Replikataktivitäts-Protokolldatei (ProReplicaActivityLog.dat) in einem Texteditor anzeigen.

Im folgenden Beispiel werden die Informationen dargestellt, die in der Replikataktivitäts-Protokolldatei von ArcGIS Pro aufgezeichnet werden, während ein unidirektionales Parent-zu-Child-Replikat erstellt wird. Die Protokollierungsebene ist in diesem Beispiel auf Debuggen festgelegt.

Replikatprotokoll

Das Replikatprotokoll steht nur bei uni- und bidirektionalen Replikaten zur Verfügung. Hier werden für Synchronisierungsereignisse in der Geodatabase gespeicherte Informationen angezeigt. Bei Fehlern sind außerdem Fehlerinformationen enthalten. Sie enthält gesendete und empfangene Änderungen und, ähnlich wie das Replikataktivitäts-Protokoll, auch sämtliche Fehler.

Zum Anzeigen des Replikatprotokolls öffnen Sie die Replikateigenschaften für ein uni- oder bidirektionales Replikat, und klicken Sie auf die Registerkarte Replikatprotokoll.

Verwenden des Replikatprotokolls

Auf der Registerkarte Replikatprotokoll im Dialogfeld Replikateigenschaften können Sie auswählen, wie viele Tage das Protokoll abdecken soll. Alternativ können Sie auch alle Protokolle eines bestimmten Replikats anzeigen, indem Sie die Option Alle Meldungen anzeigen aktivieren. Wenn das Kontrollkästchen Alle Meldungen anzeigen aktiviert ist, ist das Textfeld Meldungen seit auflisten nicht verfügbar.

Darüber hinaus können Sie die Ergebnisse, die auf der Registerkarte Replikatprotokoll angezeigt werden, nach Ergebnistyp filtern.

Im Replikatprotokoll werden für jede Meldung die Elemente Log Date, Event und Results aufgeführt.

• Log Date: Datum und Uhrzeit des Versands oder Empfangs der Meldungen
• Ereignis: Zeigt an, ob die Meldung von diesem Replikat gesendet (Gesendete Änderungen) oder empfangen (Empfangene Änderungen) wurde.
• Results: Zeigt an, ob die Meldung erfolgreich gesendet oder empfangen wurde oder ob bei dem Versuch, das Ereignis auszuführen, ein Konflikt oder Fehler mit dem Replikat aufgetreten ist

Wenn in der Spalte Ergebnisse ein Konflikt oder Systemfehler angezeigt wird, klicken Sie mit der rechten Maustaste auf die Zeile, um den Fehlerbericht zu öffnen.

Zugreifen auf den Fehlerbericht eines Replikatprotokolls

Wenn in der Spalte Ergebnisse ein Konflikt oder Systemfehler angezeigt wird, klicken Sie mit der rechten Maustaste auf die Zeile, und klicken Sie dann auf die Schaltfläche Fehlerbericht.

Dem Fehlerbericht für Konflikte können Sie den Grund eines Konflikts und gegebenenfalls die Lösung zu Beseitigung des Konfliktzustands für das Replikat entnehmen.

Das Dialogfeld Fehlerbericht enthält zudem Informationen über die mit dem Replikat verknüpften Generationsnummern. Die Anfangs- und Endgenerationsnummer geben den Bereich von Änderungen an, die an das empfangende Replikat gesendet wurden, und die Zielgeneration die Generationsnummer im Zielreplikat, in dem die Änderungen eingegangen wären.