Serilog.Sinks.GoogleCloudLogging

Serilog sink that writes events to Google Cloud Logging.

Built for net6.0, net5.0, netstandard2.0

Release notes here: CHANGELOG.md

Usage

Install package from Nuget:

dotnet add package Serilog.Sinks.GoogleCloudLogging

Configure Logger (using code):

var config = new GoogleCloudLoggingSinkOptions { ProjectId = "YOUR_PROJECT_ID", UseJsonOutput = true };
Log.Logger = new LoggerConfiguration().WriteTo.GoogleCloudLogging(config).CreateLogger();

Configure Logger (using config file):

This requires the serilog-settings-configuration package.

// appsettings.json or other config file
"Serilog": {
  "Using": [ "Serilog.Sinks.GoogleCloudLogging" ],
  "MinimumLevel": "Information",
  "WriteTo": [
    {
      "Name": "GoogleCloudLogging",
      "Args": {
        "projectID": "PROJECT-ID-12345",
        "labels": {
          "foo": "bar"
        },
        "useSourceContextAsLogName": true,
        "useJsonOutput": true,
        "restrictedToMinimumLevel": "Information"
      }
    }
  ]
}

var config = new ConfigurationBuilder().AddJsonFile("appsettings.json", optional: true, reloadOnChange: true).Build();
Log.Logger = new LoggerConfiguration().ReadFrom.Configuration(config).CreateLogger();

GCP Authentication

This library uses the Google Cloud .NET client and Application Default Credentials. The Logs Writer permission is required to send logs.

• Run in GCE, GKE, Cloud Run, AppEngine to automatically have the Application Default Credentials set to the active service account.