Build Dashboards for App telemetry (KQL)

Dashboards vs Workbooks

IMPORTANTE

Los dashboards difieren de los workbooks en su diseño e interaccion. Las dashboards están optimizadas para ser visuales, con tiles que se refrescan y muestran los datos automaticamente. El layout es relativamente estatico. Pones las tiles una vez y el dashboard se muestra sin intervencion humana.

Los workbooks están diseñados para una exploracion interactiva donde ajustas params para ver datos dinámicos.

Elegimos dashboards para ongoing operational monitoring y workbooks para investigación de incidentes y ad-hoc analysis.

IMPORTANTE

Azure dashboards for monitoring

Azure dashboards son una surface visual customizable en el azure portal que combina multiples recursos en una unica view.

En ellos podemos ver metrics chart, log query results, Markdown text blob o recursos de la galeria. Los equipos usan estas dashboards para tener un awareness operacional en el day-to-day monitoring para confirmar pipeline health.

Pin metrics to dashboards

Common metrics:

  • server response time (avg y percentiles)
  • failed requests
  • dependency failures (llamadas fallidas a BBDD, APIs, etc)
  • server request rate
  • availability

Pin log query results to a dashboard

Los charts de metricas están limitados a unas en especifico. Si queremos valores custom podemos hacer joins entre tablas y hacer pin de una SQL query para mostrar sus resultados en una dashboard.

ver que servicios contribuyen a los most failures

requests
| where timestamp > ago(24h)
| where success == false
| summarize failedCount = count() by cloud_RoleName
| render barchart

representar tres lineas con los percentiles

requests
| where timestamp > ago(24h)
| summarize p50 = percentile(duration, 50),
    p95 = percentile(duration, 95),
    p99 = percentile(duration, 99)
    by bin(timestamp, 1h)
| render timechart

Organize and share dashboards

Las dashboards se pueden compartir con team members. Publicarlas las hace disponibles para otros usuarios en tu organizacion mediante RBAC

Best practices

  • Separate concerns into different dashboards
  • Limit tile count
  • Use descriptive tile titles
  • Include markdown tile for context

Workbooks for interactive analysis

IMPORTANTE

Azure Monitor Workbooks son una herramienta interactiva de analisis que combinan rich text, KQL, metricas y parametros en reusable reports.

Los workbooks van más alla de dashboards y soportan user interaction: seleccionar un param value, elegir un time range. Esta interactividad hace que los workbooks sean la eleccion natural para troubleshooting, root cause analysis y cualquier escenario donde el investigador necesite ajustar el scope del analisis.

/IMPORTANTE

El Azure Portal incluye una galeria de prebuilt workbook templates organizadas por categoria para usar como starting points y customizar para tu caso.

Add query steps and visualizations

Los workbooks se construyen añadiendo steps verticalmente, donde cada step renferiza un componente del reporte final. Se cuenta como steps, text bloccks para explicaciones e instrucciones, query steps que ejecutan KQL y muestran resultado, metric steps que muestran metricas de recursos de Azure.

Ejemplo de query que funciona como un step de workbook

requests
| where timestamp > ago({TimeRange})
| summarize totalRequests = count(),
    failedRequests = countif(success == false)
    by cloud_RoleName
| extend successRate = round(100.0 * (totalRequests - failedRequests) / totalRequests, 2)
| project cloud_RoleName, totalRequests, failedRequests, successRate

La sintaxis {TimeRange} referencia un param del workbook.

Use params for interactive filtering

Como hemos visto en el paso anterior podemos hacer los workbooks interactivos, donde cada param aparece como control en el top del workbook.

Los params más comunes son:

  • time range
  • dropdown params (para filtrar por service name, environment, etc)
  • resource pìcker para elegir que Application Insight resource analizamos

Configure conditional visibility and linked content

Conditional visibility y grid link actions añaden depth a los workbooks. En vez de enseñar cada detalle upfront de a una, se pueden diseñar los workbooks para que comiencen con un resumen a alto nivel y revelen detalles solo cuando se seleccione un item especifico.

Esto se hace que se muestre o se esconda basándose en un param value que configuramos.

Grid link actions crean tablas interactivas donde al seleccionar una row hace trigger de downstream actions. Cuando configuramos una grid column como un link, hacer click en esa celda de esa column para abrir detalles end-to-end de transacciones para una request especifica, navegar a otro workbook para un analisis mas a fondo o ejecutar otras acciones.