Existen tres maneras de utilizar la biblioteca cliente de Stackdriver Logging:
- Opción 1: Mediante una integración de núcleo ASP.NET
- Opción 2: Mediante una integración de Log4Net con un ASP.NET Framework
- Opción 3: Mediante la escritura de registros personalizados con la API de Logging
Opción 1: Mediante una integración de núcleo ASP.NET
Google.Cloud.Diagnostics.AspNetCore es una biblioteca que envía los registros ASP.NET estándares a Stackdriver Logging.
Para comenzar a generar registros con Google.Cloud.Diagnostics.AspNetCore, instala la biblioteca con uno de estos comandos:
Administrador de paquetes
PM> Install-Package Google.Cloud.Diagnostics.AspNetCore -Version 2.0.1
CLI de .NET
> dotnet add package Google.Cloud.Diagnostics.AspNetCore --version 2.0.1
A continuación, edita tu archivo Startup.cs
con los siguientes cambios:
Agrega el siguiente fragmento con declaraciones a la parte superior de
Startup.cs
:Modifica la función
Configure
. Agrega unILoggerFactory loggerFactory
y agrega una llamada aloggerFactory.AddGoogle("YOUR-PROJECT-ID")
:Compila y ejecuta tu código en Visual Studio. Ve las entradas de registro en el visor de registros de Stackdriver Logging en el recurso Global.
Opción 2: Mediante una integración de Log4Net
Log4Net es una biblioteca de Apache que te permite enviar declaraciones de registro a diferentes destinos de salida.
Para comenzar a realizar registros con la integración de Log4Net, instala la biblioteca Google.Cloud.Registros.Log4Net con este comando:
PM> Install-Package Google.Cloud.Logging.Log4Net -Version 2.2.1
A continuación, sigue estos pasos:
Agrega una sección de configuración Log4Net XML al archivo
Web.config
de la configuración de tu aplicación web, que contenga el siguiente código:Agrega la siguiente línea de código al archivo Global.asax.cs de tu aplicación para configurar Log4net a fin de que utilice Stackdriver Logging:
log4net.Config.XmlConfigurator.Configure();
Una vez que agregaste la línea anterior a tu código, cambia el método
Application_Start()
enGlobal.asax.cs
a lo siguiente:Para utilizar Log4net en el código de tu aplicación, agrega la siguiente declaración para incluir la biblioteca cliente:
using log4net;
Agrega el siguiente código a tu aplicación para escribir registros que aparecerán en el visor de registros de Stackdriver en el recurso Global. El nombre del registro se especifica en el archivo
Web.config
:Compila y ejecuta tu código en Visual Studio. Ve las entradas de registro en el visor de registros de Stackdriver Logging en el recurso Global.
Opción 3: Mediante la escritura de registros personalizados con la API de Stackdriver Logging
Además, tienes la opción de escribir registros personalizados; para ello, llama directamente a la API de Stackdriver Logging.
Para comenzar a generar registros con Google.Cloud.Registros.V2, instala la biblioteca con uno de estos comandos:
Administrador de paquetes
PM> Install-Package Google.Cloud.Logging.V2 -Version 2.2.0
CLI de .NET
> dotnet add package Google.Cloud.Logging.V2 --version 2.2.0
Una vez instalado el cliente de Stackdriver Logging, puedes comenzar a enviar los registros de tu aplicación a Stackdriver Logging; para ello, agrega la siguiente declaración al código de tu aplicación:
using Google.Cloud.Logging.V2;
using Google.Cloud.Logging.Type;
using Google.Cloud.Api;
Personaliza el siguiente método y agrégalo al código de tu aplicación:
Escribe algún código de registro que llame a WriteLogEntry()
. La entrada de registro que se genere como resultado estará en el visor de registros en el recurso Global:
Para obtener detalles sobre el visor de registros, consulta Visualiza los registros.