Leer la telemetría de Business Central sin KQL

Business Central emite una gran cantidad de telemetría, y casi nadie la lee. El motivo no es la indiferencia. El motivo es que los datos llegan como consultas KQL sobre un área de trabajo de Application Insights, y la mayoría de las personas que necesitan las respuestas no escriben KQL.

No hace falta. Esta página da los identificadores de evento que cuentan la historia, qué significa cada uno, y las preguntas que puede responder una vez los conoce.

¿Adónde va la telemetría de Business Central?

Al recurso de Application Insights que usted conecta al entorno. Business Central escribe ahí sus señales como trazas, cada una con un identificador de evento y un conjunto de dimensiones personalizadas.

El identificador de evento es todo el sistema de navegación. Microsoft publica la lista completa, y en cuanto conozca seis de ellos podrá responder a la mayoría de las preguntas operativas.

¿Qué identificadores de evento cuentan la historia?

Estos son los identificadores y las descripciones de la propia tabla de Microsoft.

Dos de ellos son más útiles de lo que sugiere su nombre.

RT0004 es cómo se cuenta el uso. No hay ningún evento de «sesión». Se cuentan las autorizaciones correctas para abrir una empresa, agrupadas por usuario y por día. Eso da los usuarios activos diarios, semanales y mensuales.

RT0030 es cómo se encuentra el dolor. Registra los diálogos de error que los usuarios vieron de verdad. No las excepciones de un log, los diálogos delante de una persona. Ordenar RT0030 por mensaje y por recuento produce la lista más corta de problemas reales que le puede dar cualquier entorno de Business Central.

Las cinco preguntas que merece la pena hacer

¿Quién usa este entorno, y está cambiando? RT0004, agrupado por usuario y día. Compare el periodo actual con el anterior. Una caída después de una actualización es la señal que quiere ver rápido.

¿Qué va lento, y es SQL o AL? RT0005 y RT0018 juntos. La separación importa. Una consulta SQL lenta suele ser un índice que falta, o un filtro que no puede buscar. Un método AL lento suele ser un bucle que debería haber sido una consulta.

¿Qué está fallando delante de las personas? RT0030, ordenado por mensaje. Después lleve los tres primeros a quien sea dueño del proceso.

¿Quién nos llama, y con qué intensidad? RT0008 para lo entrante y RT0019 para lo saliente, agrupados por endpoint. Una integración que ha triplicado en silencio su ritmo de llamadas aparece aquí antes de aparecer en una queja.

¿Funcionó la última actualización de la extensión? Las parejas LC00xx. LC0021 y LC0023 son las que conviene alertar, porque un fallo de compilación o de actualización es un problema del que quiere enterarse por la telemetría, no por un usuario.

Los límites de KQL que sorprenden

Dos de ellos cuestan una tarde cada uno.

Log Analytics no tiene percentileif. Lo va a querer enseguida, porque la pregunta natural es «el percentil 95 de duración de esta operación concreta». Enmascare primero las filas con iff y después aplique percentile a la columna enmascarada.

Las dimensiones personalizadas son cadenas. Las duraciones, los recuentos de filas y todos los demás números llegan como texto. Conviértalos antes de compararlos, o un filtro sobre una duración comparará cadenas y devolverá en silencio las filas equivocadas.

Añada un hábito a ambos: mire siempre el rango temporal. Los valores por defecto de Application Insights pueden limitar sin avisar lo que usted consulta, y una consulta que no devuelve nada es más a menudo un problema de rango que un problema de datos.

Cómo leerla sin escribir KQL

Tres caminos, en orden creciente de esfuerzo.

Use la app de Power BI de telemetría de Business Central. Cubre las preguntas habituales y no requiere escribir consultas.

Pregunte a un asistente que ejecute el KQL por usted. Una herramienta que lea su área de trabajo de Application Insights puede responder en lenguaje corriente, siempre que haga dos cosas: enseñarle el KQL que ha ejecutado y explicar cada identificador de evento en lugar de entregarle un saco de propiedades en bruto. Un identificador de evento sin explicación no es una respuesta, es una tarea de consulta.

Aprenda seis consultas. Si escribe KQL dos veces al año, aprenda las cinco preguntas de arriba como cinco consultas guardadas y pare ahí. El valor marginal de la séptima consulta es bajo.

Qué no le dirá la telemetría

No le dirá por qué. RT0005 le dice que una consulta superó el umbral. No le dice que un usuario construyó un filtro sobre un campo no indexado porque la página no ofrece el adecuado.

No le hablará del trabajo que no llegó a ocurrir. Una extensión que vuelve un proceso tan lento que la gente deja de usarlo aparece como menos telemetría, no como más.

Y no nombrará el impacto de negocio. Un registro fallido es una fila aquí y un problema de cierre de mes allá. La telemetría señala la operación. Alguien tiene que conectarla con el proceso.

Esa es la división del trabajo correcta. La telemetría estrecha una pregunta desde el entorno entero hasta una operación, una extensión y una hora. El resto es consultoría, y sale mucho más barata cuando la búsqueda ya está hecha.