Cloud Logging

• About Cloud Logging
• API documentation
• Go client documentation
• Complete sample programs

For an interactive tutorial on using the client library in a Go application, click Guide Me.

Example Usage

First create a logging.Client to use throughout your application: [snip]:# (logging-1)

ctx := context.Background()
client, err := logging.NewClient(ctx, "my-project")
if err != nil {
   // TODO: Handle error.
}

Usually, you'll want to add log entries to a buffer to be periodically flushed (automatically and asynchronously) to the Cloud Logging service. [snip]:# (logging-2)

logger := client.Logger("my-log")
logger.Log(logging.Entry{Payload: "something happened!"})

If you need to write a critical log entry use synchronous ingestion method. [snip]:# (logging-3)

logger := client.Logger("my-log")
logger.LogSync(context.Background(), logging.Entry{Payload: "something happened!"})

Close your client before your program exits, to flush any buffered log entries. [snip]:# (logging-4)

err = client.Close()
if err != nil {
   // TODO: Handle error.
}

Logger configuration options

Creating a Logger using logging.Logger accept configuration LoggerOption arguments. The following options are supported: