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 einschränken, welche Informationen im Bereich „Protokoll“ 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 Protokoll aktualisieren und die 500 neuesten Nachrichten anzeigen lassen möchten, wählen Sie Protokoll aktualisieren aus.
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 Berichten zur Nutzung Ihrer Looker-Instanz finden Sie auf der Dokumentationsseite Looker-Nutzungsberichte mit Explores für Systemaktivitäten erstellen.
Protokollebenen
Im Bereich Logebenen können Sie für verschiedene Looker-Dienste den Mindestschweregrad festlegen, der erforderlich ist, damit eine Meldung im Protokoll angezeigt wird. So können Sie Protokollinformationen ausblenden, die Sie nicht interessieren.
Die Standardstufe der Schwere für die Dienste db:* und db:looker ist auf info festgelegt. Das bedeutet, dass SQL-Anweisungen, die personenbezogene Daten enthalten oder nach ihnen filtern (z. B. Kundennamen), von Looker protokolliert werden. Das gilt für die Schweregradeinstellungen info, verbose 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 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 in der Regel nur zum Debuggen von internem Code verwendet.
ausführlich: Detaillierte Informationsmeldungen, die Ereignisse in Looker auf einer detaillierteren Ebene anzeigen. Dieser Schweregrad wird in der Regel nur zur Fehlerbehebung verwendet.
info: Hierbei handelt es sich um standardmäßige Informationsmeldungen, die regelmäßige Ereignisse in Looker anzeigen.
warn: Diese Meldungen weisen auf potenziell schädliche Situationen hin.
error: Diese Meldungen beziehen sich auf Fehlerereignisse, die wahrscheinlich nicht schwerwiegend genug sind, um den Betrieb 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 Standardschweregrad für das Drop-down-Menü Standard ist Info.
Sie können die Schweregrade auch für die folgenden Dienste einzeln festlegen:
pdt: Nachrichten, die dem Prozess Persistente abgeleitete Tabelle zugeordnet sind.
db:*: Nachrichten, die durch Abfragen an die Analysedatenbank oder an eine Kundendatenbank generiert werden.
db:looker: Meldungen, die durch Abfragen an die Looker-Backend-Datenbank 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 von SSH-Verbindungen zum Git-Dienst generiert werden. Die Standardeinstellung ist Warnung, bei der keine Informationen angezeigt werden. Wechseln Sie zur info-Ebene, 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, der PDT-Wiederherstellung und anderen langwierigen Aufgaben verwendet.
raven: Nachrichten, die vom Dienst zur Fehlermeldung generiert werden.
render: Meldungen, 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, z. B. Ausnahmen und SQL-Abfragen, werden als mehrzeilige Ausgabe generiert. Das kann zu Problemen bei Protokoll-Prozessoren führen, die für das Musterabgleich Einträge mit einer Zeile erfordern.
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"}