Graylog: Utilisation avec Dot NET

Comment envoyer des logs de .NET/Serilog vers Graylog

👋 Bienvenue sur la documentation de Stackhero !

Stackhero propose une solution Graylog cloud prête à l'emploi qui offre de nombreux avantages, notamment :

• Serveur SMTP d'e-mail dédié et illimité inclus.
• Mises à jour simplifiées en un clic.
• Nom de domaine personnalisable sécurisé par HTTPS (par exemple, https://logs.votre-entreprise.com).
• Performance optimale et sécurité renforcée grâce à une VM privée et dédiée.

Gagnez du temps et simplifiez-vous la vie : il suffit de 5 minutes pour essayer la solution Graylog cloud hosting de Stackhero !

Serilog est une bibliothèque de gestion des logs très populaire et hautement extensible, largement utilisée pour la gestion des logs dans les applications .NET. Elle permet aux développeurs de configurer différents sinks pour le stockage et la visualisation des logs.

Voici un exemple simple illustrant l'utilisation de Serilog :

var log = new LoggerConfiguration()
    .WriteTo.Console()
    .WriteTo.File("log.txt")
    .CreateLogger();

log.Information("Hello, Serilog!");

Pour envoyer des logs vers un serveur Graylog, vous pouvez utiliser le package serilog-sinks-graylog. Ce sink permet de transmettre les logs au format GELF directement à Graylog.

Etapes détaillées

1. Installer le package :

   Ajoutez le package serilog-sinks-graylog à votre projet en exécutant la commande suivante :

   Install-Package serilog.sinks.graylog
   

2. Configurer Serilog pour Graylog :

   Mettez à jour la configuration de votre application avec le code suivant. Remplacez <XXXXXX>.stackhero-network.com par le domaine de votre instance Graylog :

   var loggerConfig = new LoggerConfiguration()
       .WriteTo.Graylog(
           new GraylogSinkOptions
           {
               HostnameOrAddress = "<XXXXXX>.stackhero-network.com",
               Port = 12201
           }
       );
   

3. Configurer Graylog :

   • Connectez-vous à votre tableau de bord Graylog.
   • Rendez-vous dans System > Inputs.
   • Créez un nouvel input de type "GELF UDP".
   • Cliquez sur "Launch new input". Dans la fenêtre qui s'affiche, activez l'option "Global", donnez un nom à l'input, puis enregistrez sans modifier les autres paramètres.

Pour renforcer la sécurité, il est recommandé de restreindre les IP autorisées à se connecter au port 12201. Vous pouvez configurer cela depuis le tableau de bord Stackhero, en sélectionnant votre service Graylog, puis en gérant les paramètres du "Firewall" afin de n'autoriser que certaines IP.

En suivant ces étapes, vous permettez à votre application .NET d'envoyer ses logs de manière sécurisée et efficace vers votre instance Graylog.