Arbeiten mit Organisationsprotokollen

Die Überwachung von Protokollen kann zum Ermitteln von Fehlern und Beheben von Problemen im Zusammenhang mit Ihrer Organisation hilfreich sein. Verwenden Sie das ArcGIS-Portal-Administratorverzeichnis, um Organisationsprotokolle anzuzeigen, abzufragen, zu konfigurieren und zu löschen. Mit dem Portal-Administratorverzeichnis werden die Protokollmeldungen zu einer Tabelle zusammengefasst, die Sie lesen und bearbeiten können.

Auf Ereignisse, die für alle Komponenten in einer Organisation protokolliert werden, kann über das Portal-Administratorverzeichnis zugegriffen werden. Wenn Sie Serverprotokollierungseinstellungen festlegen, Serverprotokolle löschen und alle Filteroptionen verwenden möchten, müssen Sie möglicherweise dennoch ArcGIS Server Manager verwenden.

In den Abschnitten in diesem Thema werden die Protokolle und deren Verwendung bei der Behebung von Problemen beschrieben.

• Erfassen, Abfragen und Anzeigen von Ereignissen
• Verwenden von Ereignisfiltern in einer Abfrage zum Eingrenzen der Suche
• Löschen der Protokolle

Erfassen, Abfragen und Anzeigen von Ereignissen

Wenn in der Organisation ein Ereignis auftritt, wird es erfasst und in den Protokollen aufgezeichnet. Fragen Sie die Protokolle ab, um Meldungen anzuzeigen, die mit dem Ereignis verknüpft sind. Um die aktuellen Meldungen abzufragen und anzuzeigen, führen Sie die folgenden Schritte aus:

1. Öffnen Sie das Portal-Administratorverzeichnis, und melden Sie sich als Administrator an. Die URL ist normalerweise unter https://webadaptorhost.example.com/webadaptorname/portaladmin verfügbar.
2. Klicken Sie auf Logs > Query.
3. Behalten Sie alle Standardeinstellungen bei, und klicken Sie auf Query.

Einige Meldungen werden mit zusätzlichen Informationen zurückgegeben. Wenn ein Benutzer beispielsweise das falsche Kennwort zu häufig eingibt, werden die folgenden Meldungen angezeigt, und sein Konto wird gesperrt:

Im Szenario oben hat der Benutzer john_cho versucht, sich anzumelden, jedoch das falsche Kennwort eingegeben. Nach fünf Versuchen wurde entsprechend der Richtlinie für die Benutzerkonten das Konto des Benutzers gesperrt. Dies kann auch ein Hinweis darauf sein, dass ein böswilliger Benutzer versucht, auf die Organisation zuzugreifen.

Die obigen Informationen werden von allen Ereignissen erfasst, darunter der Protokollebenen-Typ, der Zeitpunkt, an dem das Ereignis aufgetreten ist, die Quellkomponente, von der es protokolliert wurde, der Computer, auf dem das Ereignis aufgetreten ist, der Benutzer, der mit dem Ereignis verknüpft ist, der Protokollcode, die Prozess-ID und die Anforderungs-ID. All diese Informationen können zu einer effektiveren Problembehebung in einer Organisation beitragen. Eine detaillierte Erläuterung dieser Informationen finden Sie unter Protokolle.

Wenn das System nicht ordnungsgemäß funktioniert

Wenn Sie feststellen, dass in der Organisation ein Problem vorliegt oder ein Benutzer ein Problem meldet, reproduzieren Sie das Ereignis, erfassen Sie das Ereignis anhand der Protokolle, fragen Sie die Protokolle nach Informationen zu dem Ereignis ab, und lösen Sie anschließend das durch das Ereignis verursachte Problem anhand der Informationen im Protokoll.

Wenn ein Problem vermutet oder gemeldet wird, ziehen Sie die folgende Entscheidungsstruktur heran, um das Ereignis anhand der Protokolle zu erfassen:

