Logging libraries overview

Many programming languages have standard log-writing interfaces that you can reconfigure to use Logging.

Note: You can instrument your application so that it collects application-specific information. Several open-source instrumentation frameworks let you collect metrics, logs, and traces from your application and send that data to any vendor, including Google Cloud. To instrument your application, we recommend that you use a vendor-neutral instrumentation framework that is open source, such as OpenTelemetry, instead of vendor- and product-specific APIs or client libraries.

For information about instrumenting your applications by using vendor-neutral instrumentation frameworks, see Instrumentation and observability.

Write logs

To write logs to Cloud Logging, you can do any of the following:

• Write your logs to existing log files such as syslog on your Compute EngineVM instance and use the Ops Agent to send the logs to Cloud Logging. For more information, see Google Cloud Observability agents.
• Configure a standard logging package to send the logs you write to Logging. For more information, see the following detail pages:
  • Any language: fluentd
  • C#: Using ASP.NET or calling the API
  • Java: Using Logback and java.util.logging
  • Go: Using standard logging
  • Node.js: Using Winston and Bunyan
  • PHP: Using PSR-3 logger
  • Python: Using the standard logging facility
  • Ruby: Using the Google Cloud Observability gem
• Call the Logging API using Logging's Client Libraries for your programming language.
• Call the Logging API REST endpoint directly. See the Logging API reference documentation.
• Use the gcloud CLI. For more information, see the gcloud logging command-line interface.

Note: Incoming log entries with timestamps that are more than the logs retention period in the past or that are more than 24 hours in the future are discarded.

Associate trace data with log entries

Log entries can contain information about traces. By including trace data in log entries, you can correlate logs and traces to enable better distributed troubleshooting. For information about manual and automatic capture of trace information in log entries, see Integrate with Cloud Logging.

Read logs

To read log entries in Logging, you can do any of the following:

• In the Google Cloud console, go to the Logs Explorer page:

  Go to Logs Explorer

  If you use the search bar to find this page, then select the result whose subheading is Logging.

  For more information, see Logs Explorer overview.

• Call the Logging API through the client libraries for your programming language.

• Call the Logging API REST endpoints directly. See the Logging API reference documentation.

• Use the gcloud CLI. For more information, see the gcloud logging command-line interface.