Using .NET logging frameworks or calling the API

There are several ways to use Cloud Logging from your .NET application:

• Use a Google logging provider for .NET's standard logging framework
• Use a Google Log4Net provider
• Use Google.Cloud.Logging.V2 to directly call the Logging API

Use a Google logging provider for .NET's standard logging framework

You can enable Cloud Logging for .NET applications by using the Google.Cloud.Diagnostics libraries for .NET.

• For applications that target ASP.NET Core 3 or later, use the Google.Cloud.Diagnostics.AspNetCore3 library. See the Google.Cloud.Diagnostics.AspNetCore3 documentation for more information and examples.
• For applications that target earlier versions of ASP.NET Core, use the Google.Cloud.Diagnostics.AspNetCore library. See the Google.Cloud.Diagnostics.AspNetCore documentation for more information and examples.
• For applications that target non ASP.NET Core platforms, use the Google.Cloud.Diagnostics.Common library. See the Google.Cloud.Diagnostics.Common documentation for more information and examples.

Use a Google Log4Net provider

The Google.Cloud.Logging.Log4Net library implements a Log4Net provider for Cloud Logging. For examples that show how to configure and use this library, see the Google.Cloud.Logging.Log4Net documentation .

Use Google.Cloud.Logging.V2 to directly call the Logging API

You can also write logs by calling the Cloud Logging API using the Google.Cloud.Logging.V2 client library. You can install this library from NuGet .

After the Google.Cloud.Logging.V2 client library is installed, you can start sending your application's logs to Cloud Logging. For example, you might customize the following method and add it to your application code. To view the full sample, click more_vert More , and then select View on GitHub .

  private 
  
 void 
  
 WriteLogEntry 
 ( 
 string 
  
 logId 
 ) 
 { 
  
 var 
  
 client 
  
 = 
  
 LoggingServiceV2Client 
 . 
 Create 
 (); 
  
 LogName 
  
 logName 
  
 = 
  
 new 
  
 LogName 
 ( 
 s_projectId 
 , 
  
 logId 
 ); 
  
 var 
  
 jsonPayload 
  
 = 
  
 new 
  
 Struct 
 () 
  
 { 
  
 Fields 
  
 = 
  
 { 
  
 { 
  
 "name" 
 , 
  
 Value 
 . 
 ForString 
 ( 
 "King Arthur" 
 ) 
  
 }, 
  
 { 
  
 "quest" 
 , 
  
 Value 
 . 
 ForString 
 ( 
 "Find the Holy Grail" 
 ) 
  
 }, 
  
 { 
  
 "favorite_color" 
 , 
  
 Value 
 . 
 ForString 
 ( 
 "Blue" 
 ) 
  
 } 
  
 } 
  
 }; 
  
 LogEntry 
  
 logEntry 
  
 = 
  
 new 
  
 LogEntry 
  
 { 
  
 LogNameAsLogName 
  
 = 
  
 logName 
 , 
  
 Severity 
  
 = 
  
 LogSeverity 
 . 
 Info 
 , 
  
 JsonPayload 
  
 = 
  
 jsonPayload 
  
 }; 
  
 MonitoredResource 
  
 resource 
  
 = 
  
 new 
  
 MonitoredResource 
  
 { 
  
 Type 
  
 = 
  
 "global" 
  
 }; 
  
 IDictionary<string 
 , 
  
 string 
>  
 entryLabels 
  
 = 
  
 new 
  
 Dictionary<string 
 , 
  
 string 
>  
 { 
  
 { 
  
 "size" 
 , 
  
 "large" 
  
 }, 
  
 { 
  
 "color" 
 , 
  
 "blue" 
  
 } 
  
 }; 
  
 client 
 . 
 WriteLogEntries 
 ( 
 logName 
 , 
  
 resource 
 , 
  
 entryLabels 
 , 
  
 new 
 [] 
  
 { 
  
 logEntry 
  
 }, 
  
 _retryAWhile 
 ); 
  
 Console 
 . 
 WriteLine 
 ( 
 $"Created log entry in log-id: {logId}." 
 ); 
 } 
 

Write some logging code that calls WriteLogEntry() . The resulting log entry will be in the Logs Explorer under the Globalresource.

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 .

Resources

• For details on the Logs Explorer, see [Using the Logs Explorer][view-ui].
• For ASP.NET Core 3+ applications
  • Documentation: Google.Cloud.Diagnostics.AspNetCore3
  • NuGet: Google.Cloud.Diagnostics.AspNetCore3 package
• For earlier ASP.NET Core applications
  • Documentation: Google.Cloud.Diagnostics.AspNetCore
  • NuGet: Google.Cloud.Diagnostics.AspNetCore package
• For non ASP.NET Core applications
  • Documentation: Google.Cloud.Diagnostics.Common
  • NuGet: Google.Cloud.Diagnostics.Common package
• Log4Net Provider
  • Documentation: Google.Cloud.Logging.Log4Net
  • NuGet: Google.Cloud.Logging.Log4Net package
• GitHub: googleapis/google-cloud-dotnet
• GitHub issue tracker