Log client side su ASP.NET Core con JSNLog
Un sistema informatico solido deve avere come requisito uno strumento che permetta di registrare le operazioni dell'utente e del sistema in generale. Più le informazioni sono accurate e analizzabili e meglio il sistema potrà essere corretto in caso di errore o di deriva. Dopo una segnalazione di errore da parte del cliente o degli utenti, i dati presenti a sistema e il log, sono infatti le prime risorse cha abbiamo per diagnosticare il problema. Si tratta di informazioni preziose, tramite le quali possiamo ricostruire la casistica sui nostri sistemi e investigarne le cause.
Per far questo, è necessario verificare tutte le operazioni che l'utente ha eseguito prima dell'anomalia riscontrata. In ambito web, il problema più evidente è tracciare le informazioni lato client, ossia tutto ciò che l'utente esegue sul proprio browser. In passato abbiamo accennato a come ASP.NET Core fornisca un supporto out-of-the-box al log server side, ma ciò che accade sul browser oggi ha una complessità tale da richiedere un log specifico. In questo articolo ci occuperemo per l'appunto di questa esigenza, e mostreremo come soddisfarla grazie a JSNLog.
Introduzione a JSNLog
JSNLog è una libreria open source che può essere scaricata dalla pagina ufficiale o installata tramite NuGet. Essa ci consente di tracciare informazioni di log all'interno del codice JavaScript della pagina. Questi dati verranno successivamente inviati al server come richiesta AJAX, la quale verrà intercettata da un middleware OWIN specifico che si preoccupererà di memorizzare questi eventi in uno storage permanente. La figura in basso illustra il funzionamento di questi componenti.
Per la scrittura dei dati, il middleware di JSNLog si appoggia a un framework di logging server side, e fornisce il supporto alle più utilizzate librerie tra le quali: Elmah, Log4Net, NLog, Serilog e Common.Logging. Lo strumento può essere utilizzato su progetti web con infrastruttura ASP.NET e in particolare: WebForm, MVC, WebApi, e ASP.NET Core. Supportate anche le chiamate CORS.
Impostazione del progetto
Prima entrare nel dettaglio, descriviamo gli step per avere una applicazione ASP .NET Core MVC pronta per loggare client-side. Creiamo un progetto da Visual Studio 2017 di tipo ASP .NET Core e installiamo, tramite NuGet, il pacchetto richiesto per il progetto: JSNLog.AspNetCore.
Per abilitare gli script da utilizzare nelle pagine Razor dovremmo aggiungere i file JavaScript che reperiamo tramite Bower. Il pacchetto da installare si chiama jsnlog.
Questo pacchetto installa un file TypeScript, insieme al corrispondente JavaScript, all'interno della cartella mostrata nella figura in basso.
Per poterlo poi utilizzare, il passo successivo è quello di referenziarlo nella sezione head della view _Layout.cshtml:
<script src="~/lib/jsnlog.js/jsnlog.min.js"></script>
Attenzione: Questo articolo contiene un allegato.
Contenuti dell'articolo
Commenti
Per inserire un commento, devi avere un account.
Fai il login e torna a questa pagina, oppure registrati alla nostra community.
Approfondimenti
Visualizzare un template durante il caricamento di Virtualize in Blazor
Registrare un servizio generico nella dependency injection di ASP.NET Core
Creare un componente Button in Blazor per operazioni asincrone
Creare due extension method per serializzare un oggetto in JSON e viceversa utilizzando la libreria System.Text.Json
Un confronto tra React, Angular, Vue.js e Svelte
Cambiare automaticamente lo stato di un work item in una pipeline di Azure DevOps
Mappare l'ereditarietà di una gerarchia di oggetti usando il TPT in Entity Framework Core 5
Selezione e configurazione degli agent nelle pipeline di Azure DevOps
Eseguire lo shutdown pulito di un'applicazione ASP.NET Core
Usare domini personalizzati per Azure Storage tramite CDN
Creare automaticamente una relazione padre-figlio tra work item in Azure DevOps
Top Ten Articoli
- Abilitare e gestire il prerendering nelle applicazioni Blazor WebAssembly
di Marco De Sanctis - Realizzare una Progressive Web Application con Blazor e ASP.NET Core
di Giampaolo Tucci - Introduzione a Blazor WebAssembly
di Marco De Sanctis, Moreno Gentili - Utilizzare scene 3D in Windows Presentation Foundation
di Marco Leoncini - Introduzione a Windows Communication Foundation
di Stefano Mostarda - Anteprima di ASP.NET Core 3
di Moreno Gentili - Blazor e il pattern Model-View-ViewModel
di Giampaolo Tucci - Le novità di ASP.NET Core 5
di Marco De Sanctis - Usare gRPC come infrastruttura per i nostri servizi web
di Morgan Pizzini - Creare API GraphQL con ASP.NET Core e HotChocolate
di Moreno Gentili
Articoli via e-mail
Iscriviti alla nostra newsletter nuoviarticoli per ricevere via e-mail le notifiche!
In primo piano
I più letti di oggi
- ecco tutte le novità pubblicate sui nostri siti questa settimana: https://aspit.co/wkly buon week-end!
- Dimensionare le immagini e il layout con la proprietà CSS aspect-ratio
- Ottimizzare l'uso di memoria usando le static anonymous function in C#
- Eseguire processi multi-piattaforma con le pipeline YAML di Azure DevOps
- Usare le user-defined function con Azure Cosmos DB
In evidenza
- Il meglio della settimana
- Community Days 2021 - Online
- Ottimizzare l'uso di memoria usando le static anonymous function in C#
- Eseguire processi multi-piattaforma con le pipeline YAML di Azure DevOps
- Realizzare una Progressive Web Application con Blazor e ASP.NET Core
- Dimensionare le immagini e il layout con la proprietà CSS aspect-ratio
- Usare le user-defined function con Azure Cosmos DB
- Attivare la localizzazione in Blazor WebAssembly