Tutorial: Verwenden von Amazon Logging Frameworks mit AWS Lambda zum Erstellen von Anwendungsprotokollen

Sie können Amazon CloudWatch Logs verwenden, um die Protokolle Ihrer Anwendung zu überwachen, zu speichern und darauf zuzugreifen. Um Protokolldaten in CloudWatch Logs zu übernehmen, verwenden Sie ein AWS SDK oder installieren Sie den CloudWatch Logs-Agenten, um bestimmte Protokollordner zu überwachen. CloudWatch Logs ist in mehrere gängige.NET-Logging-Frameworks integriert und vereinfacht so Arbeitsabläufe.

Um mit der Arbeit mit CloudWatch Logs und .NET-Logging-Frameworks zu beginnen, fügen Sie Ihrer Anwendung das entsprechende NuGet Paket und die CloudWatch Logs-Ausgabequelle hinzu und verwenden Sie dann Ihre Logging-Bibliothek wie gewohnt. Auf diese Weise kann Ihre Anwendung Nachrichten mit Ihrem .NET-Framework protokollieren, sie an CloudWatch Logs senden und die Protokollmeldungen Ihrer Anwendung in der CloudWatch Logs-Konsole anzeigen. Sie können in der CloudWatch Logs-Konsole auch Metriken und Alarme einrichten, die auf den Protokollnachrichten Ihrer Anwendung basieren.

Zu den unterstützten.NET-Protokollierungsframeworks gehören:

• NLog: Die Ansicht finden Sie im nuget.org NLog-Paket.

• Log4Net: Die Ansicht finden Sie im nuget.org Log4Net-Paket.

• ASP.NET Core Logging Framework: Eine Ansicht finden Sie im Nuget.org ASP.NET Core Logging Framework-Paket.

Im Folgenden finden Sie ein Beispiel für eine NLog.config Datei, die sowohl CloudWatch Logs als auch die Konsole als Ausgabe für Protokollnachrichten aktiviert, indem das AWS.Logger.NLog NuGet Paket und das Ziel hinzugefügt werden. AWS NLog.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>

Die Logging-Plugins bauen alle auf dem auf AWS SDK for .NET und authentifizieren Ihre AWS Anmeldeinformationen in einem Prozess, der dem SDK ähnelt. Im folgenden Beispiel werden die Berechtigungen beschrieben, die für das Logging-Plug-In für den Zugriff auf CloudWatch Logs erforderlich sind:

Anmerkung

Bei AWS den.NET-Logging-Plugins handelt es sich um ein Open-Source-Projekt. Weitere Informationen, Beispiele und Anweisungen finden Sie in den Abschnitten zu Beispielen und Anweisungen im AWS GitHubLogging.NET-Repository.

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