Arbeiten mit Replikaktprotokollen

Wenn Sie die Geodatabase-Replikation in ArcGIS Pro 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. Sie können diese Informationen zur Fehlerbehebung oder zum Beheben von Problemen mit der Performance bei der Replikationserstellung und -synchronisierung verwenden.

Das Replikataktivitäts-Protokoll von ArcGIS Pro ist detaillierter als das Replikatprotokoll; in Ersterem werden alle Operationen und die damit verknüpften Informationen einzeln aufgelistet, z. B. aufgetretene Fehler. Zur Angabe des Speicherorts und der Detaillierungsebene des Replikataktivitäts-Protokolls müssen Sie, wie im nächsten Abschnitt beschrieben, die Protokollierungseigenschaften aufrufen.

Zugreifen auf Protokollierungseigenschaften für Replikate

Sie können zwischen mehreren Detaillierungsebenen für die Aufzeichnung wählen, und Sie können festlegen, wo das Replikataktivitäts-Protokoll von ArcGIS Pro auf dem Computer erstellt und aktualisiert werden soll. Die Protokollierungseigenschaften des Replikat lassen sich entweder über die Registerkarte Geodatabase-Replikation im Dialogfeld Optionen des ArcGIS Pro-Projekts oder über das Menü Replikate verwalten im Bereich Replikate verwalten aufrufen und einstellen. In den folgenden Abschnitten werden die beiden Zugriffsmethoden schrittweise erläutert:

Registerkarte "Geodatabase-Replikation"

Führen Sie die folgenden Schritte aus, um über die Registerkarte Geodatabase-Replikation auf die Protokollierungseigenschaften für Replikate zuzugreifen:

  1. Klicken Sie in ArcGIS Pro auf der Registerkarte Projekt auf Optionen.
  2. Wählen die Registerkarte Geodatabase-Replikation aus. Hier können Sie den standardmäßigen Pfad der Protokolldatei und die Protokollebene festlegen.
    Zugriff auf die Registerkarte "Geodatabase-Replikation" über das Dialogfeld "Optionen"

    Hinweis:

    Beim Einsatz von Offline-Workflows in ArcGIS Pro, z. B. bei der Offline-Verwendung einer Karte mit der Synchronisierungsfunktion in Feature-Services, wird auch in die Datei "ProReplicaActivityLog" geschrieben. In diesem Fall konfigurieren Sie auf der Registerkarte Geodatabase-Replikation in den Optionen des ArcGIS Pro-Projekts den Ort der Erstellung und Aktualisierung dieser Protokolldatei und der Detaillierungsebene. Weitere Informationen finden Sie unter Offline-Verwendung von Feature-Layern.

Menü "Replikate verwalten"

Führen Sie die folgenden Schritte aus, um über das Menü Replikate verwalten auf die Protokollierungseigenschaften für Replikate zuzugreifen:

  1. Klicken Sie im Bereich Katalog mit der rechten Maustaste auf eine vorhandene Verbindung mit einer Geodatabase, zeigen Sie auf Verteilte Geodatabase, und klicken Sie auf Replikate verwalten Replikat verwalten.
    Der Befehl "Replikate verwalten" im Kontextmenü "Verteilte Geodatabase".
  2. Klicken Sie auf das Menü Replikate verwalten Menü und dann auf Protokollierungseigenschaften.

    Befehle im Menü "Replikate verwalten"

Unter Kurzer Überblick über die Replikatverwaltung finden Sie weitere Informationen über die Werkzeuge im Bereich Replikate verwalten.

Festlegen der Protokollierungseigenschaften für Replikate

Sie können anhand der folgenden Werte im Dialogfeld Protokollierungseigenschaften festlegen, wo die Protokolldatei mit den Replikataktivitäten in ArcGIS Pro gespeichert werden soll:

Im Dialogfeld "Protokollierungseigenschaften" können Sie den Speicherort und die Protokollebene der Datei "ProReplicaActivityLog.dat" festlegen.

  • Pfad der Protokolldatei: Das Standardverzeichnis für die Replikataktivitäts-Protokolldatei von ArcGIS Pro ist C:\Users\<user_profile>\AppData\Local\ESRI\ProReplicaActivityLog.dat. Dieser Speicherort kann durch die Eingabe eines anderen Pfades, an dem die Replikataktivitäts-Protokolldatei gespeichert werden soll, geändert werden. Dies kann auch ein freigegebener Dateispeicherort sein.
  • Protokollebene: Wählen Sie die Detaillierungsebene aus, die im Replikataktivitäts-Protokoll von ArcGIS Pro aufgezeichnet werden soll. Info: Einfach ist die standardmäßige die Protokollebene. Er ist in den meisten Fällen ausreichend, um zu verstehen, was während der Replikaterstellung und -synchronisierung passiert ist. Wenn Sie weitere Informationen benötigen, können Sie eine andere Option für die Protokollebene auswählen. Zur Fehlerbehebung können Sie von Mitarbeitern des technischen Supports von Esri aufgefordert werden, die Protokollebene auf Debuggen festzulegen, damit die Replikataktivitäts-Protokolldatei von ArcGIS Pro analysiert werden kann.