• Versuchen Sie, das Problem zu reproduzieren:
  • Wenn das Problem reproduziert werden kann, fragen Sie die Protokolle ab, und überprüfen Sie die Meldungen auf Informationen zu dem Problem:
    1. Wenn keine Informationen vorhanden sind, können Sie die Protokollierungsebene erhöhen. Reproduzieren Sie das Problem erneut, fragen Sie die Protokolle ab, und überprüfen Sie die Meldungen.
    2. Wenn die Protokollmeldungen entsprechende Informationen enthalten, überprüfen Sie die Informationen, um das Problem zu lösen.
  • Falls das Problem nicht reproduziert werden kann, notieren Sie sich das Szenario, das zu dem Problem geführt hat, für den Fall, dass es erneut auftritt.

Tipp:

Wenn Sie vermuten, dass das Problem mehrere Komponenten betrifft, sollten Sie bei der Abfrage von Protokollen Ihre Verbundserver auswählen. Die Serverprotokolle und die ArcGIS Data Store-Protokolle liefern möglicherweise zusätzliche Informationen, die bei der Problembehebung helfen.

Nachfolgend finden Sie Beispiele für die Erfassung und Abfrage von Ereignissen sowie deren Identifizierung anhand der Protokolle.

• Benutzer kann keine Anlage zu einem Feature-Service hinzufügen
• Benutzer gibt einen ungültigen Benutzernamen bzw. ein ungültiges Kennwort an
• Element wird von einem Ordner in einen anderen verschoben
• Organisation wird als schreibgeschützt festgelegt

Benutzer kann keine Anlage zu einem Feature-Service hinzufügen

Ein Benutzer meldet beispielsweise, dass er einem Feature-Service keine Anlage hinzufügen kann. Der Benutzer hat mehrmals vergeblich versucht, die Datei hochzuladen. Um diesen Ereignistyp zu erfassen, muss die Protokollierungsebene für das Portal zunächst auf INFO festgelegt werden.

Wenn das Portal Meldungen der Ebene INFO protokolliert, führen Sie die folgenden Schritte aus:

1. Bitten Sie den Benutzer, das Problem zu reproduzieren sowie die Schritte und die Zeit zu erfassen, die die Reproduktion des Problems in Anspruch genommen hat.
2. Öffnen Sie das Portal-Administratorverzeichnis, und melden Sie sich als Administrator an. Die URL ist normalerweise unter https://webadaptorhost.example.com/webadaptorname/portaladmin verfügbar.
3. Klicken Sie auf Logs > Query.
   1. Geben Sie die vom Benutzer abgerufenen Zeitwerte an. Das Format lautet yyyy-mm-ddThh:mm:ss. Die Startzeit ist beispielsweise 2015-05-10T14:05:00 und die Endzeit 2015-05-10T14:03:00.
   2. Legen Sie die Abfrage so fest, dass Meldungen auf der Protokollebene INFO zurückgegeben werden.
   3. Geben Sie im Feld Users den Benutzernamen des Mitglieds ein. Beispielsweise jcho für John Cho.
   4. Klicken Sie auf Query.
4. Überprüfen Sie das Feld Message auf Meldungen, die sich auf das Problem beziehen.

Folgende Meldung wird angezeigt:

Failed to add attachment. File size limit of 20 MB exceeded for feature service '/gis/rest/services/Hosted/parks3k_19/FeatureServer/0/1/addAttachment'.

Sie verstehen nun, dass der Benutzer versucht hat, eine Datei hochzuladen, die die maximal zulässige Dateigröße überschritten hat. Weisen Sie den Benutzer an, die Dateigröße auf weniger als 20 MB zu reduzieren.

Benutzer gibt einen ungültigen Benutzernamen bzw. ein ungültiges Kennwort an

Um diesen Ereignistyp zu erfassen, muss die Protokollierungsebene für das Portal zunächst auf WARNING oder eine niedrigere Ebene festgelegt werden.

