Quando siamo in produzione, dobbiamo sempre tenere sotto controllo lo stato di funzionamento della nostra applicazione ASP.NET Core: il server potrebbe non essere disponibile, o magari una delle dipendenze di cui essa necessita per funzionare potrebbe essere giù.
Un monitoring costante dello stato di salute del nostro sistema ci consente di reagire proattivamente a malfunzionamenti, invece che farlo a seguito di mail di protesta dei nostri utenti.
ASP.NET Core 2.2 introduce una funzionalità specifica per questa necessità denominata health check. Per sfruttarla dobbiamo eseguire semplicemente due passaggi nella classe Startup.
Il primo consiste nel configurare i servizi che vogliamo includere nella nostra pipeline. La configurazione minima è quella nel codice in basso:
public void ConfigureServices(IServiceCollection services) { // .. altro codice qui .. services.AddHealthChecks(); }
La configurazione dell'esempio ritornerà un successo se il server è vivo e in grado di rispondere alla richiesta. Tipicamente però, questo non è abbastanza: vogliamo verificare anche che siamo in grado di connetterci al database, alla cache distribuita o a un servizio secondario.
Per queste necessità, può essere utile sfruttare una serie di package - non ufficialmente distribuiti da Microsoft - pubblicati in questo repository GitHub: https://github.com/Xabaril/AspNetCore.Diagnostics.HealthChecks .
Per esempio, se tra le nostre dipendenze abbiamo un database SQL Server, non dobbiamo far altro che aggiungere il package
Install-Package AspNetCore.HealthChecks.SqlServer
e modificare il codice precendente in:
public void ConfigureServices(IServiceCollection services) { // .. altro codice qui .. services.AddHealthChecks() .AddSqlServer(myConnectionString); }
In questo modo, il codice di HealthCheck proverà a connettersi al database e a eseguire una semplice query - eventualmente configurabile.
Una volta configrati i servizi, dobbiamo registrare il middleware per invocarli, tramite il metodo UseHealthCheck al quale dobbiamo passare l'URL su cui vogliamo esporre questa funzionalità. Tutto ciò va ovviamente fatto all'interno del metodo Configure della classe Startup:
public void Configure(IApplicationBuilder app, IHostingEnvironment env) { // .. altro codice qui .. app.UseHealthChecks("/healthz"); app.UseMvc(); }
A questo punto, provando a invocare l'URL che abbiamo specificato, otterremo uno Status Code 200 nel caso in cui tutto funzioni per il meglio. Diversamente, lo stato sarà un 503 - Service Unavailable.
Possiamo poi impostare un Availability Check su Application Insights, per esempio, per far in modo che Azure invochi regolarmente questo endpoint e ci invii un alert nel caso di troppi errori consecutivi: https://docs.microsoft.com/en-us/azure/azure-monitor/app/monitor-web-app-availability
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Creare alias per tipi generici e tuple in C#
Migrate and Modernize your .NET Applications on Azure
.NET Conference Italia 2023
Miglioramenti nell'accessibilità con Angular CDK
Utilizzare gli snapshot con Azure File shares
Utilizzare database e servizi con gli add-on di Container App
Autenticarsi in modo sicuro su Azure tramite GitHub Actions
Filtrare e rimuovere gli elementi dalla cache del browser tramite le API JavaScript
Reactive form tipizzati con FormBuilder in Angular
Verificare la provenienza di un commit tramite le GitHub Actions
Eseguire una query su SQL Azure tramite un workflow di GitHub
Ottimizzazione dei block template in Angular 17