Log

Logbereich

Auf der Seite Log werden die 500 aktuellen Systemprotokollmeldungen angezeigt, die von Ihrer Looker-Instanz generiert wurden. Wenn Sie die Seite Protokoll aufrufen möchten, wählen Sie im Menü Admin unter Server die Option Protokoll aus.

  1. Wenn Sie die Informationen im Fenster „Protokoll“ einschränken möchten, können Sie im Feld Filter Text eingeben. Im Protokollfenster werden dann nur die Nachrichten angezeigt, die den eingegebenen Text enthalten.
  2. Klicken Sie auf Protokoll aktualisieren, um das Protokoll zu aktualisieren und die letzten 500 Nachrichten anzuzeigen.
  3. Sie können den Schweregrad der Protokollmeldungen anpassen, die für verschiedene Looker-Dienste angezeigt werden. Weitere Informationen dazu finden Sie unten.

Das Protokollfenster ist nicht die beste Möglichkeit, sich die Nutzung oder den Nutzerverlauf anzusehen. Wenn Sie die Labs-Funktion Systemaktivität aktiviert haben, finden Sie stattdessen auf der Dokumentationsseite Looker-Nutzungsberichte mit Tests zur Systemaktivität erstellen weitere Informationen. Andernfalls finden Sie weitere Informationen auf der Dokumentationsseite Looker-Nutzungs- und -Metadatenberichte mit i__looker erstellen.

Protokollebenen

Im Abschnitt Log-Ebenen können Sie den minimalen Schweregrad angeben, der erforderlich ist, damit eine Nachricht im Protokoll für verschiedene Looker-Dienste angezeigt wird. Dadurch können Sie Protokollinformationen ausblenden, die Sie nicht interessieren.

Der standardmäßige Schweregrad für die Dienste db:* und db:looker ist auf info gesetzt. Das bedeutet, dass SQL-Anweisungen, die personenbezogene Daten enthalten oder filtern (z. B. ein Kundenname), von Looker protokolliert werden. Dies gilt für die Einstellungen für den Schweregrad info, ausführlich oder debug. Wenn Sie das Logging von SQL-Anweisungen deaktivieren möchten, legen Sie die Wichtigkeitsstufe der Dienste db:* und db:looker auf warn, error oder fatal fest.

Looker protokolliert SQL-Anweisungen sowohl in unserer internen Datenbank (die Metadaten für von Nutzern erstellte Looker-Objekte) als auch in unseren externen Datenbanken (hier speichern wir Kundendaten und Metadaten).

Beschreibung der Schweregrade

Die Schweregrade der Protokollnachrichten sind unten aufgeführt, vom niedrigsten zum schwersten:

  • debug: Debug-Logeinträge sind detaillierte Informationsmeldungen, die die internen Anwendungsprozesse von Looker zeigen. Dieser Schweregrad wird in der Regel nur für die Fehlerbehebung von internem Code verwendet.

  • ausführlich: Dies sind detaillierte Informationsmeldungen, die Ereignisse in Looker auf einer detaillierteren Ebene anzeigen. Dieser Schweregrad dient in der Regel nur der Fehlerbehebung.

  • info: Dies sind Standardinformationen zu regulären Ereignissen in Looker.

  • warn: Diese Nachrichten weisen auf potenziell schädliche Situationen hin.

  • error: Diese Meldungen weisen auf Fehlerereignisse hin, die wahrscheinlich nicht so schwerwiegend sind, dass Looker nicht mehr ausgeführt wird.

  • Schwerwiegend: Diese Meldungen weisen auf sehr schwere Fehlerereignisse hin, die wahrscheinlich dazu führen, dass Looker nicht mehr ausgeführt wird.

Dienstbeschreibungen

Das Drop-down-Menü Standard legt die standardmäßige Wichtigkeitsstufe für alle Looker-Dienste fest. Für alle Dienste, für die Standard festgelegt ist, wird die Wichtigkeitsstufe im Drop-down-Menü Standard verwendet. Der standardmäßige Schweregrad für das Drop-down-Menü Standard ist Info.

Für die folgenden Dienste können Sie individuelle Schweregrade festlegen:

  • pdt: Nachrichten, die mit dem Prozess für persistente abgeleitete Tabellen verknüpft sind

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

  • db:looker: Nachrichten, die durch Abfragen an die Back-End-Datenbank von Looker generiert wurden

  • http: Nachrichten, die aus HTTP-Anfragen generiert werden, die der Front-End-Webserver empfängt oder verarbeitet

  • http_core: Nachrichten, die aus HTTP-Anfragen an den Webserver generiert werden, der die internen Inhalte der Anwendung bereitstellt

  • jsch: Nachrichten, die von SSH-Verbindungen zum Git-Dienst generiert werden. Die Standardeinstellung ist war, d. h. es werden keine Informationen angezeigt. Wechseln Sie zur Infoebene, um Probleme mit der SSH-Verbindung zu beheben.

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

  • org.Apache.active: Von ActiveMQ generierte Nachrichten ActiveMQ ist ein Messaging-Dienst, mit dem Looker Aufgaben zwischen Subsystemen kommuniziert. Sie wird vom Planer, der PDT-Neuerstellung und anderen lang andauernden Aufgaben verwendet.

  • raven: Nachrichten, die vom Fehlerberichtsdienst generiert werden

  • render: Nachrichten, die vom Renderer generiert wurden und in denen PDFs und PNGs gerendert werden

  • scheduler: Nachrichten, die vom Planerprozess generiert wurden.

Nachdem Sie die Protokollebene für einen Dienst geändert haben, klicken Sie auf Level festlegen, um die Änderungen zu speichern.

Logformat auf vom Kunden gehosteten Instanzen festlegen

Systemmeldungen werden standardmäßig 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 Log-Prozessoren führen, die einen einzeiligen Eintrag für den Musterabgleich erfordern.

Wenn Ihre Looker-Instanz vom Kunden gehostet wird und Sie eine einzeilige Ausgabe benötigen, können Sie die Startoption --log-format=json verwenden, um Logeinträge in einzeilige JSON-Strukturen zu formatieren. Das folgende Beispiel zeigt dieselben Ereignisse wie oben, nur 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"}