Administratoreinstellungen – Protokoll

Logbereich

Im Bereich Protokoll werden die 500 letzten Systemprotokollmeldungen angezeigt, die von Ihrer Looker-Instanz generiert wurden. Wenn Sie die Seite Protokoll aufrufen möchten, wählen Sie im Menü Verwaltung im Bereich Server die Option Protokoll aus.

Sie können die im Logbereich angezeigten Informationen einschränken. Geben Sie dazu Text in das Feld Filter ein. Im Logbereich werden dann nur Nachrichten angezeigt, die diesen Text enthalten.

Wählen Sie Aktualisierungsprotokoll aus, um das Protokoll zu aktualisieren und die neuesten 500 Meldungen aufzurufen.

Wenn Sie den Schweregrad der Logmeldungen anpassen möchten, die für Looker-Dienste angezeigt werden, passen Sie die Lobenen an.

Informationen zum Erstellen von Nutzungsberichten in Ihrer Looker-Instanz finden Sie auf der Dokumentationsseite Looker-Nutzungsberichte mit Systemaktivitäts-Explores erstellen.

Protokollebenen

Im Abschnitt Logebenen können Sie den Mindestschweregrad festlegen, der erforderlich ist, damit eine Nachricht im Protokoll für verschiedene Looker-Dienste angezeigt wird. Auf diese Weise können Sie Protokollinformationen ausblenden, die Sie nicht interessieren.

Der Standardschweregrad für die Dienste db:* und db:looker ist auf info festgelegt. Das bedeutet, dass SQL-Anweisungen, die personenbezogene Daten (z. B. Kundennamen) enthalten oder danach filtern, von Looker protokolliert werden. Dies gilt für die Wichtigkeitseinstellungen von Info, ausführlich oder Debug. Wenn Sie das Logging von SQL-Anweisungen deaktivieren möchten, setzen Sie die Wichtigkeitsstufe der Dienste db:* und db:looker auf warn, error oder fatal.

Looker protokolliert SQL-Anweisungen sowohl in einer internen Datenbank (in der Metadaten für von Nutzern erstellte Looker-Objekte gespeichert werden) als auch in externen Datenbanken (in denen Kundendaten und Metadaten gespeichert werden).

Beschreibungen des Schweregrads

Als Nächstes werden die Schweregrade der Protokollmeldungen aufgeführt, vom geringsten zum höchsten Schweregrad:

  • debug: Debug-Logeinträge sind detaillierte Informationsmeldungen, die die internen Anwendungsabläufe von Looker enthalten. Dieser Schweregrad wird normalerweise nur zur Fehlerbehebung bei internem Code verwendet.

  • ausführlich: Detaillierte Informationsmeldungen, die Ereignisse in Looker auf einer detaillierteren Ebene anzeigen. Dieser Schweregrad wird normalerweise nur zur Fehlerbehebung verwendet.

  • Info: Dies sind Standardmeldungen, die regelmäßige Ereignisse in Looker enthalten.

  • warn: Diese Nachrichten weisen auf potenziell gefährliche Situationen hin.

  • error: Diese Meldungen weisen auf Fehlerereignisse hin, die wahrscheinlich nicht schwerwiegend genug sind, um die Ausführung von Looker zu beenden.

  • fatal: Diese Meldungen weisen auf sehr schwerwiegende Fehlerereignisse hin, die wahrscheinlich dazu führen, dass Looker beendet wird.

Dienstbeschreibungen

Im Drop-down-Menü Standard wird die Standardstufe der Schwere für alle Looker-Dienste festgelegt. Für alle Dienste, die auf Standard gesetzt sind, wird die Schwere in der Drop-down-Liste Standard verwendet. Der standardmäßige Schweregrad im Drop-down-Menü Standard ist info.

Sie können die Schweregrade für die folgenden Dienste auch einzeln festlegen:

  • pdt Nachrichten, die dem Prozess für persistente abgeleitete Tabellen zugeordnet sind.

  • db:*: Nachrichten, die durch Abfragen an die Analysedatenbank oder an eine Kundendatenbank generiert werden.

  • db:looker: Nachrichten, die durch Abfragen an die Backend-Datenbank von Looker generiert werden.

  • http: Nachrichten, die von HTTP-Anfragen generiert werden, die der Frontend-Webserver empfängt oder verarbeitet.

  • http_core: Meldungen, die von HTTP-Anfragen an den Kern-Webserver generiert werden, der die internen Funktionen der Anwendung bereitstellt.

  • jsch: Nachrichten, die durch SSH-Verbindungen zum Git-Dienst generiert werden. Die Standardeinstellung ist die Stufe warnen, bei der keine Informationen angezeigt werden. Wechseln Sie zur info-Ebene, um Probleme mit SSH-Verbindungen zu beheben.

  • logger: Meldungen, die generiert werden, wenn Sie Änderungen an der Protokollebene vornehmen.

  • org.apache.active: Nachrichten, die von ActiveMQ generiert werden. ActiveMQ ist ein Nachrichtendienst, mit dem Looker Aufgaben zwischen Subsystemen kommuniziert. Sie wird vom Scheduler, der PDT-Wiederherstellung und anderen langwierigen Aufgaben verwendet.

  • raven: Nachrichten, die vom Dienst zur Fehlermeldung generiert werden.

  • render: Nachrichten, die vom Renderer generiert werden, der PDFs und PNGs rendert.

  • scheduler: Nachrichten, die vom Scheduler-Prozess generiert werden.

Nachdem Sie die Protokollebene für einen Dienst geändert haben, wählen Sie Ebenen festlegen aus, um die Änderungen zu speichern.

Protokollformat für von Kunden gehostete Instanzen festlegen

Standardmäßig werden Systemmeldungen im folgenden Format angezeigt:

2019-09-25 15:14:12.301 -0700 [INFO|007d0|main] :: Starting Looker : Version 6.21.0-localdev-ea88a4
...
2019-10-01 14:37:53.424 -0700 [INFO|0002a|http] :: Request from 0:0:0:0:0:0:0:1  GET /folders/1, {}
...
2019-10-01 14:37:53.425 -0700 [INFO|0002a|db:looker] :: (0.000180s) SELECT count(*) AS "COUNT" FROM "USER" LIMIT 1

Einige Systemmeldungen wie Ausnahmen und SQL-Abfragen werden als mehrzeilige Ausgabe generiert. Dies kann zu Problemen bei Logprozessoren führen, die einzeilige Einträge für den Musterabgleich benötigen.

Wenn Ihre Looker-Instanz vom Kunden gehostet wird und Sie eine Ausgabe in einer Zeile benötigen, können Sie mit der --log-format=json Startoption Logeinträge in JSON-Strukturen mit einer Zeile formatieren. Im folgenden Beispiel werden dieselben Ereignisse wie im vorherigen Beispiel gezeigt, jedoch im JSON-Format:

{"t":"2019-09-25 15:14:56.513 -0700","s":"INFO","rid":"007d0","c":"main","msg":"Starting Looker : Version 6.21.0-localdev-ea88a4"}
...
{"t":"2019-10-01T14:35:37.577 -07:00","s":"INFO","rid":"0002c","c":"http","ip":"0:0:0:0:0:0:0:1","verb":"GET","path":"/folders/1","params":{}}
...
{"t":"2019-10-01T14:35:37.581 -07:00","s":"INFO","rid":"0002c","c":"db:looker","duration":"0.000344","sql":"SELECT count(*) AS \"COUNT\" FROM \"USER\" LIMIT 1"}