Logging-Bibliotheken – Übersicht

Viele Programmiersprachen haben Standardoberflächen zum Schreiben von Logs, die Sie für die Verwendung von Logging konfigurieren können.

Hinweis:Sie können Ihre Anwendung so instrumentieren, dass sie anwendungsspezifische Informationen erfasst. Mit mehreren Open-Source-Instrumentierungs-Frameworks können Sie Messwerte, Protokolle und Traces aus Ihrer Anwendung erfassen und an jeden Anbieter senden, einschließlich Google Cloud. Wir empfehlen, zur Instrumentierung Ihrer Anwendung ein anbieterneutrales Open-Source-Instrumentierungsframework wie OpenTelemetry zu verwenden, anstatt anbieter- und produktspezifische APIs oder Clientbibliotheken.

Informationen zur Instrumentierung Ihrer Anwendungen mithilfe von anbieterunabhängigen Instrumentierungsframeworks finden Sie unter Instrumentierung und Beobachtbarkeit.

Logs schreiben

Sie haben folgende Möglichkeiten, um Logs in Cloud Logging zu schreiben:

• Schreiben Sie Ihre Logs in vorhandene Logdateien wie syslog auf Ihrer Compute Engine-VM-Instanz und verwenden Sie den Ops-Agent, um die Logs an Cloud Logging zu senden. Weitere Informationen finden Sie unter Google Cloud Observability-Agents.
• Konfigurieren Sie ein Standard-Logging-Paket, um die von Ihnen geschriebenen Logs an Logging zu senden. Weitere Informationen finden Sie auf den folgenden Seiten:
  • Alle Sprachen: fluentd
  • C#: ASP.NET verwenden oder API aufrufen
  • Java: Logback und java.util.logging verwenden
  • Go: Standard-Logging verwenden
  • Node.js: Winston und Bunyan verwenden
  • PHP: PSR-3 Logger verwenden
  • Python: Standard-Logging-Anwendung verwenden
  • Ruby: Google Cloud Observability-Gem verwenden
• Rufen Sie die Logging API mit den Logging-Clientbibliotheken für Ihre Programmiersprache auf.
• Rufen Sie den REST-Endpunkt der Logging API direkt auf. Weitere Informationen finden Sie in der Referenzdokumentation zur Logging API.
• Verwenden Sie die gcloud CLI. Weitere Informationen finden Sie in der gcloud logging-Befehlszeile.

Hinweis :Eingehende Logeinträge mit Zeitstempeln, die länger als die Aufbewahrungsdauer der Protokolle zurückliegen oder mehr als 24 Stunden in der Zukunft liegen, werden verworfen.

Trace-Daten mit Logeinträgen verknüpfen

Logeinträge können Informationen zu Traces enthalten. Wenn Sie Trace-Daten in Logeinträge aufnehmen, können Sie Logs und Traces korrelieren, um eine bessere verteilte Fehlerbehebung zu ermöglichen. Informationen zum manuellen und automatischen Erfassen von Trace-Informationen in Logeinträgen finden Sie unter In Cloud Logging einbinden.

Protokolle lesen

Sie haben folgende Möglichkeiten, um Logeinträge in Logging zu lesen:

• Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

  Zum Log-Explorer

  Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift Logging ist.

  Weitere Informationen finden Sie unter Log-Explorer – Übersicht.

• Rufen Sie die Logging API über die Clientbibliotheken für Ihre Programmiersprache auf.

• Rufen Sie die REST-Endpunkte der Logging API direkt auf. Weitere Informationen finden Sie in der Referenzdokumentation zur Logging API.

• Verwenden Sie die gcloud CLI. Weitere Informationen finden Sie in der Befehlszeile gcloud logging.