Seq ASP.NET-loggerointia varten - Tracing SerilogTracingin avulla
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

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

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.

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ä.

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.