Optionen für die Protokollebene im Dialogfeld "Protokollierungseigenschaften"

Überprüfen 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

Anzeigen der Protokolldatei mit den Replikataktivitäten in einem Texteditor

Sie können den Inhalt der Datei "ProReplicaActivityLog" direkt in einem Texteditor anzeigen.

Im Folgenden ist ein Beispiel für die Informationen dargestellt, die in der Replikataktivitäts-Protokolldatei von ArcGIS Pro mit der Protokollebene Debuggen aufgezeichnet werden, während ein unidirektionales Parent-zu-Child-Replikat erstellt wird.

Anzeigen der Datei "ProReplicaActivityLog" in einem Texteditor

Anzeigen der Protokolldatei mit den Replikataktivitäten in einer formatierten Ansicht

Optional können Sie den Replica Log Viewer verwenden, ein benutzerdefiniertes ArcGIS Pro-Add-in, um eine formatierte Ansicht des Replikataktivitäts-Protokolls anzuzeigen. Bei der Anzeige des Replikataktivitäts-Protokolls von ArcGIS Pro bietet der Replica Log Viewer die folgenden zusätzlichen Befehle:

  • Open Log: Navigieren Sie zum Speicherort der Replikataktivitäts-Protokolldatei von ArcGIS Pro.
  • Filter by replica name or date range: Filtern Sie nach Replikatnamen in der Protokolldatei oder nach Replikataktivität anhand eines Datumsbereichs.
  • Show Only Errors & Warnings: Zeigen Sie nur Fehler und Warnungen an, die in der Replikataktivitäts-Protokolldatei aufgezeichnet wurden.

Im Folgenden ist eine formatierte Ansicht der gleichen Replikataktivitäts-Protokolldatei von ArcGIS Pro dargestellt, die Informationen enthält, die beim Erstellen eines unidirektionalen Parent-zu-Child-Replikats mit der Protokollebene Debuggen aufgezeichnet wurden:

Formatierte Ansicht der Replikataktivitäts-Protokolldatei

Informationen zum Zugriff auf das benutzerdefinierte Add-in "Replica Log Viewer" und zur Installation und Anzeige einer formatierten Ansicht der Informationen im Replikataktivitäts-Protokoll von ArcGIS Pro finden Sie im technischen Artikel How To: Get a formatted view of the Replica Activity Log.

Replikatprotokoll

Auf der Registerkarte Replikatprotokoll im Dialogfeld Replikateigenschaften werden in der Geodatabase gespeicherte Informationen zu Synchronisierungsereignissen sowie ggf. Fehlerinformationen angezeigt. Sie enthält gesendete und empfangene Änderungen und, ähnlich wie das Replikataktivitäts-Protokoll, auch sämtliche Fehler.

Die Registerkarte "Replikatprotokoll" befindet sich im Dialogfeld "Replikateigenschaften".

Hinweis:

Die Registerkarte Replikatprotokoll steht nur bei uni- und bidirektionalen Replikaten zur Verfügung.

Anzeigen des Replikatprotokolls

Auf der Registerkarte Replikatprotokoll 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.

Filtern Sie die Ergebnisse im Replikatprotokoll nach Ergebnistyp.

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
  • Event: 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 "Results" ein Konflikt oder Systemfehler angezeigt wird, klicken Sie mit der rechten Maustaste auf die Zeile, um den Fehlerbericht zu öffnen.

Zugreifen auf den Fehlerbericht des Replikatprotokolls

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

Wenn Sie den Fehlerbericht auf Konflikte durchsuchen möchten, die bei der Synchronisierung des Replikats aufgetreten sind, rufen Sie im Dialogfeld "Replikateigenschaften" die Registerkarte "Replikatprotokoll" auf.

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.

Der Fehlerbericht enthält die Beschreibung und die Lösung für einen Konflikt.

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

Weitere Informationen

Weitere Informationen finden Sie in den folgenden Ressourcen: