Seq ASP.NET-loggerointia varten - Tracing SerilogTracingin avulla (Suomi (Finnish))

Seq ASP.NET-loggerointia varten - Tracing SerilogTracingin avulla

Saturday, 31 August 2024

//

6 minute read

Esitys

Edellä esitin teille, miten oma hosting Seqille ASP.NET Coren avulla . Nyt kun se on otettu käyttöön, ' aika käyttää sitä enemmän, M SK2 ominaisuudet mahdollistavat täydellisemmän merkinnän, & jäljittäminen käyttämällä uutta Seq-esitystä,

Jälkiyttäminen

Tracing on like logging++ se antaa teille ylimääräisen kerroksen tietoa siitä, mitä omassa sovelluksessanne tapahtuu ' se on erityisen hyödyllinen, kun olette jakautunut järjestelmässä ja tarvitsette jäljittää pyynnön useiden palvelujen kautta Tässä sivustossa käytän sitä tapahtumien selvittämiseen nopeasti, koska tämä on huvi-sivusto ei tarkoita, että luopuisin ammattitaitoisista vaatimuksistani.

Serilogin käyttöönotto

Serilogin jäljittämisjärjestelmän käyttöönotto on varsin yksinkertaista käyttämällä Serilogin jäljittäminen paketti. Ensinnäkin on otettava käyttöön paketit

Siihen lisätään myös Konsolin ja Seq:n polttoalus.

dotnet add package SerilogTracing
dotnet add package SerilogTracing.Expressions
dotnet add package Serilog.Sinks.Console
dotnet add package Serilog.Sinks.Seq

Konsoli on aina hyödyllinen parannuskeinojen tekemiseksi, ja Seq on se, mitä me täällä teemme.

  "Serilog": {
    "Enrich": ["FromLogContext", "WithThreadId", "WithThreadName", "WithProcessId", "WithProcessName", "FromLogContext"],
    "MinimumLevel": "Warning",
    "WriteTo": [
        {
          "Name": "Seq",
          "Args":
          {
            "serverUrl": "http://seq:5341",
            "apiKey": ""
          }
        },
      {
        "Name": "Console"
      },
      {
        "Name": "File",
        "Args": {
          "path": "logs/applog-.txt",
          "rollingInterval": "Day"
        }
      }

    ],
    "Properties": {
      "ApplicationName": "mostlylucid"
    }
  }

Näiden rikastajien käyttämiseksi on lisättävä ne omaan Serilog kokoonpanossanne appsettings.json file. Teidän on myös installoitava kaikki erilliset rikastajat Nugetin avulla

Se' on yksi Serilogin hyvistä ja huonoista seikoista, kun otetaan huomioon, että loppujen lopuksi asennetaan pakettien Yhteinen BUNCH, mutta se tarkoittaa sitä, että lisätään vain se, mitä tarvitsette eikä vain yksi monolittinen paketti. Here's mine

Serilogin rikastajat

Kun kaikki nämä pommitetaan, sanon melko hyvän logituloksen Seq.

Serilog Seq-virhe

Tältä osin näette virheselvityksen, etenemispisteen, etänumeron , prosessin numeron ja prosessin niminM SK3 Nämä ovat kaikki hyödyllisiä tietoja, kun pyritätte jäljittämään ongelmaa.

On syytä panna merkille, että I' on asettanut "MinimumLevel": "Warning", omassa appsettings.json file. Tämä merkitsee, että vain varoitukset ja edellä olevat merkitään pöytäkirjaan Seq.

Seq-järjestelmässä voi kuitenkin myös täsmentää tämä Api-kysymyksenä;, joten on mahdollista Information ( tai jos olette todella innostuneita Debug) tallennetaan täällä ja rajoitetaan sitä, mitä Seq itse asiassa saisi API-kysymyksen avulla.

Seq Api-kysymys

Huomautus: teillä on vielä app overhead M SK1 voitte myös tehdä siitä dynaamisempi, jotta voitte mukauttaa tasoa lennolle Seq-säkki Lisätietoja.

{
    "Serilog":
    {
        "LevelSwitches": { "$controlSwitch": "Information" },
        "MinimumLevel": { "ControlledBy": "$controlSwitch" },
        "WriteTo":
        [{
            "Name": "Seq",
            "Args":
            {
                "serverUrl": "http://localhost:5341",
                "apiKey": "yeEZyL3SMcxEKUijBjN",
                "controlLevelSwitch": "$controlSwitch"
            }
        }]
    }
}

