Graylog: Naudojimas su Dot NET

Kaip siųsti žurnalus iš .NET/Serilog į Graylog

👋 Sveiki atvykę į Stackhero dokumentaciją!

Stackhero siūlo paruoštą naudoti Graylog cloud sprendimą, kuris suteikia daugybę privalumų, įskaitant:

  • Įtrauktas neribotas ir dedikuotas SMTP el. pašto serveris.
  • Lengvi atnaujinimai vienu paspaudimu.
  • Pritaikomas domeno vardas, apsaugotas HTTPS (pavyzdžiui, https://logs.jusu-imone.com).
  • Optimali veikla ir tvirta sauga, užtikrinta privačia ir dedikuota VM.

Taupykite laiką ir supaprastinkite savo gyvenimą: tereikia 5 minučių, kad išbandytumėte Stackhero Graylog cloud hosting sprendimą!

Serilog yra populiari ir lengvai išplečiama žurnalų (logging) biblioteka, plačiai naudojama .NET aplikacijose žurnalų valdymui. Ji leidžia programuotojams konfigūruoti įvairius „sink“ (išvesties taškus) žurnalų saugojimui ir vizualizavimui.

Štai paprastas pavyzdys, kaip naudoti Serilog:

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

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

Norėdami siųsti žurnalus į Graylog serverį, galite naudoti serilog-sinks-graylog paketą. Šis sink leidžia perduoti žurnalus GELF formatu tiesiai į Graylog.

  1. Įdiekite paketą:

    Pridėkite serilog-sinks-graylog paketą prie savo projekto vykdydami šią komandą:

    Install-Package serilog.sinks.graylog
    
  2. Konfigūruokite Serilog darbui su Graylog:

    Atnaujinkite savo aplikacijos konfigūraciją šiuo kodo fragmentu. Pakeiskite <XXXXXX>.stackhero-network.com į savo Graylog instancijos domeną:

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

    • Prisijunkite prie savo Graylog valdymo skydelio.
    • Eikite į System > Inputs.
    • Sukurkite naują input tipo "GELF UDP".
    • Paspauskite "Launch new input". Atsidariusiame lange pažymėkite "Global" parinktį, suteikite input pavadinimą ir išsaugokite nustatymus nekeisdami kitų parametrų.

Siekiant didesnio saugumo, rekomenduojama apriboti IP adresus, kurie gali jungtis prie 12201 porto. Tai galite sukonfigūruoti Stackhero valdymo skydelyje pasirinkę savo Graylog paslaugą ir tvarkydami "Firewall" nustatymus, kad leistumėte prisijungti tik konkretiems IP adresams.

Vadovaudamiesi šiais žingsniais, galėsite užtikrintai ir efektyviai siųsti savo .NET aplikacijos žurnalus į savo Graylog instanciją.