Administratoreinstellungen – Protokoll

Logbereich

Im Bereich Log werden die 500 neuesten Systemlog-Nachrichten angezeigt, die von Ihrer Looker-Instanz generiert wurden. Wählen Sie im Bereich Server des Menüs Admin die Option Log aus, um die Seite Log aufzurufen.

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

Wenn Sie das Log aktualisieren und die letzten 500 Nachrichten anzeigen möchten, wählen Sie Log aktualisieren aus.

Wenn Sie den Schweregrad von Lognachrichten anpassen möchten, die für Looker-Dienste angezeigt werden, passen Sie die Logebenen an.

Protokollebenen

Im Bereich Log Levels (Logebenen) können Sie für verschiedene Looker-Dienste den Mindestschweregrad festlegen, der erforderlich ist, damit eine Meldung im Log angezeigt wird. So können Sie Loginformationen ausblenden, die Sie nicht interessieren.

Die Standardstufe für den Schweregrad 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 nach personenbezogenen Daten filtern, von Looker protokolliert werden. Das gilt für Schweregradeinstellungen von info, verbose oder debug. Wenn Sie die Protokollierung 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 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).

Schweregradbeschreibungen

Die Schweregrade von Logmeldungen sind unten vom niedrigsten zum höchsten Schweregrad aufgeführt:

  • debug: Debug-Logeinträge sind detaillierte Informationsmeldungen, die die internen Anwendungsprozesse von Looker zeigen. Diese Schweregradstufe wird in der Regel nur zum Debuggen von internem Code verwendet.

  • verbose: Das sind detaillierte Informationsmeldungen, in denen Ereignisse in Looker auf einer feineren Ebene angezeigt werden. Diese Schweregradstufe wird in der Regel nur zur Fehlerbehebung verwendet.

  • info: Dies sind Standard-Informationsmeldungen, die regelmäßig in Looker auftretende Ereignisse anzeigen.

  • Warnung: Diese Meldungen weisen auf potenziell schädliche Situationen hin.

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

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

Dienstbeschreibungen

Im Drop-down-Menü Standard wird die Standard-Schweregradstufe für alle Looker-Dienste festgelegt. Für alle Dienste, die auf Standard festgelegt sind, wird der Schweregrad in der Drop-down-Liste Standard verwendet. Der Standard-Schweregrad für das Drop-down-Menü Standard ist info.

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

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

  • db:*: Nachrichten, die durch Abfragen der Analysedatenbank oder einer beliebigen Kundendatenbank generiert werden.

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

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

  • http_core: Meldungen, die aus HTTP-Anfragen an den Core-Webserver generiert werden, der die internen Komponenten der Anwendung bereitstellt.

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

  • logger: Nachrichten, die generiert werden, wenn Sie Änderungen an der Logebene 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, für die PDT-Neugenerierung und für andere zeitaufwendige Aufgaben verwendet.

  • raven: Nachrichten, die vom Dienst zur Fehlerberichterstattung 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 Ihre Änderungen zu speichern.

Protokollformat auf vom Kunden gehosteten Instanzen festlegen

Systemmeldungen werden standardmäßig im folgenden Format als Text 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, z. B. Ausnahmen und SQL-Abfragen, werden als mehrzeilige Ausgabe generiert. Dies kann zu Problemen bei der Verarbeitung von Logs führen, bei der für den Musterabgleich Einträge in einer einzelnen Zeile erforderlich sind.

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