This is a viewer only at the moment see the article on how this works.
To update the preview hit Ctrl-Alt-R (or ⌘-Alt-R on Mac) or Enter to refresh. The Save icon lets you save the markdown file to disk
This is a preview from the server running through my markdig pipeline
Pollyn käyttäminen eläkkeelle jäämiseen
Sunday, 15 September 2024
Esitys
Polly on keskeinen osa jokaista .NETin kehittäjää'työkalupakettiaM SK2 Se on kirjasto, jonka avulla voidaan määritellä poikkeuksia ja toistuksia koskevat politiikat ohjelmissanne. I Pollyn käyttäminen uudelleenkäsittelyyn tässä sovelluksessa.
Polly
Vaikka Polly toimiikin todella hyvin, se ei ole kaikki, mitä se voi tehdä.
Ne on otettu Polly -sivut ja ovat tärkeimpiä malleja, joita voidaan käyttää Pollyn kanssa:
- Yritä uudelleen: Yritä uudestaan, jos jokin menee pieleen. Tämä voi olla hyödyllistä, kun ongelma on väliaikainen ja saattaa hävitä
- Circuit Breaker: Lopettakaa yrittäminen, jos jokin on hajoutunut tai työläs. Tämä voi olla hyödyllistä säästämällä aikaa ja huonontamalla tilannettaM SK2 Se voi myös tukea järjestelmää palauttaa
- Aikarajoitus: luovutkaa, jos jokin kestää liian kauanM SK1 Tämä voi parantaa suorituskykyänne vapauttamalla tilaa ja resursseja.
- Hintojen rajoittaja: rajoittaa, kuinka monta pyyntöä teette tai hyväksytteM SK1 Tämä voi auttaa hallinnoimaan lastausta ja estämään ongelmat tai rangaistukset.
- Fallback: Tehkää jotain muuta, jos jokin epäonnistuuM SK1 Tämä voi parantaa käyttäjäkokemustanne ja pitää ohjelman toiminnassa. Hedging: Tehdään enemmän kuin yksi asia samaan aikaan ja otetaan kaikkein nopein yksiM SK1 Tämä voi tehdä ohjelmastanne nopeamman ja reagoivamman
Miten käytän Pollyä
Tässä sovellutuksessa käytän Pollya monissa kohdissa.
BackgroundTranslateService
Jotta voin aloittaa käännöspalveluni ja tarkistaa, ovatko EasyNMT-serverit käytettävissä. Thsi antaa minulle mahdollisuuden tarkistaa palvelun saatavuutta ennen kuin aloitan M SK1offer' käännösluonnoksessani olevan käännöksenpalvelun Esittäjäni 'toyM SK1 , jotta voisitte kääntää merkkiä alas ja 'on the flyM SK1 -ni blogien kääntäminen. Näin ollen se, ', on ratkaisevan tärkeä. Tarkastelen, ettei EasyNMT-järjestelmä ole heikentynyt.
private async Task StartupHealthCheck(CancellationToken cancellationToken)
{
var retryPolicy = Policy
.HandleResult<bool>(result => !result) // Retry when Ping returns false (service not available)
.WaitAndRetryAsync(3, // Retry 3 times
attempt => TimeSpan.FromSeconds(5), // Wait 5 seconds between retries
(result, timeSpan, retryCount, context) =>
{
logger.LogWarning("Translation service is not available, retrying attempt {RetryCount}", retryCount);
});
try
{
var isUp = await retryPolicy.ExecuteAsync(async () =>
{
return await Ping(cancellationToken); // Ping to check if the service is up
});
if (isUp)
{
logger.LogInformation("Translation service is available");
TranslationServiceUp = true;
}
else
{
logger.LogError("Translation service is not available after retries");
await HandleTranslationServiceFailure();
TranslationServiceUp = false;
}
}
catch (Exception ex)
{
logger.LogError(ex, "An error occurred while checking the translation service availability");
await HandleTranslationServiceFailure();
TranslationServiceUp = false;
}
}
Kuten näette, olemme ottaneet käyttöön Pollyn uudelleenpyynnön politiikan, joka yrittää uudelleen 3 kertaa ja odottaa toisensa jälkeen 5- sekuntia jokaisen uudelleenpyynnön välisenä aikana. TranslationServiceUp lippu väärään. Näin kaikki käännöspalvelua käyttävät palvelut tietävät, että se ei ole saatavilla.
graph LR
A[Start Health Check] --> B[Define Retry Policy]
B --> C[Retry Policy: Retry 3 times]
C --> D[Wait 5 seconds between retries]
D --> E[Ping Translation Service]
E --> F{Ping successful?}
F -- Yes --> G[Log: Translation service is available]
G --> H[Set TranslationServiceUp = true]
F -- No --> I[Log: Translation service not available]
I --> J[Check retry count]
J -- Retry Limit Reached --> K[Log: Translation service not available after retries]
K --> L[HandleTranslationServiceFailure]
L --> M[Set TranslationServiceUp = false]
J -- Retry Again --> E
E --> N{Exception Occurs?}
N -- Yes --> O[Log: Error occurred]
O --> L
Umami.Net
Olen myös käyttänyt Pollyä Umamin .\Netin kirjastossani käsitelläkseni uudelleentarkastuksia Umami API:lle esittämissäni vaatimuksissa. \ . \ Tämä on keskeinen osa kirjastoa, koska se antaa minulle mahdollisuuden käsitellä kaikkia API-kysymyksiä ja tarvittaessa yrittää uudelleen tarkistuksen.
Siihen laadittiin HttpClient käyttää uudelleenkäynnistämistä koskevaa politiikkaa; tässä tapauksessa HttpStatusCode.ServiceUnavailable ja toistaa pyynnön, jos se tapahtuu. IM SK1m myös käyttäen Decorrelated Jitter Backoff on hyvä strategia, jota voidaan käyttää, koska se auttaa välttämään 'kaikkien asiakkaiden samanaikaista uudelleenkäynnin ongelmaa.
var httpClientBuilder = services.AddHttpClient<AuthService>(options =>
{
options.BaseAddress = new Uri(umamiSettings.UmamiPath);
})
.SetHandlerLifetime(TimeSpan.FromMinutes(5))
.AddPolicyHandler(RetryPolicyExtension.GetRetryPolicy());
public static IAsyncPolicy<HttpResponseMessage> GetRetryPolicy()
{
var delay = Backoff.DecorrelatedJitterBackoffV2(TimeSpan.FromSeconds(1), 3);
return HttpPolicyExtensions
.HandleTransientHttpError()
.OrResult(msg => msg.StatusCode == HttpStatusCode.ServiceUnavailable)
.WaitAndRetryAsync(delay);
}
Jälleentryynnistä koskeva politiikka HttpClient pyynnöt ovat tärkeä tapa parantaa luotettavuutta. Vaikka haluammekin ajatella, että web-palvelut ovat siellä aina saatavillaM SK1 on aina jonkin verran tautia ( minun tapauksessani esimerkiksi Valtuusasema havaitsee, että päivitys on odotettavissa ja käynnistää Umami-kuormituksen uudelleen). Näin ollen uudelleenkäynnin periaate voi auttaa varmistamaan, että sovelluksenne pystyy käsittelemään näitä tilanteita hienosti.
FileSystemWatcher
Toinen käyttötarkoitus, jonka teen Pollystä on, kun olen tekemisissä tiedostojen laadinnassa ja säilyttämisessä omassa sovelluksessani. käytän FileSystemWatcher valvoa luetteloa, jossa tallennetaan huomautuksiani sisältävät asiakirjat. Kun asiakirja luodaan tai saatetaan ajan tasalle, laadin sen ja käsittelen sitä . Voi olla ongelmallista, jos asiakirjaa kirjoitetaan edelleen siihen, kun tapahtumaa käynnistetään. RetryPolicy tilanteen hoitamiseen.
Tässä voitte nähdä, että käsittelen IOException , joka hylätään, kun asiakirja on käytössä ja yrittää uudelleen operaatio. käytän WaitAndRetryAsync politiikka uudelleenkäynnistettävästä operaatiosta 5 kertaa, joka viivästyy kunkin uudelleenkäynnön välillä . Tämä antaa minulle mahdollisuuden käsitellä tilannetta, jossa asiakirjaa kirjoitetaan edelleen, ja yrittää uudelleen operaatiota siihen saakka, kunnes se onnistuu
Ratkaisevaa tässä on se, että heitän 'up' IOException omalla SavePost menetelmä, joka antaa Pollyn politiikalle mahdollisuuden käsitellä uudelleentryä. Tämä on hyvä malli noudattaa, koska se antaa teille mahdollisuuden käsittää uudelleentry logiikka keskitetyssä paikassa eikä tarvitse olla huolissaan siitä kaikissa menetelmissä, jotka saattavat tarvita uudelleentryynnin operaatioon
Yleisesti aina käsitellä poikkeuksia, ja hylkääminen korkeammalle tasolle, jossa ne voidaan käsitellä keskitetymmin (tai tallentaa ne ). Tämä voi auttaa vähentämään kodin monimutkaisuutta ja helpottamaan poikkeusten johdonmukaista käsittelyä
private async Task OnChangedAsync(WaitForChangedResult e)
{
...
var retryPolicy = Policy
.Handle<IOException>() // Only handle IO exceptions (like file in use)
.WaitAndRetryAsync(5, retryAttempt => TimeSpan.FromMilliseconds(500 * retryAttempt),
(exception, timeSpan, retryCount, context) =>
{
activity?.Activity?.SetTag("Retry Attempt", retryCount);
// Log the retry attempt
logger.LogWarning("File is in use, retrying attempt {RetryCount} after {TimeSpan}", retryCount,
timeSpan);
});
...
// Use the Polly retry policy for executing the operation
await retryPolicy.ExecuteAsync(async () =>
{
...
var blogService = scope.ServiceProvider.GetRequiredService<IBlogService>();
await blogService.SavePost(blogModel);
...
});
...
}
Jälleen kerran tämä on esimerkki siitä, miten omalla koodillani on vuorovaikutus ulkoisen palvelun kanssa. SerilogTracing , joka lähettää ne Seqille, joka sen jälkeen lähettää minulle sähköpostin, kun errror on tallennettu, jotta voin tunnistaa kaikki ongelmat, jotka saattavat esiintyä.
Jälleen kerran, yleinen lähestymistapa on käsitellä poikkeuksia, joissa voitte, tallentaa ne, kun voitte't ja varmistaa, että teillä on tapa tietää, mitä on tapahtumassaM SK3This can help to ensure that your application is resilient and can handle any issues that might occur
E-postipalvelu
Käytän sähköpostipalvelussani sekä CircuitBreaker malli ja uudelleenkäynnin politiikka. uudelleenkäynnistämispolitiikkaa käytetään sellaisten tapausten käsittelyyn, joissa sähköpostipalvelu ei ole käytettävissä, ja kiertoesittäjää käytetään sellaiset tapaukset käsittelemiseen, joissa sähköinen sähköpostipalvelu on työskennelty tai liiallinen
Molemmat ovat tärkeitä sähköpostien tapauksessa; SMTP on suhteellisen hitaa ja mahdollisesti epäluotettava pöytäkirja.
Tässä käsittelen SmtpExceptions:ia, jossa, kun virhe tulee SMTP-palvelusta, se yrittää ensin uudelleen kolme kertaa ja viivästyy jokaisessa uudelleenkäynnissä. Jos palvelu ei ole vielä käytettävissä uudelleenkäynnin jälkeen, M SK2ja kaksi uutta lähetystä vartenMSC3 kiertoesitys avautuu ja lopettaa sähköpostien lähetyksen minuutin ajaksi . Tämä voi auttaa estämään sähköpostipalvelun ylilaadun SSK5 ja minun tilani on pysäytetty) sekä parantamaan mahdollisuutta lähettää sähköposti menestyksekkäästi
// Initialize the retry policy
var retryPolicy = Policy
.Handle<SmtpException>() // Retry on any exception
.WaitAndRetryAsync(3, // Retry 3 times
attempt => TimeSpan.FromSeconds(2 * attempt),
(exception, timeSpan, retryCount, context) =>
{
logger.LogWarning(exception, "Retry {RetryCount} for sending email failed", retryCount);
});
// Initialize the circuit breaker policy
var circuitBreakerPolicy = Policy
.Handle<SmtpException>()
.CircuitBreakerAsync(
5,
TimeSpan.FromMinutes(1),
onBreak: (exception, timespan) =>
{
logger.LogError("Circuit broken due to too many failures. Breaking for {BreakDuration}", timespan);
},
onReset: () =>
{
logger.LogInformation("Circuit reset. Resuming email delivery.");
},
onHalfOpen: () =>
{
logger.LogInformation("Circuit in half-open state. Testing connection...");
});
_policyWrap = Policy.WrapAsync(retryPolicy, circuitBreakerPolicy);
Tätä käytetään sitten sähköpostini lähettämisloopissa, jossa odotetaan, että kanavaan lisätään uusia viestejä ja sitten yritetään lähettää ne.
Tämä käyttää kaikkia wrapped-politiikassa olevia functioanlityjä lisätäkseen joustavuutta sähköpostin lähettämisprosessiin.
while (await _mailMessages.Reader.WaitToReadAsync(token))
{
BaseEmailModel? message = null;
try
{
message = await _mailMessages.Reader.ReadAsync(token);
// Execute retry policy and circuit breaker around the email sending logic
await _policyWrap.ExecuteAsync(async () =>
{
switch (message)
{
case ContactEmailModel contactEmailModel:
await _emailService.SendContactEmail(contactEmailModel);
break;
case CommentEmailModel commentEmailModel:
await _emailService.SendCommentEmail(commentEmailModel);
break;
}
});
_logger.LogInformation("Email from {SenderEmail} sent", message.SenderEmail);
}
catch (OperationCanceledException)
{
break;
}
catch (Exception exc)
{
_logger.LogError(exc, "Couldn't send an e-mail from {SenderEmail}", message?.SenderEmail);
}
}
Päätelmissä
Polly on tehokas kirjasto, joka voi auttaa lisäämään joustavuutta sovelluksissanne. Pollyn avulla voitte käsitellä uudelleenkäyntejä, putkien katkaisijoitaM SK2 taukojaMSC3 kurssirajoituksiaMST4 haittavaikutuksia ja suojaamista sovellusessanne MST5 Tämä voi auttaa varmistamaan, että sovelluksenne on luotettava ja että se pystyy käsittelemään mahdollisia ongelmia. Tässä kohdassa käsittelin oikeastaan vain yhtä Pollyn näkökohtaa: ;, retryt, ,, jotka voivat parantaa sovelluksenne kestävyyttä ja luotettavuutta.. Pollyn avulla voimme käsitellä retryjä johdonmukaisesti ja varmistaa, että sovellutteellanne voidaan käsitellä mahdollisia ongelmia.