Wenn das Portal Meldungen der Ebene WARNING protokolliert, führen Sie die folgenden Schritte aus:

1. Öffnen Sie das Portal-Administratorverzeichnis, und melden Sie sich als Administrator an. Die URL ist normalerweise unter https://webadaptorhost.example.com/webadaptorname/portaladmin verfügbar.
2. Klicken Sie auf Logs > Query.
3. Überprüfen Sie, ob die Protokollierungsebene auf WARNING festgelegt ist. Ignorieren Sie alle Felder, da hierbei Meldungen auf der Warnebene für alle Benutzer zurückgegeben werden.
4. Überprüfen Sie das Feld Message auf Meldungen, die sich auf das Problem beziehen.

Folgende Meldung wird angezeigt:

Sign in error: Invalid username or password specified for 'asmith'.

Diese Meldung gibt an, dass der Benutzer asmith (Ashley Smith) bei dem Versuch, sich bei der Organisation anzumelden, einen ungültigen Benutzernamen bzw. ein ungültiges Kennwort eingegeben hat. Überwachen Sie diese Ereignisse, um unberechtigte Zugriffsversuche zu verhindern.

Element wird von einem Ordner in einen anderen verschoben

Um diesen Ereignistyp zu erfassen, muss die Protokollierungsebene für das Portal zunächst auf INFO festgelegt werden.

Wenn das Portal Meldungen der Ebene INFO protokolliert, führen Sie die folgenden Schritte aus:

1. Öffnen Sie das Portal-Administratorverzeichnis, und melden Sie sich als Administrator an. Die URL ist normalerweise unter https://webadaptorhost.example.com/webadaptorname/portaladmin verfügbar.
2. Klicken Sie auf Logs > Query.
3. Überprüfen Sie, ob die Protokollierungsebene auf INFO festgelegt ist. Ignorieren Sie alle Felder, da hierbei Meldungen auf Info-Ebene für alle Benutzer zurückgegeben werden, nachdem die Ebene festgelegt wurde.
4. Klicken Sie auf Query.
5. Überprüfen Sie das Feld Message auf Meldungen, die sich auf das Problem beziehen.

Folgende Meldung wird angezeigt:

Item moved from folder 'jcho/(Home)' to folder 'jcho/(Home)/Utilities'. Item ID is 'b7557bd2691b4e74bc4ce3e373402cc6'.

Diese Meldung besagt, dass der Benutzer jcho (John Cho) ein Element (mit der ID b7557bd2691b4e74bc4ce3e373402cc6) aus seinem Home-Ordner (Home) in ein Unterverzeichnis in diesem Ordner namens Utilities verschoben hat.

Organisation wird als schreibgeschützt festgelegt

Um komponentenübergreifend zu erfassen, was geschieht, wenn Sie die Organisation in den schreibgeschützten Modus versetzen, muss die Protokollierungsebene für die Komponenten zunächst auf INFO oder eine niedrigere Ebene festgelegt werden. Weitere Informationen finden Sie unter Festlegen von Portal-Protokolleinstellungen und Angeben von Serverprotokollierungseinstellungen.

Wenn für die Komponenten Meldungen der Ebene INFO oder niedriger protokolliert werden und die Organisation als schreibgeschützt festgelegt ist, führen Sie die folgenden Schritte aus:

1. Öffnen Sie das Portal-Administratorverzeichnis, und melden Sie sich als Administrator an. Die URL ist normalerweise unter https://webadaptorhost.example.com/webadaptorname/portaladmin verfügbar.
2. Klicken Sie auf Logs > Query.
3. Überprüfen Sie, ob die Protokollierungsebene auf INFO festgelegt ist, und klicken Sie auf Query.
4. Suchen Sie die Protokollmeldung, die angibt, dass die Organisation in den schreibgeschützten Modus versetzt wurde, und notieren Sie die Anforderungs-ID für diese Meldung.

   Successfully set the organization to read-only mode

