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 Informationen einschränken, die im Bereich „Log“ angezeigt werden. 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.
Protokollebenen
Im Bereich Protokollebenen können Sie für verschiedene Looker-Dienste die Mindestprotokollebene festlegen, die für eine Nachricht erforderlich ist, damit sie im Log angezeigt wird. So können Sie Loginformationen ausblenden, die Sie nicht interessieren.
Die Standardprotokollebene 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 Protokollebenen info, verbose oder debug. Wenn Sie die Protokollierung von SQL-Anweisungen deaktivieren möchten, legen Sie die Protokollebene 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 sind) als auch in einer externen Datenbank (in der Kundendaten und Metadaten gespeichert sind).
Beschreibung der Protokollebenen
Die Protokollebenen für 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 Protokollebene 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 Protokollebene 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 die Standardprotokollebene für alle Looker-Dienste festgelegt. Für alle Dienste, die auf Standard festgelegt sind, wird die Protokollebene im Drop-down-Menü Standard verwendet. Die Standardprotokollebene für das Drop-down-Menü Standard ist info.
Sie können die Protokollebenen auch einzeln für die folgenden Dienste 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 Ebene in info , um Probleme mit der SSH-Verbindung zu beheben.
logger: Meldungen, die generiert werden, wenn Sie Änderungen an der Protokollebene 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 Protokollebene für einen Dienst geändert haben, wählen Sie Ebenen festlegen aus, um die Änderungen zu speichern.
Logformat auf von Kunden gehosteten 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 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. Im folgenden Beispiel werden dieselben Ereignisse wie im vorherigen Beispiel, aber im JSON-Format angezeigt:
{"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"}