Jälkiyttäminen

Nyt lisäämme uudelleen jäljittämismenetelmän Serilogin avulla' on varsin yksinkertainen. meillä on sama järjestelmä kuin aikaisemmin, mutta lisäämme uuden jäljitettämiseen tarkoitetun pyyhkinän

dotnet add package SerilogTracing
dontet add package SerilogTracing.Expressions
dotnet add SerilogTracing.Instrumentation.AspNetCore

Lisäksi lisäämme lisäpaketin yksityiskohtaisempien aspnet core-tietojen rekisteröimiseksi.

Järjestelmä Program.cs

Nyt voimme todellakin alkaa käyttää jäljitystä. Ensinnäkin meidän on lisättävä jäljitettä Program.cs asiakirja.

    using var listener = new ActivityListenerConfiguration()
        .Instrument.HttpClientRequests().Instrument
        .AspNetCoreRequests()
        .TraceToSharedLogger();

Tracing-järjestelmässä käytetään käsitettä 'YrityksetM SK1, jotka edustavat työyksikköä . Te voitte aloittaa toiminnan, tehdä jotain työtä ja sitten lopettaa senMSC4 Tämä on hyödyllistä pyynnön seurannassa useiden palvelujen välityksellä

Tässä tapauksessa lisätään ylimääräinen jäljite HttpClient- ja AspNetCore-pyyntöjen osalta. TraceToSharedLogger , joka tallentaa toimintonsa samaan tallentajaan kuin muu järjestelmämme

Vertailupalvelussa

Nyt meillä on jäljittämisjärjestelmä, jonka voimme alkaa käyttää omassa sovelluksessamme.

    public async Task<PostListViewModel> GetPostsByCategory(string category, int page = 1, int pageSize = 10,
        string language = MarkdownBaseService.EnglishLanguage)
    {
        using var activity = Log.Logger.StartActivity("GetPostsByCategory {Category}, {Page}, {PageSize}, {Language}",
            new { category, page, pageSize, language });
        try
        {
            var count = await NoTrackingQuery()
                .Where(x => x.Categories.Any(c => c.Name == category) && x.LanguageEntity.Name == language)
                .CountAsync();
            var posts = await PostsQuery()
                .Where(x => x.Categories.Any(c => c.Name == category) && x.LanguageEntity.Name == language)
                .OrderByDescending(x => x.PublishedDate.DateTime)
                .Skip((page - 1) * pageSize)
                .Take(pageSize)
                .ToListAsync();

            var languages = await GetLanguagesForSlugs(posts.Select(x => x.Slug).ToList());
            var postListViewModel = new PostListViewModel
            {
                Page = page,
                PageSize = pageSize,
                TotalItems = count,
                Posts = posts.Select(x => x.ToListModel(
                    languages.FirstOrDefault(entry => entry.Key == x.Slug).Value.ToArray())).ToList()
            };
            activity.Complete();
            return postListViewModel;
        }
        catch (Exception e)
        {
            activity.Complete(LogEventLevel.Error, e);
        }

        return new PostListViewModel();
    }

Tärkeimmät linjat ovat::

  using var activity = Log.Logger.StartActivity("GetPostsByCategory {Category}, {Page}, {PageSize}, {Language}",
            new { category, page, pageSize, language });

Tämä käynnistää uuden 'aktiivisuuden', joka on työyksikköM SK2 Se ' on hyödyllinen pyynnön seuraamiseksi useiden palvelujen välityksellä Koska se on kätketty käyttämisessä olevaan lausuntoon, se täydentää ja hävittää menetelmämme lopussa, mutta on hyvä käytäntö täydentää se nimenomaisesti.

            activity.Complete();

Poikkeuksia käsittelevässä pyynnössämme täydennämme myös toimintoa, mutta virhetasolla ja poikkeuksella.. Tämä on hyödyllistä soveltamisenne ongelmien selvittämiseksi.

Tracesin käyttö

Nyt meillä on kaikki tämä järjestelmä, jonka voimme aloittaa käyttämällä.

Http-jälje

Tämä osoittaa käännöksen yhdestä merkitsevästä postista. Voit nähdä yksittäisen postin useat vaiheet sekä kaikki HttpClient-pyynnöt ja aikataulut.

