{"id":250958,"date":"2023-12-13T19:06:38","date_gmt":"2023-12-13T19:06:38","guid":{"rendered":"https:\/\/distillery.com\/blog\/dominando-azure-logs-con-django-rest-framework-guia-del-logger\/"},"modified":"2025-12-05T06:46:44","modified_gmt":"2025-12-05T06:46:44","slug":"dominando-azure-logs-con-django-rest-framework-guia-del-logger","status":"publish","type":"post","link":"https:\/\/distillery.com\/es\/blog\/dominando-azure-logs-con-django-rest-framework-guia-del-logger\/","title":{"rendered":"Dominando Azure Logs con Django-Rest-Framework: Gu\u00eda del Logger"},"content":{"rendered":"\n

<\/p>\n\n\n\n

Introducci\u00f3n<\/h3>\n\n\n\n

Hoy en d\u00eda, la gesti\u00f3n de registros es imprescindible en cualquier servicio web. Los registros pueden ayudarnos a depurar e identificar problemas en cualquier entorno. Este post profundiza en la practicidad de manejar los logs de Azure con dimensiones personalizadas en Django Rest Framework. Exploraremos c\u00f3mo esta combinaci\u00f3n simplifica el proceso de depuraci\u00f3n, permitiendo un filtrado categorizado y capacidades mejoradas a trav\u00e9s de dimensiones personalizadas. Para ofrecer una gu\u00eda clara y directa, navegaremos por el paisaje donde Django Rest Framework se encuentra con Azure Logs, proporcionando un enfoque pr\u00e1ctico para optimizar las estrategias de registro de su aplicaci\u00f3n.<\/p>\n\n\n\n

Configuraci\u00f3n de Django en el servidor<\/strong><\/h3>\n\n\n\n

OpenCensus Python SDK<\/strong> es la herramienta que utilizamos para gestionar los registros de Azure en Django. Para integrar esto sin problemas, son necesarios ajustes dentro de su archivo settings.py para alinear la configuraci\u00f3n LOGGING con el despliegue del lado del servidor. Nuestro paso inicial consiste en la incorporaci\u00f3n del middleware de Microsoft Azure:<\/p>\n\n\n\n

A continuaci\u00f3n, procedemos a incorporar la configuraci\u00f3n \u00fanica etiquetada OPENCENSUS dise\u00f1ada espec\u00edficamente para Azure Traces:<\/p>\n\n\n\n

Sustituya “YOUR_CONNECTION_STRING” por su clave de conexi\u00f3n Azure. Para concluir, aseg\u00farate de que tu configuraci\u00f3n de LOGGING incluye la definici\u00f3n y asignaci\u00f3n de AzureLogHandler a los loggers:<\/p>\n\n\n\n

Configuraci\u00f3n local de Django<\/strong><\/h3>\n\n\n\n

Para examinar la visualizaci\u00f3n de los registros de Azure desde el lado local y comprender su presentaci\u00f3n en el lado del servidor, basta con realizar un simple ajuste en la configuraci\u00f3n LOGGER:<\/p>\n\n\n\n

Una modificaci\u00f3n crucial implica la actualizaci\u00f3n de la clave ra\u00edz, acompa\u00f1ada de un ajuste en el logger de Django (observe la alteraci\u00f3n en el nivel: “WARNING”). Esta adaptaci\u00f3n soluciona un problema local en el que el logger de Django se inicializa antes de que se produzcan los logs de Azure. No configurarlo de esta manera puede provocar que el servidor no responda o no genere ning\u00fan error, a pesar de que el servicio parezca operativo.<\/p>\n\n\n\n

Huellas Azure<\/strong><\/h3>\n\n\n\n

Despu\u00e9s de configurar el archivo de configuraci\u00f3n de Django como se ha detallado anteriormente, cada registro que se origine en la biblioteca de registro est\u00e1ndar de Python se transmitir\u00e1 autom\u00e1ticamente como una traza de Azure, dependiendo de la ruta espec\u00edfica a la que se acceda. Por ejemplo, veamos esta ruta:<\/p>\n\n\n\n

El punto de vista relacionado ser\u00eda:<\/p>\n\n\n\n

Al iniciar el servidor local, tenemos la opci\u00f3n de acceder al endpoint utilizando cURL y observar su salida:<\/p>\n\n\n\n

La consola de Django responder\u00e1 con esta salida:<\/p>\n\n\n\n

Navegue hasta Azure, luego vaya a Application Insights, seguido de my-server-name y, por \u00faltimo, Logs. Aqu\u00ed, puede realizar una b\u00fasqueda de su registro utilizando el Lenguaje de Consulta de Kusto (KQL):<\/p>\n\n\n\n

Nuestros registros ser\u00e1n visibles en la p\u00e1gina de Azure Analytics a medida que vayan llegando. Se pueden emplear diversas consultas para recuperar los registros.<\/p>\n\n\n\n

Dimensiones personalizadas Azure<\/strong><\/h3>\n\n\n\n

Para incluir propiedades personalizadas en nuestros mensajes de registro, utilice el argumento extra keyword del registrador Python, incorporando la clave especial custom_dimensions. Estas propiedades se presentar\u00e1n como pares clave-valor dentro de la subsecci\u00f3n customDimensions del Registro en Azure Monitor. Por ejemplo, en nuestra vista anterior, podemos modificarla para transmitir Dimensiones Personalizadas de la siguiente manera:<\/p>\n\n\n\n

Al guardar estos ajustes y volver a enviar la solicitud anterior, ahora observar\u00e1 la presentaci\u00f3n de nuestra propiedad personalizada en la subsecci\u00f3n customDimensions.<\/p>\n\n\n\n

<\/p>\n\n\n\n

Referencias<\/strong><\/h3>\n\n\n\n