Tutorial: Usando o Amazon Logging Frameworks AWS Lambda para criar registros de aplicativos

Você pode usar o Amazon CloudWatch Logs para monitorar, armazenar e acessar os registros do seu aplicativo. Para inserir dados de registro no CloudWatch Logs, use um AWS SDK ou instale o agente do CloudWatch Logs para monitorar determinadas pastas de registro. CloudWatch O Logs é integrado a várias estruturas populares de registro do.NET, simplificando os fluxos de trabalho.

Para começar a trabalhar com estruturas de registro de CloudWatch registros e do.NET, adicione o NuGet pacote apropriado e a fonte de saída de CloudWatch registros ao seu aplicativo e, em seguida, use sua biblioteca de registros normalmente. Isso permite que seu aplicativo registre mensagens com sua estrutura do.NET, enviando-as para o CloudWatch Logs e exibindo as mensagens de registro do seu aplicativo no console do CloudWatch Logs. Você também pode configurar métricas e alarmes no console de CloudWatch registros, com base nas mensagens de registro do seu aplicativo.

As estruturas de registro do.NET suportadas incluem:

• NLog: para ver, consulte o pacote nuget.org NLog.

• Log4net: Para ver, consulte o pacote nuget.org Log4net.

• Estrutura de registro do ASP.NET Core: para ver, consulte o pacote nuget.org ASP.NET Core logging Framework.

Veja a seguir um exemplo de um NLog.config arquivo que habilita o CloudWatch Logs e o console como saída para mensagens de log adicionando o AWS.Logger.NLog NuGet pacote e o AWS destino emNLog.config.

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      throwExceptions="true">
  <targets>
    <target name="aws" type="AWSTarget" logGroup="NLog.ConfigExample" region="us-east-1"/>
    <target name="logfile" xsi:type="Console" layout="${callsite} ${message}" />
  </targets>
  <rules>
    <logger name="*" minlevel="Info" writeTo="logfile,aws" />
  </rules>
</nlog>

Os plug-ins de registro são todos criados com base no AWS SDK for .NET e autenticam suas AWS credenciais em um processo semelhante ao SDK. O exemplo a seguir detalha as permissões exigidas pelas credenciais do plug-in de registro para acessar o CloudWatch Logs:

nota

Os plug-ins de registro AWS do.NET são um projeto de código aberto. Para obter mais informações, exemplos e instruções, consulte os tópicos de exemplos e instruções no GitHubrepositório.NET do AWS Logging.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogGroups"
      ],
      "Resource": [
        "arn:aws:logs:*:*:*"
      ]
    }
  ]
}