Auf der Seite Log im Menü Admin von Looker können Sie die 500 neuesten Systemlogmeldungen ansehen und filtern, die von Ihrer Instanz generiert wurden. Sie können auch Mindestschweregrade für einzelne Looker-Dienste konfigurieren, um Fehler bei Anwendungsereignissen zu beheben und zu steuern, welche Meldungen im Log angezeigt werden.
Logbereich
Im Bereich Log werden die 500 neuesten Systemprotokollmeldungen angezeigt, die von Ihrer Looker-Instanz generiert wurden. Wenn Sie die Seite Log aufrufen möchten, wählen Sie im Menü Admin im Bereich Server die Option Log aus.
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 Meldungen angezeigt werden, die diesen Text enthalten.
Wenn Sie das Log aktualisieren und die 500 neuesten Meldungen anzeigen möchten, wählen Sie Log aktualisieren aus.
Wenn Sie den Schweregrad von Logeinträgen 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 die Mindestschweregradebene festlegen, die für eine Meldung erforderlich ist, damit sie im Log angezeigt wird. So können Sie Loginformationen ausblenden, die Sie nicht interessieren.
Die Standard-Schweregradebene für die Dienste db:* und db:looker ist auf info festgelegt. 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 die Schweregradebene 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 Schweregradebenen für Logeinträge 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 Schweregradebene 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. Diese Schweregradebene wird in der Regel nur zur Fehlerbehebung verwendet.
info: Das sind Standard-Informationsmeldungen, 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 die Standard-Schweregradebene für alle Looker-Dienste festgelegt. Für alle Dienste, die auf Standard festgelegt sind, wird die Schweregradebene im Drop-down-Menü Standard verwendet. Die Standard-Schweregradebene für das Drop-down-Menü Standard ist info.
Sie können auch für die folgenden Dienste einzeln Schweregradebenen 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 in 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 Messaging-Dienst, mit dem Looker Aufgaben zwischen Subsystemen kommuniziert. Er wird vom Scheduler, von der PDT-Neugenerierung und anderen zeitaufwendigen Aufgaben verwendet.
raven: Meldungen, die vom Dienst zur Fehlerberichterstattung generiert werden.
render: Meldungen, die vom Renderer generiert werden, der PDFs und PNGs rendert.
scheduler: Meldungen, die vom Scheduler-Prozess 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 von 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 wie Ausnahmen und SQL-Abfragen werden als mehrzeilige Ausgabe generiert. Das kann zu Problemen bei Logprozessoren führen, die für den Mustervergleich einzeilige Einträge erfordern.
Wenn Ihre Looker-Instanz von 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. Das folgende Beispiel zeigt dieselben Ereignisse wie das vorherige Beispiel, 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"}