Tutoriel : Utilisation d'Amazon Logging Frameworks AWS Lambda pour créer des journaux d'applications

Vous pouvez utiliser Amazon CloudWatch Logs pour surveiller, stocker et accéder aux journaux de votre application. Pour transférer les données des CloudWatch journaux dans Logs, utilisez un AWS SDK ou installez l'agent CloudWatch Logs pour surveiller certains dossiers de journaux. CloudWatch Logs est intégré à plusieurs frameworks de journalisation .NET populaires, ce qui simplifie les flux de travail.

Pour commencer à travailler avec CloudWatch Logs et les frameworks de journalisation .NET, ajoutez le NuGet package et la source de sortie CloudWatch Logs appropriés à votre application, puis utilisez votre bibliothèque de journalisation comme vous le feriez normalement. Cela permet à votre application de consigner les messages avec votre framework .NET, de les envoyer à CloudWatch Logs, d'afficher les messages de journal de votre application dans la console CloudWatch Logs. Vous pouvez également configurer des métriques et des alarmes à partir de la console CloudWatch Logs, en fonction des messages de journal de votre application.

Les frameworks de journalisation .NET pris en charge incluent :

• NLog : pour le consulter, consultez le package NLog de nuget.org.

• Log4net : Pour le voir, consultez le package Log4net nuget.org.

• Framework de journalisation ASP.NET Core : pour le voir, consultez le package nuget.org ASP.NET Core logging Framework.

Voici un exemple de NLog.config fichier qui active à la fois les CloudWatch journaux et la console comme sortie pour les messages de journal en y ajoutant le AWS.Logger.NLog NuGet package et la AWS cibleNLog.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>

Les plugins de journalisation sont tous basés sur AWS SDK for .NET et authentifient vos AWS informations d'identification selon un processus similaire au SDK. L'exemple suivant détaille les autorisations requises par les informations d'identification du plugin de journalisation pour accéder aux CloudWatch journaux :

Note

Les plugins de journalisation AWS .NET sont un projet open source. Pour obtenir des informations, des exemples et des instructions supplémentaires, consultez les rubriques relatives aux exemples et aux instructions du GitHub référentiel AWS Logging .NET.

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