Al tener aplicaciones en producción siempre es de suma importancia el poder monitorearlas. Monitorear una Net API tiene sus grandes beneficios y se ha convertido en un MUST al momento de yo manejar aplicaciones en ambientes de producción.
Saber como se comporta tu aplicación, que problemas de rendimiento tiene y hasta saber que errores genera es de very important importancia al operar un sistema. Siempre habrán errores y siempre habrá que arreglarlos. Hagamos que este proceso de debugging sea más sencillo para nosotros.
Como siempre, aquí encontrarás el código que aplica para este put up.
Software Insights es una herramienta que forma parte de la suite de Azure Monitor el cual provee de un Software Efficiency Administration y monitoreo para aplicaciones internet que están en producción o corriendo en vivo en Azure o en cualquier lado.
Builders o profesionales de DevOps pueden usar Software Insights para:
- Automáticamente detectar anomalías de efficiency
- Ayuda a diagnosticar problemas utilizando las herramientas de analytics
- Ver el comportamiento de los usuarios al usar la aplicación
- Ayuda a mejorar continuamente la usabilidad y el efficiency de la aplicación
Funcionalidades de Software Insights:
- Soporta una gran variedad de lenguajes de programación, como .NET, node.js, java y python
- Funciona en aplicaciones hospedadas en servidores on-premises, híbrido o en cualquier nube pública
- Se puede integrar con procesos de DevOps
- Se puede conectar con muchas herramientas de desarrollo (Energy BI, Alertas, Visible Studio, and so on)
- Puede monitorear y analizar la telemetría de aplicaciones móviles
¿Cómo funciona?
Para usar Software Insights debemos de instalar un pequeño paquete (el SDK) en la aplicación, en visible studio se pude hacer incluso automáticamente, pero lo haremos manualmente más adelante.
Podemos monitorear cualquier servicio internet o background service, incluso la parte de frontend con Javascript en una aplicación internet. Como mencioné antes, las aplicaciones no están obligadas a estar hosteadas en Azure para que se puedan analizar.
La instrumentación ocurre en distintos Threads y no bloquea cualquier llamada que se hace a la aplicación, por lo que el impacto en la aplicación es pequeño.
El siguiente diagrama muestra un ejemplo de como Software Insights monitorea la aplicación y manda la telemetría a AI.
¿Qué monitorea?
Software insights ayuda a los equipos de desarrollo a entender el uso y el efficiency de las aplicaciones, por lo que monitorea:
- Requests recibidos, tiempos de respuesta y fallas
- Podríamos saber cuales son los métodos más lentos, más usados y los que más fallan
- Todas las dependencias (bases de datos, servicios externos, storage accounts, redis, and so on)
- Excepciones
- Todos los errores que ocurren en la aplicación podemos analizarlos e incluso debuggear el reminiscence dump
- El frontend: visitas a las páginas, cuanto tardan en cargar y comportamiento de usuarios
- También llamadas de javascript (requests realizados, tiempo de respuesta y errores)
- Cantidad de usuarios y sesiones únicas
- Indicadores de efficiency, como el CPU, memoria y uso de la pink
- Diagnósticos del host, como docker o azure
- Hint logs de las apps, podemos hacer tracing de un request y ver como se ejecuto incluso si involucra distintos servicios
- En common customized occasions/logs y métricas que sirven para algún monitoring que el negocio requiera
Configurando Software Insights en ASP.NET Core
Realmente como mencioné antes, si usamos visible studio, podemos configurar utility insights de una forma automática, pero me gusta hacerlo manualmente para entender bien que se configura.
Nota 👀: Este put up sigue siendo una continuación de la serie de artículos sobre distintos temas de ASP.NET Core. Si no tienes la solución, no dudes en visitar el repositorio en GitHub por que aquí omitiré mucho código.
Comenzamos instalando los siguientes paquetes:
<PackageReference Embody="Microsoft.ApplicationInsights.AspNetCore" Model="2.20.0" />
<PackageReference Embody="Serilog.Sinks.ApplicationInsights" Model="3.1.0" />
Estos dos paquetes son el SDK de Software Insights y un Sink de Serilog. Serilog lo hemos configurado en este put up y es bien útil combinarlos con Software Insights.
Para comenzar a recolectar telemetría de nuestra aplicación y empezar a usarla, necesitamos crear un Software Insights en Azure. Es bien sencillo y realmente no pide información que se te pueda dificultar.
Lo importante, es tener los connection strings / instrumentation keys de un utility insights previamente creado:
Y la configuración es extremadamente sencilla, nos vamos a Program.cs y agregamos la siguiente línea:
// ... código omitido
builder.Host.UseSerilog();
// ... código omitido
builder.Companies.AddApplicationInsightsTelemetry(); // <------ this one
var app = builder.Construct();
// ... código omitido
Y agregamos la cadena de conexión en la configuración (appsettings.json o person secrets and techniques)
{
// Settings omitidos
"ApplicationInsights": {
"ConnectionString": "InstrumentationKey=<Instrumentation Key>;IngestionEndpoint=https://eastus-6.in.applicationinsights.azure.com/;LiveEndpoint=https://eastus.livediagnostics.monitor.azure.com/"
}
}
Así de fácil, ya podemos empezar a monitorear nuestra aplicación. En este punto se monitorea casi lo más importante pero hay algo que nos falta, los logs y las excepciones.
Si ejecutamos así la aplicación y la empezamos a usar, vamos a poder ver tiempos de respuesta, que solicitudes se hacen, si las solicitudes fallan (mostrando únicamente el HTTP Code) y los indicadores del servidor como el CPU, memoria, and so on.
Pero si recuerdan, al implementar CQRS y serilog, incluimos ya logs que nos pueden servir para el diagnostico de la aplicación si algo sale mal (los audit logs, las excepciones y entre otras cosas).
Por lo que, siempre recomendaré, es aprovechar el Sink de Serilog para complementar esta herramienta.
Configurarlo, es igual de fácil. En Program.cs actualizamos:
Log.Logger = new LoggerConfiguration()
.MinimumLevel.Override("Microsoft", LogEventLevel.Warning)
.Enrich.FromLogContext()
.WriteTo.Console()
.WriteTo.ApplicationInsights(app.Companies.GetRequiredService<TelemetryConfiguration>(), TelemetryConverter.Traces) // <--- this one
.WriteTo.File("log.txt", rollingInterval: RollingInterval.Day)
.CreateLogger();
Anteriormente ya teníamos configurado Serilog, por lo que solamente resta agregar el Sink a Software Insights que incluso ya instalamos al inicio de este put up.
Lo que estamos diciendo aquí es, que todos los Logs que son generados por la aplicación, los guarde en Software Insights como del tipo Traces. Ya sean Info, Warning. Los Error / Exceptions serán del tipo Exception en Software Insights. Esto es bien tremendous útil, por que nos permitirá ver traces de esta forma:
Ya que previamente en nuestra aplicación, hemos configurado que se haga Logs de los errores, esto lo hacemos aquí implementando unos ExceptionFilters.
Si exploramos un request, podemos ver todo bien detallado:
Esto, es esencial, créanme, necesitan esto en sus aplicaciones en producción
Siempre va a salir algo mal, necesitamos las herramientas para investigar que sucede en nuestra aplicación.
En mi Stack, utility insights ha venido para quedarse.
Nota 👀: Existen otras herramientas para hacer esto mismo, pero dado a que yo soy Azure Based mostly, esto me funciona al 100%. Open Telemetry y proyectos como Prometheus o Jeager ayudan bastante en esta misma tarea.
En resumen, con utility insights en una Net Api podemos monitorear:
Todas las operaciones realizadas
Cuanto tardan las dependencias
Indicadores del servidor
Métricas en tiempo actual
Este es de los que son más útiles para mi, al intentar reproducir errores, podemos ver los logs en tiempo actual.
Gracias a serilog, nos facilita la vida y manda los logs según lo configuremos.
Message Templates
En el put up de Serilog, mencioné la importancia de crear Message Templates en los logs y no “concatenar” strings en los logs. La razón de que es mejor usar message templates es por la generación de esta telemetría. Un Message Template se puede visualizar de esta forma:
El Message es lo que nosotros vemos en consola, pero todos esos Customized Properties nos ayudan incluso a buscar mejor según necesitemos. Aquí podríamos buscar por RequestName, Consumer o algún dato en el Request.
Búsqueda por Customized Properties
El beneficio actual de usar los Message Templates y que Serilog los mande como Customized Properties, está al hacer búsqueda en los logs.
Software Insights nos deja hacer Queries con un lenguaje especial de Azure. Saber esto es bien útil, porque podemos automatizar muchas cosas (como generar alertas).
Si consultamos las operaciones realizadas por un usuario, podemos hacerlo:
Aquí vemos que todo lo que el Message Template incluye, se agrega en el Hint de Software Insights.
Otro ejemplo, si queremos buscar por operación:
Ya con esto, incluso podríamos tener un sistema auditable (de eso hable en este put up utilizando Audit.NET).
Básicamente, lo que Serilog agrega como Customized Properties al mandar los logs a Software Insights son:
{
"AspNetCoreEnvironment": "Improvement",
"RequestId": "0HMH6PLB0IKKE:00000015",
"RequestPath": "/api/merchandise",
"ConnectionId": "0HMH6PLB0IKKE",
"ActionName": "MediatrExample.WebApi.Controllers.ProductsController.CreateProduct (MediatrExample.WebApi)",
"ActionId": "850584fd-aa63-4f96-a2a3-6fe791b279fe",
"MessageTemplate": "{RequetsName}: {@Consumer} with request {@Request}",
"SourceContext": "MediatrExample.ApplicationCore.Frequent.Behaviours.AuditLogsBehavior",
"Consumer": "cbb809be-e383-44d0-9435-564017db0602",
"Request": "{"Description":"string","Worth":0,"_typeTag":"CreateProductCommand"}",
"RequetsName": "CreateProductCommand"
}
Más todo lo que incluyamos en el Message Template. En este caso, el message template incluye RequestName, Consumer y Request ( y fíjate que Request, es otro objeto JSON)
Aunque Software Insights no es free of charge, no tiene un costo elevado para que no se considere en tu stack.
Makes use of o no Azure, AI puede usarse y obtener resultados muy similares (si no es que iguales).
Su integración con una aplicación de .NET es muy fácil, pero también lo es con los lenguajes soportados.
Espero te sea de utilidad y le des el uso que yo le doy.