Huomautan, että käytän Postgres-järjestelmää tietokantaani, toisin kuin SQL-Serverissä, npgsql-ohjelmaattorilla on alkuperäinen tuki jäljitettämiselle, joten voitte saada erittäin hyödyllisiä tietoja tietokannastanne SQL: n avulla suoritetuista kysymyksistä.

  "@t": "2024-08-31T15:23:31.0872838Z",
"@mt": "mostlylucid",
"@m": "mostlylucid",
"@i": "3c386a9a",
"@tr": "8f9be07e41f7121cbf2866c6cd886a90",
"@sp": "8d716c5f01ad07a0",
"@st": "2024-08-31T15:23:31.0706848Z",
"@ps": "622f1c86a8b33304",
"@sk": "Client",
"ActionId": "91f5105d-93fa-4e7f-9708-b1692e046a8a",
"ActionName": "Mostlylucid.Controllers.HomeController.Index (Mostlylucid)",
"ApplicationName": "mostlylucid",
"ConnectionId": "0HN69PVEQ9S7C",
"ProcessId": 30496,
"ProcessName": "Mostlylucid",
"RequestId": "0HN69PVEQ9S7C:00000015",
"RequestPath": "/",
"SourceContext": "Npgsql",
"ThreadId": 47,
"ThreadName": ".NET TP Worker",
"db.connection_id": 1565,
"db.connection_string": "Host=localhost;Database=mostlylucid;Port=5432;Username=postgres;Application Name=mostlylucid",
"db.name": "mostlylucid",
"db.statement": "SELECT t.\"Id\", t.\"ContentHash\", t.\"HtmlContent\", t.\"LanguageId\", t.\"Markdown\", t.\"PlainTextContent\", t.\"PublishedDate\", t.\"SearchVector\", t.\"Slug\", t.\"Title\", t.\"UpdatedDate\", t.\"WordCount\", t.\"Id0\", t0.\"BlogPostId\", t0.\"CategoryId\", t0.\"Id\", t0.\"Name\", t.\"Name\"\r\nFROM (\r\n    SELECT b.\"Id\", b.\"ContentHash\", b.\"HtmlContent\", b.\"LanguageId\", b.\"Markdown\", b.\"PlainTextContent\", b.\"PublishedDate\", b.\"SearchVector\", b.\"Slug\", b.\"Title\", b.\"UpdatedDate\", b.\"WordCount\", l.\"Id\" AS \"Id0\", l.\"Name\", b.\"PublishedDate\" AT TIME ZONE 'UTC' AS c\r\n    FROM mostlylucid.\"BlogPosts\" AS b\r\n    INNER JOIN mostlylucid.\"Languages\" AS l ON b.\"LanguageId\" = l.\"Id\"\r\n    WHERE l.\"Name\" = @__language_0\r\n    ORDER BY b.\"PublishedDate\" AT TIME ZONE 'UTC' DESC\r\n    LIMIT @__p_2 OFFSET @__p_1\r\n) AS t\r\nLEFT JOIN (\r\n    SELECT b0.\"BlogPostId\", b0.\"CategoryId\", c.\"Id\", c.\"Name\"\r\n    FROM mostlylucid.blogpostcategory AS b0\r\n    INNER JOIN mostlylucid.\"Categories\" AS c ON b0.\"CategoryId\" = c.\"Id\"\r\n) AS t0 ON t.\"Id\" = t0.\"BlogPostId\"\r\nORDER BY t.c DESC, t.\"Id\", t.\"Id0\", t0.\"BlogPostId\", t0.\"CategoryId\"",
"db.system": "postgresql",
"db.user": "postgres",
"net.peer.ip": "::1",
"net.peer.name": "localhost",
"net.transport": "ip_tcp",
"otel.status_code": "OK"

Voidaan nähdä, että tähän sisältyy lähes kaikki se, mitä tarvitsette tietää kysymyksestä, SQL:n täytäntöönpanoa koskevasta tiedonannosta , yhteysstringiä ja niin edelleen. Nämä ovat kaikki hyödyllisiä tietoja, kun olette yrittämässä jäljittää ongelmaa.

Päätelmissä

Olen osoittanut, miten yksinkertaista on päästä yksinkertaiseen jäljittämiseen Seq:n avulla.

Finding related posts...
logo

© 2026 Scott Galloway — Unlicense — All content and source code on this site is free to use, copy, modify, and sell.