5. Klicken Sie auf Query, um zu den Abfrageprotokollmeldungen zurückzukehren.
6. Geben Sie die in Schritt 4 notierte Anforderungs-ID in das Feld RequestIDs ein.
7. Wählen Sie im Feld Federated Servers die Option All aus.
8. Klicken Sie auf Query, und überprüfen Sie für alle Komponenten die Protokolle im Zusammenhang mit der Versetzung der Organisation in den schreibgeschützten Modus.

Verwenden von Ereignisfiltern in einer Abfrage zum Eingrenzen der Suche

Um Ereignisse besser einzugrenzen und relevantere Meldungen anzuzeigen, können Abfragen basierend auf Protokollierungsebene, Quellkomponente, Zeit, einem bestimmten Protokollcode oder Codebereichen, einem bestimmten Benutzer oder einer Benutzerliste und Anforderungs-ID durchgeführt werden. Sie können eine beliebige Anzahl dieser Filter als Teil Ihrer Abfrage kombinieren.

Um alle Protokollmeldungen einer Organisation abzufragen, können Sie die Verbundserver auswählen. Mit Zeit und Anforderungs-ID können Protokollmeldungen auf mehreren Komponenten gefiltert werden, während mit den restlichen Optionen lediglich Portal-Protokolle gefiltert werden. Wenn Sie weitere Optionen zum Filtern von Serverprotokollen verwenden möchten, können Sie ArcGIS Server Manager verwenden.

Um auf diese Filter zuzugreifen, melden Sie sich beim Portal-Administratorverzeichnis an, und klicken Sie auf Home > Logs > Query.

Protokollierungsebene

Ereignisse reichen in ihrer Detailliertheit von Severe, womit auf ein Problem hingewiesen wird, das ein sofortiges Eingreifen erfordert, bis zu Verbose, d. h. eine ausführliche, informative Meldung, die durch die normale Verwendung des Portals generiert wird. Wählen Sie die gewünschte Ebene aus der Dropdown-Liste Log level aus. Eine detaillierte Zusammenfassung der einzelnen Ebenen finden Sie unter Protokolltyp.

Quelle

Die Quelle der protokollierten Ereignisse wird aus den Freigabe-, Verwaltungs- und Portal-Komponenten der Software generiert. Beispiel:

• Ereignisse, die sich auf die Veröffentlichung und die Benutzer beziehen, werden unter Sharing kategorisiert.
• Ereignisse, die mit Sicherheit und Indizierung in Beziehung stehen, werden unter Portal Admin kategorisiert.
• Mit der Installation der Software verknüpfte Ereignisse werden unter Portal kategorisiert.

Alle Quellen werden standardmäßig abgefragt (die Option Alle aus der Dropdown-Liste). Um Portal-Ereignisse nach einer bestimmten Quelle zu filtern, wählen Sie die gewünschte Quelle in der Dropdown-Liste Source aus.

Zeit

Um Ereignisse nach einem bestimmten Zeitrahmen zu filtern, geben Sie die gewünschten Zeitwerte über die Felder Start Time und End Time (im Format yyyy-mm-ddThh:mm:ss) an. Die Startzeit ist die jüngste und die Endzeit ist die älteste Zeit. Beispiel:

• Um ein Zeitintervall von 15 Minuten zu definieren, wird 2015-05-01T13:15:00 als Startzeit und 2015-05-01T13:00:00 als Endzeit angegeben.
• Um ein Zeitintervall von einer Stunde zu definieren, wird 2015-05-01T14:00:00 als Startzeit und 2015-05-01T13:00:00 als Endzeit angegeben.
• Um einen Tag zu definieren, wird 2015-05-02T12:00:00 als Startzeit und 2015-05-01T12:00:00 als Endzeit festgelegt.
• Um alle Protokolle abzufragen, lassen Sie die Zeitfelder leer.

