Protokolle schreiben und ansehen


Logging ist ein wichtiges Tool zum Debuggen und Überwachen von Code. Cloud Functions bietet Ihnen die Möglichkeit, das eigene Protokollierungs-SDK, benutzerdefiniertes Google Cloud Logging oder der Objektstandard console für die Entwicklung im Web.

Logs schreiben

Das Cloud Functions Logger SDK wird für die meisten Situationen empfohlen. Unter folgenden Umständen können Sie jedoch eine der anderen Optionen auswählen:

  • Sie haben bereits eine Codebasis und möchten nicht von console.log refaktorieren.
  • Sie sind mit Cloud Logging (früher StackDriver Logging) vertraut und bevorzugen um sie für das benutzerdefinierte Logging zu verwenden.

Protokollierungs-SDK für Cloud Functions verwenden

Das Cloud Functions-Logger-SDK bietet eine Standardschnittstelle mit einer ähnlichen API wie console.log-Anweisungen und unterstützt andere Protokollebenen. Mit diesem SDK können Sie Ereignisse mit strukturierten Daten, einfachere Analyse und Überwachung ermöglichen.

Das Protokoll-SDK unterstützt Logeinträge als Teil des Platzhalterimports. Beispiel:

  const functions = require("firebase-functions/v1");

  functions.logger.log("Hello from info. Here's an object:", someObj);

Alternativ können Sie einzelne Exporte verwenden. Dieses Beispiel zeigt, strukturierte Daten, die als letztes Argument an das Log angehängt werden:

const { warn } = require("firebase-functions/logger");


// Attach structured data to the log as the last argument.
warn("This is a 'WARNING' severity message with some metadata.", {
  key1: 'val1',
  key2: 'val2'
});
  • logger.log()-Befehle haben die Logebene INFO.
  • logger.info()-Befehle haben die Logebene INFO.
  • logger.warn()-Befehle haben die Logebene WARNUNG.
  • logger.error()-Befehle haben die Logebene ERROR.
  • Interne Systemmeldungen haben die Logebene DEBUG (Fehlerbehebung).

Mit logger.write() können Sie Logeinträge mit den zusätzlichen Wichtigkeitsstufen CRITICAL, ALERT und EMERGENCY schreiben. Siehe LogSeverity.

Benutzerdefinierte Cloud Logging-Logs

Cloud Functions-Logs mit dem Protokollierungs-SDK werden von Cloud Logging gestützt. Sie können die Cloud Logging-Bibliothek für Node.js verwenden. um Ereignisse mit strukturierten Daten zu protokollieren. Das ermöglicht eine einfachere Analyse und Überwachung.

const { Logging } = require('@google-cloud/logging');

// ...

// Instantiate the logging SDK. The project ID will
// be automatically inferred from the Cloud Functions environment.
const logging = new Logging();
const log = logging.log('my-custom-log-name');

// This metadata is attached to each log entry. This specifies a fake
// Cloud Function called 'Custom Metrics' in order to make your custom
// log entries appear in the Cloud Functions logs viewer.
const METADATA = {
  resource: {
    type: 'cloud_function',
    labels: {
      function_name: 'CustomMetrics',
      region: 'us-central1'
    }
  }
};

// ...

// Data to write to the log. This can be a JSON object with any properties
// of the event you want to record.
const data = {
  event: 'my-event',
  value: 'foo-bar-baz',

  // Optional 'message' property will show up in the Firebase
  // console and other human-readable logging surfaces
  message: 'my-event: foo-bar-baz'
};

// Write to the log. The log.write() call returns a Promise if you want to
// make sure that the log was written successfully.
const entry = log.entry(METADATA, data);
log.write(entry);
index.js

console.log verwenden

Für das Logging aus einer Funktion wird das Logger SDK für Ihre Plattform empfohlen. Mit Node.js können Sie stattdessen das standardmäßige JavaScript-Logging verwenden console.log und console.error aufrufen. Sie müssen jedoch zuerst eine Spezielles Modul, um die Standardmethoden zu patchen, damit sie ordnungsgemäß funktionieren:

require("firebase-functions/logger/compat");

Sobald Sie das Protokollierungskompatibilitätsmodul benötigt haben, können Sie console.log()-Methoden wie gewohnt in Ihren Code ein:

exports.helloError = functions.https.onRequest((request, response) => {
  console.log('I am a log entry!');
  response.send('Hello World...');
});
index.js
  • console.log()-Befehle haben die Logebene INFO.
  • console.info()-Befehle haben die Logebene INFO.
  • console.warn()-Befehle haben die Logebene ERROR.
  • console.error()-Befehle haben die Logebene FEHLER.
  • Interne Systemmeldungen haben die Logebene DEBUG (Fehlerbehebung).

Logs ansehen

Logs für Cloud Functions sind sichtbar in den Google Cloud-Konsole, Cloud Logging-Benutzeroberfläche oder über das firebase-Befehlszeilentool.

Mit der Firebase CLI

Verwenden Sie den Befehl functions:log, um Logs mit dem firebase-Tool aufzurufen:

firebase functions:log

Um Logs für eine bestimmte Funktion anzusehen, geben Sie den Funktionsnamen als Argument an:

firebase functions:log --only <FUNCTION_NAME>

Informationen zu allen Loganzeigeoptionen finden Sie in der Hilfe zu functions:log:

firebase help functions:log

Google Cloud-Konsole verwenden

Sie können Logs für Funktionen in der Google Cloud-Konsole ansehen.

Cloud Logging-UI verwenden

Sie können Logs für Cloud Functions ansehen. in der Cloud Logging-Benutzeroberfläche.

Logs analysieren

Cloud Logging bietet eine leistungsstarke Suite von Loganalysetools, die Sie zum Überwachen von Cloud Functions verwenden.

Diagramme und Benachrichtigungen

Nachdem Sie logbasierte Messwerte zum Überwachen Ihrer Funktionen erstellt haben, können Sie Diagramme und Benachrichtigungen auf der Grundlage dieser Messwerte zu erstellen. Sie könnten beispielsweise ein Diagramm erstellen, um die Latenz im Zeitverlauf zu visualisieren, oder eine Benachrichtigung erstellen, wenn ein bestimmter Fehler zu oft auftritt.

Ausführliche Informationen dazu, wie Sie Diagramme und Benachrichtigungen erstellen, finden Sie unter Diagramme und Benachrichtigungen erstellen. um logbasierte Messwerte in Diagrammen und Benachrichtigungsrichtlinien zu verwenden.