Der Application Server protokolliert Ereignisse, Fehler und andere nützliche Informationen in mehreren Protokolldateien. Diese Tools sind hilfreich, um Informationen zur Nutzung des Application Servers zu finden und Probleme zu beheben.
Beachten Sie, dass die spezifischen Protokolldateien des Application Servers nur Informationen über den Application Server selbst aufzeichnen; sie erfassen keine allgemeinen Nutzungsdaten Ihrer Intranet-Seite. Im Gegensatz dazu protokolliert Ihr Webserver-Log normalerweise Informationen über die gesamte vom Server verwaltete Website.
Der Application Server sendet außerdem E-Mail-Benachrichtigungen bei bestimmten Fehlern. Weitere Informationen zu den E-Mail-Benachrichtigungen finden Sie unter E-Mail-Einstellungen für den Application Server konfigurieren.
In diesem Abschnitt werden folgende Themen behandelt:
- Verfügbare Protokolldateien
- Protokollierungsstufe
- Rotierender Datei-Logger
- Informationen, die in den Protokolldateien des Application Servers aufgezeichnet werden
Verfügbare Protokolldateien
Der Application Server stellt die folgenden Protokolldateien bereit:
- InterAction-Protokolldatei
- Java Servlet Engine-Protokolldateien
- Application Server W3C-Protokolldatei
- Windows-Ereignisanzeige
- Webserver-Protokolldatei
InterAction-Protokolldatei
Die InterAction-Protokolldatei zeichnet alle Fehler auf, die beim Start und während der Verarbeitung im Application Server auftreten. Sie protokolliert außerdem Informationsmeldungen beim Starten des Application Servers, Laden von Konfigurationsdateien, Zwischenspeichern von Daten und beim Beantworten von Browseranfragen.
Diese Datei befindet sich an folgendem Speicherort:
[Laufwerk]:\Program Files\LexisNexis\InterAction\AppServer\logs
Die InterAction-Protokolldatei unterstützt sieben Protokollierungsstufen. Details finden Sie unter Protokollierungsstufe.
Die InterAction-Protokolldatei unterstützt außerdem eine Funktion für „rotierende“ Protokolldateien. Siehe Rotierender Datei-Logger.
Java Servlet Engine-Protokolldateien
Diese Dateien protokollieren Fehler, Ereignisse und die Standardausgabe für die Java Servlet Engine-Komponente des Application Servers.
Es gibt drei Java Servlet Engine-Protokolldateien:
- InterAction-err.log – protokolliert alle Fehler der Java Servlet Engine beim Start und während der Verarbeitung.
- InterAction-event.log – protokolliert Aktionen, die von der Java Servlet Engine ausgeführt werden.
- InterAction-out.log – dies ist die Standardausgabe der Java Servlet Engine.
Diese Dateien befinden sich an folgendem Speicherort:
[Laufwerk]:\Program Files\LexisNexis\InterAction\AppServer\logs
Application Server W3C-Protokolldatei
Diese Datei erfasst Statistiken zu Methodenaufrufen im standardisierten Web-Log-Format. Sie können diese Protokolldatei mit Web-Tracking- oder Analyse-Software verwenden, um Informationen zur Nutzung des Application Servers zu sammeln.
Name und Speicherort dieser Protokolldatei werden in der Variable w3cLogFile in der Datei InterAction.cfg festgelegt. Standardmäßig ist dies:
w3cLogFile = $(IRIS_LOG_DIR)/w3c.log
Bei einer neuen Installation des Application Servers ist diese Protokolldatei standardmäßig deaktiviert.
Standardmäßig befindet sich die Datei InterAction.cfg hier:
[Laufwerk]:\Program Files\LexisNexis\InterAction\AppServer\iahome\
Windows-Ereignisanzeige
In einer Windows Server-Umgebung kann der Application Server Ereignisse auch in die Windows-Ereignisanzeige protokollieren.
In der Regel müssen Sie diese Option nicht aktivieren, da die anderen Dateien ausreichend Protokollierung bieten. Wenn Sie dennoch Ereignisse aufzeichnen möchten, setzen Sie folgende Option in der Datei InterAction.cfg:
enableNTEventLog = true
Dies ist nützlich, wenn Sie die Protokollierung aller Anwendungen an Ihrem Standort zentralisieren oder die Windows-Ereignisanzeige aus der Ferne überwachen möchten.
Webserver-Protokolldatei
Der Webserver erstellt normalerweise Protokolldateien. Diese Dateien enthalten Informationen zu Anfragen und Antworten des Application Servers sowie zum restlichen vom Server verwalteten Webauftritt. Verwenden Sie Ihre Webserver-Software, um diese Protokollierung zu konfigurieren.
Protokollierungsstufe
Die Protokollierungsstufe steuert, welche Ereignisse in der InterAction-Protokolldatei aufgezeichnet werden. Um die Protokollierungsstufe festzulegen, setzen Sie die Variable logLevel in der Datei InterAction.cfg auf den gewünschten Wert.
Die Datei InterAction.cfg befindet sich hier: \Program Files\LexisNexis\InterAction\AppServer\iahome\
Die Protokollierungsstufe kann entweder mit einer Zahl oder mit einem Namen festgelegt werden. Zum Beispiel könnten Sie Folgendes einstellen:
logLevel = 1
Mit dieser Einstellung erhalten Sie die Protokollierungsstufen Config, Info, Warning und Severe. Wenn Sie die Stufe wie folgt setzen:
logLevel = Info
erhalten Sie nur die Stufen Info, Warning und Severe.
Die folgende Tabelle fasst die verfügbaren Protokollierungsstufen zusammen.
Application Server-Protokollierungsstufen
| Protokollierungsstufe | Beschreibung | |
|---|---|---|
| Nummer | Name | |
| Severe | Schwerwiegende Fehler | |
| 0 | Warning | Warnungen |
| Info | Allgemeine Informationen | |
| 1 | Config | Konfigurationsinformationen |
| 2 | Fine | Detailliertere Informationen |
| 3 | Finer | Hochstufige Debugging-Informationen |
| 4 | Finest | Sehr detaillierte Debugging-Informationen |
Im Allgemeinen sollten Sie die Protokollierungsstufen 2, 3 und 4 nur dann verwenden, wenn Sie von LexisNexis InterAction Technical Support dazu aufgefordert werden, um ein Problem zu beheben. Andernfalls werden die Protokolldateien sehr groß.
Ändern der Protokollierungsstufe im Web Client
Auf der Admin-Seite des Web Client können Sie die Protokollierungsstufe schnell auf 1 oder 2 ändern. Diese Änderung aktualisiert jedoch nicht den logLevel-Wert in der Datei InterAction.cfg. Es handelt sich nur um eine temporäre Einstellung, die nach dem Neustart des InterAction Application Servers wieder auf die Einstellung in der InterAction.cfg zurückgesetzt wird.
Sie müssen ein Application Server-Administrationsbenutzer sein, um auf die Admin-Seite im Web Client zugreifen zu können. Siehe Application Server-Administrationsbenutzer.
Rotierender Datei-Logger
Jede Nacht um Mitternacht „rotiert“ die InterAction-Protokolldatei, indem die aktuelle Protokolldatei geschlossen und eine neue geöffnet wird. Das aktuelle Datum wird im Dateinamen aufgenommen, zum Beispiel InterAction-20040811.log.
Der Parameter maxLogHistory in der Datei InterAction.cfg steuert, wie viele Tage an Protokollen aufbewahrt werden. Wenn das Protokoll rotiert, löscht der Application Server alle Protokolldateien, die älter als die angegebene Anzahl von Tagen sind. Die Standardeinstellung ist 30.
Informationen, die in den Protokolldateien des Application Servers aufgezeichnet werden
Die InterAction-Protokolldatei zeichnet alle Fehler und Warnungen auf, die beim Starten des Application Servers und beim Zugriff von Benutzern auf Seiten über den Web Client auftreten.
Beachten Sie, dass derselbe Fehler oder dieselbe Warnung mehrfach in der Protokolldatei erscheinen kann. Das liegt daran, dass derselbe Fehler jedes Mal auftreten kann, wenn eine bestimmte Aktion ausgeführt wird, zum Beispiel jedes Mal, wenn der Application Server den Cache aktualisiert.
Jeder Eintrag im Fehlerprotokoll beginnt immer mit dem Datum und der Uhrzeit des Fehlers. Die Zeitangabe erfolgt im 24-Stunden-Format:
Thu Dec 28 10:59:23 CST 2000 - WARNING: duplicate client ids for client 1234
Das Notieren von Datum und Uhrzeit kann Ihnen helfen, das Protokoll zu interpretieren, da Sie so Nachrichten identifizieren können, die ungefähr zur gleichen Zeit als Reaktion auf dieselbe Aktion aufgezeichnet wurden.
Es gibt drei Arten von Fehlern und Warnungen, die auftreten können:
- Datenintegritätsfehler
- Warnungen
- Java-Ausnahmefehler
Datenintegritätsfehler
Datenintegritätsfehler treten auf, wenn es ein Problem mit den Daten in der InterAction-Datenbank gibt. Diese beginnen immer mit dem Text „Data Integrity Error“ in der Protokolldatei, zum Beispiel:
Data Integrity Error multiple global Business apes of the same type: listing id: 2/43598 ape class: com.interaction.ia.ElectronicAddress
Um diese Fehler zu finden, suchen Sie mit einem Texteditor in der Protokolldatei nach „Data Integrity“.
Der Application Server sendet beim erstmaligen Laden der InterAction-Daten in den Cache eine E-Mail über Datenintegritätsfehler. Nach dem ersten Laden werden die Fehler als Warnungen im Protokoll aufgezeichnet, sodass keine weiteren E-Mails versendet werden. Alle Datenintegritätsfehler werden in einer einzigen E-Mail zusammengefasst.
Der im Application Server-Protokoll aufgezeichnete Fehler enthält das spezifische Problem, die ID des Kontakts, der das Problem verursacht hat, und einen Hinweis auf die Art der Telefonnummer oder Adresse. Die Kontakt-ID wird im folgenden Format angegeben:
Contact Source ID/Contact ID
Im obigen Beispiel hat der problematische Kontakt eine Contact Source ID von 2 und eine Contact ID von 43598. Der Kontakt hat mehrere globale geschäftliche elektronische Adressen desselben Typs.
Datenintegritätsprobleme können in seltenen Fällen auftreten, wenn es Probleme mit Ihrer Datenbank gibt oder wenn zwei Benutzer gleichzeitig dieselben Informationen bearbeiten. Beispiele für diese Fehler sind:
- Kontakte mit mehreren globalen geschäftlichen Telefonnummern oder Adressen. Normalerweise ist dies nicht erlaubt, kann aber in Ausnahmefällen vorkommen.
- Kontakte mit mehreren globalen Postadressen. Auch dies sollte selten vorkommen.
Um diese Probleme zu beheben, suchen Sie die betreffenden Kontakte und korrigieren Sie die Daten in InterAction. Sie können nach der Kontakt-ID suchen. Siehe InterAction nach einer bestimmten Kontakt-ID durchsuchen.
Warnungen
Eine Datenintegritätswarnung tritt auf, wenn in InterAction gespeicherte Daten nicht den Geschäftsregeln des Application Servers entsprechen. Wenn zum Beispiel zwei Kontakte dieselbe Client-ID haben, wird folgende Meldung ins Protokoll geschrieben:
contact: 2/47 and contact: 2/50 have duplicate client ids: 1234
Um diese Probleme zu beheben, suchen Sie die betreffenden Kontakte und korrigieren Sie die Daten in InterAction. Sie können eine Suche verwenden, um die Kontakte zu finden. Wenn zum Beispiel zwei Kontakte dieselbe Kundennummer haben, suchen Sie in InterAction im Zusatzfeld nach der Kundennummer.
Java-Ausnahmefehler
Ein Java-Fehler tritt auf, wenn der Application Server auf ein Problem stößt, das die Verarbeitung verhindert. Benutzer können im Web Client Probleme bemerken, wenn Java-Fehler auftreten. Hier ein Beispiel für einen Java-Fehler:
Thu Dec 28 10:59:23 CST 2000 - (at java.lang.Exception.<init>(Unknown Source)) CustomDef not found in profile: company-general for CustomDef id: 0/32
Bei einigen Fehlern enthält die Protokolldatei zusätzliche Informationen zum Fehler. Diese Informationen können hilfreich sein, wenn Sie mit dem LexisNexis InterAction Technical Support zusammenarbeiten, um ein Problem zu beheben.
Der Application Server sendet außerdem eine E-Mail-Benachrichtigung mit denselben Informationen aus der Protokolldatei. Informationen zum Empfänger dieser Nachrichten finden Sie unter E-Mail-Einstellungen für den Application Server konfigurieren.
Der wichtigste Teil der Nachricht ist der Fehlertext nach der Klammer. Im obigen Beispiel ist dies der Nachrichtentext:
CustomDef not found in profile: company-general for CustomDef id: 0/32)
Diese Fehler sind normalerweise das Ergebnis fehlerhafter Konfigurationsdateien. Im obigen Beispiel verweist die Profilkonfiguration für das Profil „company-general“ auf ein Zusatzfeld, das in Ihrer InterAction-Umgebung nicht definiert ist. Ähnliche Fehler sind Profilangaben, die auf Ordner oder Klassifizierungen verweisen, die in Ihrer Umgebung nicht existieren.
Solche Konfigurationsfehler verursachen Probleme für Benutzer. Wenn ein Web Client-Benutzer versucht, auf ein Profil mit einem dieser Fehler zuzugreifen, wird er wahrscheinlich Fehler oder unerwartete Ergebnisse auf den Webseiten erhalten.
Solche Probleme können auftreten, wenn Sie den Application Server zunächst mit einer Testumgebung konfigurieren und dann auf eine Produktionsumgebung umstellen. Um diese Probleme zu beheben, aktualisieren Sie die Konfigurationsdateien des Application Servers für Ihre InterAction-Umgebung.
Wenn Sie einen Fehler nicht selbst beheben können, wenden Sie sich an den LexisNexis InterAction Technical Support und stellen Sie die Protokolldatei oder die E-Mail-Benachrichtigung mit dem Fehlertext zur Verfügung.
Protokolldateien für bestimmte Benutzer erzeugen
Die InterAction-Protokolldatei zeichnet alle Fehler auf, die der Application Server beim Start und während der Verarbeitung feststellt. Es kann hilfreich sein, eine separate Protokolldatei für einen bestimmten Benutzer oder eine Benutzergruppe zu erstellen. Zum Beispiel kann eine Protokolldatei für einen einzelnen Benutzer dabei helfen, ein Problem gezielt für diesen Benutzer zu analysieren.
Um eine Protokolldatei für bestimmte Benutzer zu erstellen, setzen Sie folgenden Parameter in der Datei InterAction.cfg und trennen Sie die Benutzernamen mit Semikolons:
logusers = userA;userB
Zum Beispiel für die Benutzer jtarnoff und eroberts:
logusers = jtarnoff;eroberts
Wenn die InterAction-Protokolldatei rotiert und eine neue Protokolldatei für den Tag erstellt wird, wird die Standard-Protokolldatei sowie alle zusätzlichen Benutzerprotokolldateien, die Sie angegeben haben, erstellt.
Im obigen Beispiel werden die folgenden drei Protokolldateien erstellt
für den 26.09.2011:
- InterAction-20110926.log
- InterAction-20110926_jtarnoff.log
- InterAction-20110926_eroberts.log
InterAction nach einer bestimmten Kontakt-ID durchsuchen
- Melden Sie sich als Systemadministrator im Windows Client an. Dadurch erhalten Sie Zugriff auf alle Kontakte in der Datenbank.
- Wählen Sie in InterAction Ordner > Neu > Suche.
- Wählen Sie auf der Registerkarte „Ordner“ die Option Alle Ordner durchsuchen, auf die der aktuelle Benutzer LESERECHTE hat.
- Wechseln Sie zur Registerkarte Kriterien.
- Wählen Sie Hinzufügen. Klappen Sie den Punkt Kontaktbedingungen auf und dann die Option Objektbezeichner.
-
Wählen Sie Kontakt-ID und dann OK.
- Geben Sie die Kontakt-ID, die Sie suchen möchten, in das Feld Wert ein und wählen Sie OK.
- Wiederholen Sie die Schritte 5-6, wählen Sie diesmal jedoch die Bedingung Kontakt-Quell-ID aus.
- Geben Sie die Kontakt-Quell-ID des gesuchten Kontakts in das Feld Wert ein und wählen Sie OK.
- Stellen Sie sicher, dass beide Bedingungen im Dialogfeld erscheinen und mit Und verbunden sind. Wählen Sie dann Jetzt suchen, um den Kontakt zu finden.