Administratoreinstellungen – Protokoll

Logbereich

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

Sie können die im Bereich „Log“ angezeigten Informationen einschränken. Geben Sie dazu Text in das Feld Filter ein, damit im Bereich „Log“ nur Nachrichten angezeigt werden, die diesen Text enthalten.

Wählen Sie Log aktualisieren aus, um das Log zu aktualisieren und die 500 neuesten Nachrichten anzuzeigen.

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

Logebenen

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

Die Standardeinstellung für den Schweregrad für die Dienste db:* und db:looker ist info. Das bedeutet, dass SQL-Anweisungen, die personenbezogene Daten enthalten oder nach personenbezogenen Daten filtern (z. B. Kundennamen), von Looker protokolliert werden. Das gilt für die Schweregradeinstellungen info, verbose oder debug. Wenn Sie die Protokollierung von SQL-Anweisungen deaktivieren möchten, legen Sie den Schweregrad 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 einer externen Datenbank (in der 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. Dieser Schweregrad wird in der Regel nur zum Debuggen von internem Code verwendet.

  • verbose: Das sind detaillierte Informationsmeldungen, die Ereignisse in Looker auf einer feineren Ebene zeigen. Dieser Schweregrad wird in der Regel nur zur Fehlerbehebung verwendet.

  • info: Das sind Standardinformationsmeldungen, die reguläre Ereignisse in Looker zeigen.

  • warn: 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 beenden.

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

Dienstbeschreibungen

Über das Drop-down-Menü Standard wird der Standardschweregrad für alle Looker-Dienste festgelegt. Für alle Dienste, die auf Standard festgelegt sind, wird der Schweregrad im Drop-down-Menü Standard verwendet. Der Standardschweregrad für das Drop-down-Menü Standard ist info.

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

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

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

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

  • http: Meldungen, 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: Meldungen, die durch SSH-Verbindungen zum Git-Dienst generiert werden. Die Standardeinstellung ist die Ebene warn, bei der keine Informationen angezeigt werden. Ändern Sie die Einstellung auf die Ebene info , um Probleme mit SSH-Verbindungen zu beheben.

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

  • org.apache.active: Meldungen, die von ActiveMQ generiert werden. ActiveMQ ist ein Nachrichtendienst, mit dem Looker Aufgaben zwischen Subsystemen kommuniziert. Er wird vom Planer, von der PDT-Neugenerierung und anderen zeitaufwendigen Aufgaben verwendet.

  • raven: Meldungen, die vom Fehlerberichterstattungsdienst generiert werden.

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

  • scheduler: Meldungen, die vom Planerprozess generiert werden.

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

Logformat für vom Kunden gehostete Instanzen festlegen

Standardmäßig werden Systemmeldungen 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. Das kann zu Problemen für Logprozessoren führen, die für den Mustervergleich einzeilige Einträge erfordern.

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 angezeigt, aber 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"}