Existem três maneiras de usar a biblioteca de cliente do Cloud Logging:
- Opção 1: usar uma integração básica do ASP.NET
- Opção 2: usar uma integração do Log4Net com o ASP.NET Framework
- Opção 3: gravar registros personalizados usando a API Logging
Opção 1: usar uma integração básica do ASP.NET
O Google.Cloud.Diagnostics.AspNetCore é uma biblioteca que envia os registros padrão do ASP.NET para o Cloud Logging.
Para iniciar a geração de registros usando o Google.Cloud.Diagnostics.AspNetCore, instale a biblioteca com um destes comandos:
Administrador de pacotes
PM> Install-Package Google.Cloud.Diagnostics.AspNetCore
CLI do .NET
> dotnet add package Google.Cloud.Diagnostics.AspNetCore
Em seguida, edite o arquivo Startup.cs
com as seguintes alterações:
Adicione o seguinte usando as instruções na parte superior do
Startup.cs
:Modifique a função
Configure
. Adicione umILoggerFactory loggerFactory
e uma chamada paraloggerFactory.AddGoogle("YOUR-PROJECT-ID")
:Compile e execute o código no Visual Studio. Consulte as entradas de registro no recurso Global do Explorador de registros.
Opção 2: usar uma integração do Log4Net
Log4Net (em inglês) é uma biblioteca Apache que permite a emissão de log statements para uma variedade de destinos de saída.
Para iniciar o registro usando a integração do Log4Net, instale a biblioteca Google.Cloud.Logging.Log4Net com este comando:
PM> Install-Package Google.Cloud.Logging.Log4Net
Em seguida, faça o seguinte:
Adicione uma seção de configuração XML do Log4Net ao arquivo
Web.config
do aplicativo da Web contendo o seguinte código:Adicione a seguinte linha de código ao arquivo Global.asax.cs (em inglês) do aplicativo para configurar o Log4net e usar o Logging:
log4net.Config.XmlConfigurator.Configure();
Depois de adicionar a linha anterior ao código, altere o método
Application_Start()
emGlobal.asax.cs
para o seguinte:Para usar o log4net no código do aplicativo, adicione a seguinte instrução para incluir a biblioteca de cliente:
using log4net;
Adicione o código a seguir ao aplicativo para gravar registros que serão exibidos no recurso Global do Explorador de registros. O nome do registro é especificado no arquivo
Web.config
:Compile e execute o código no Visual Studio. Consulte as entradas de registro no Visualizador de registros do Logging no recurso Global.
Opção 3: gravar registros personalizados usando a API Logging
Também é possível gravar registros personalizados chamando diretamente a API Cloud Logging.
Para iniciar o registro usando o Google.Cloud.Logging.V2, instale a biblioteca com um destes comandos:
Administrador de pacotes
PM> Install-Package Google.Cloud.Logging.V2
CLI do .NET
> dotnet add package Google.Cloud.Logging.V2
Depois que o cliente do Logging estiver instalado, será possível começar a enviar os registros do aplicativo para o Logging adicionando as seguintes instruções ao código do aplicativo:
using Google.Cloud.Logging.V2;
using Google.Cloud.Logging.Type;
using Google.Cloud.Api;
Personalize o seguinte método e o adicione ao código do aplicativo:
Escreva algum código de geração de registros que chame WriteLogEntry()
. A entrada de registro resultante
estará no recurso Global do Explorador de registros:
Acessar o Explorador de registros
Para mais detalhes sobre o Explorador de registros, consulte Como usar o Explorador de registros.