Wenn die Startzeit, aber keine Endzeit angegeben wird, werden die ältesten Protokolle in aufsteigender Reihenfolge bis zur angegebenen Startzeit zurückgegeben. Umgekehrt werden die jüngsten Protokolle in absteigender Reihenfolge bis zur angegebenen Endzeit zurückgegeben, wenn keine Startzeit, aber eine Endzeit angegeben wird.

Bei Auswahl werden auf Verbundservern protokollierte Ereignisse ebenfalls gefiltert.

Protokollcodes

Jede Meldung ist mit einem Protokollcode verknüpft. Die Codes sind in mehrere Kategorien unterteilt. Sie können Portal-Protokolle basierend auf einem bestimmten Code oder Codebereich filtern, z. B.:

• Um nach einem einzelnen Code zu filtern, geben Sie den Codewert (z. B. 204028) an.
• Um nach bestimmten Codes zu filtern, trennen Sie die Codes durch ein Komma (,) (z. B. 204028, 212015, 219114).
• Um nach einem Codebereich zu filtern, z. B. nach allen Codes in der Sicherheitskategorie, geben Sie den Anfangs- und den Endcode durch einen Bindestrich getrennt (-) (z. B. 204000–205999) ein.
• Um nach einem Codebereich und einzelnen Codes zu filtern, geben Sie den Anfangs- und den Endcode (durch einen Bindestrich getrennt) ein, und trennen Sie die einzelnen Codes durch ein Komma (z. B. 204000–205999, 212015, 219114).

Benutzer

Um Portal-Ereignisse für einen bestimmten Benutzer zu filtern, geben Sie den gewünschten Benutzer in das Feld Users ein, z. B.:

• Um nach einem bestimmten Benutzer zu filtern, geben Sie den Benutzernamen ein (z. B. jcho für John Cho).
• Um nach vielen Benutzern zu filtern, trennen Sie die Benutzernamen durch ein Komma (,) (z. B. jcho, asmith für John Cho und Ashley Smith).

Hinweis:

Die Verwendung von Platzhalterzeichen (*) wird nicht unterstützt.

Anforderungs-IDs

Die eindeutige ID-Zeichenfolge, die an jede übermittelte Anforderung angehängt wird und während des gesamten Lebenszyklus der Anforderung im System beibehalten wird Wählen Sie einen oder alle Verbundserver aus, wenn Sie für einen Vorgang, der mehrere Komponenten betrifft, nach Anforderungs-ID filtern.

Anzahl der Meldungen

Die Anzahl der Meldungen, die beim Ausführen einer Abfrage angezeigt werden sollen. Meldungen werden auf einer einzelnen Webseite angezeigt. Führen Sie bei Bedarf einen Bildlauf durch, um alle Meldungen anzuzeigen.

Verbundserver

Um Probleme zu beheben oder Erkenntnisse zu Vorgängen zu gewinnen, die mehrere ArcGIS Enterprise-Komponenten betreffen, binden Sie Serverprotokolle in Ihre Abfrage ein, indem Sie einen oder alle Verbundserver auswählen. Beim Abfragen der Protokolle des Hosting-Servers werden auch ArcGIS Data Store-Protokolle einbezogen.

Löschen der Protokolle

Wenn Sie die Protokolle löschen möchten, klicken Sie auf Home > Logs > Clean > Clean Logs. Daraufhin werden alle Protokollmeldungen von dem Portal-Computer gelöscht. Beim Debuggen eines bestimmten Szenarios, das Probleme mit dem Portal verursacht, kann das Löschen der Protokolle dazu beitragen, das Problem zu identifizieren. So werden alle sonstigen Ereignisse aus dem Protokoll entfernt, und Sie können sich auf das Debuggen des Problems konzentrieren.

Zum Löschen von Serverprotokollen können Sie ArcGIS Server Manager verwenden.