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:
- Klicken Sie in ArcGIS Pro auf der Registerkarte Projekt auf Optionen.
- Wählen die Registerkarte Geodatabase-Replikation aus. Hier können Sie den standardmäßigen Pfad der Protokolldatei und die Protokollebene festlegen.
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:
- 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 .
- Klicken Sie auf das Menü Replikate verwalten und dann auf Protokollierungseigenschaften.
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:
- 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.
Ü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 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:
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.
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.
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.
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 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: