Saltar al contenido
Telemetry
Explorar documentación

Conceptos y patrones de SQLActualizado el 29 de septiembre de 20264 min de lectura

Usa esta documentación con tu agente de programación

Abra un paquete de mensajes enfocados para Claude Code, Codex, Cursor u otro agente de codificación, luego adáptelo al flujo de trabajo que se describe aquí.

En esta página
  1. Qué incluye un tablero
  2. Paso 1: crear un panel
  3. Paso 2: agregue widgets desde Explorar
  4. Paso 3: agregar widgets desde la consulta
  5. Paso 4: Organice y mantenga su panel de control
  6. Creación de paneles programáticos
  7. Ejemplos interactivos en línea
  8. Consejos para el diseño del tablero

Crear paneles

Los paneles de Telemetry reúnen gráficos, tablas y notas en una vista de equipo. Fije resultados de Explorar o Consulta, organice los widgets y añada notas. También puede crear paneles con la API.

Qué incluye un tablero

  • Un panel es una página con nombre que reúne métricas relacionadas.
  • Cada widget contiene un gráfico, una tabla, un encabezado de sección o una nota guardados.
  • Los widgets de gráficos y tablas usan una configuración de Explorar o un resultado de Consulta.
  • En el modo Editar, arrastre los widgets para moverlos y ajuste su tamaño.

Paso 1: crear un panel

Puede crear paneles de tres maneras:

  1. En la barra lateral izquierda, abra el menú Panelesy haga clic enNuevo panel.
  2. Desde un resultado de Explorar, use Crear panel de inicio y guardar si no hay panel; de lo contrario, guarde en el panel indicado.
  3. Llame a POST /dashboard con una clave API que tenga alcance read-and-write.

Paso 2: agregue widgets desde Explorar

  1. Abra una tabla y vaya a la pestaña Explorar.
  2. Elige:
    • tipo de gráfico (Samples, Table, Line, Bar o Stacked Area)
    • agregación y granularidad (para vistas de gráficos)
    • rango de tiempo, filtros y campos de grupo por
  3. Haga clic en Ejecutar.
  4. Guarde directamente con el botón del panel o Guardar este resultado.
  5. Con varios paneles, Elija el panel permite elegir el destino y el título del widget.

Después de ejecutar una consulta de Exploración, Telemetry muestra los botones de acción en el lado derecho de la barra de herramientas de resultados:

Diagrama del flujo: ejecutar la consulta, revisar el resultado y guardarlo en un panel o configurar una alerta.

Diagrama del flujo: ejecutar la consulta, revisar el resultado y guardarlo en un panel o configurar una alerta.

La acción de guardar puede aparecer en la barra de resultados o en el aviso Guardar este resultado. El guardado directo usa un título de widget predeterminado.

Telemetry almacena el estado completo de Exploración, por lo que el widget se mantiene coherente con el gráfico/tabla que fijó.

Paso 3: agregar widgets desde la consulta

  1. Abra una consulta guardada o un borrador de consulta.
  2. Ejecute la consulta y cambie a ResultadosoGráfico.
  3. Guarde directamente con el botón del panel o Guardar este resultado.
  4. Con varios paneles, Elija el panel permite elegir el destino y el título del widget.

Utilice esta ruta cuando desee un SQL completamente personalizado en lugar del SQL generado por Explore.

Paso 4: Organice y mantenga su panel de control

  1. Abra /team/{team}/dashboard/{dashboard-slug}.
  2. Haga clic en Editar.
  3. Utilice Agregar componente para insertar:
    • Bloques de encabezado de sección para agrupar widgets relacionados bajo un título y una descripción compartidos
    • Bloques de texto libre para notas de rebajas, enlaces y contexto estilo runbook
  4. Arrastre los widgets por el controlador, cambie su tamaño según sea necesario y elimine los widgets con X.
  5. Haga clic en Listo cuando los cambios de diseño se vean bien.

También puede cambiar el nombre, copiar la URL o eliminar paneles desde el menú de acciones del panel en la barra lateral.

Creación de paneles programáticos

Utilice el Tablero API cuando desee aprovisionar paneles a partir de código, generar nuevos entornos o generar paneles durante la incorporación.

El API puede:

  • crear un shell de panel vacío
  • cree un panel y sus primeros widgets en una sola solicitud
  • cree widgets de consulta respaldados por SQL y widgets respaldados por Explore
  • cree encabezados de sección y widgets de texto libre para la organización del panel

Ejemplos interactivos en línea

Ejemplo 1: widget de tendencia de tasa de error (línea)

Ejecute esto en Explorar o Consulta, luego fíjelo con Guardar en Getting Started.

SELECT
  date_trunc('hour', timestamp_utc) AS hour,
  100.0 * SUM(CASE WHEN status_code >= 500 THEN 1 ELSE 0 END) / COUNT(*) AS error_rate_pct
FROM
  http_logs
WHERE
  timestamp_utc >= now() - INTERVAL '7 days'
GROUP BY
  hour
ORDER BY
  hour ASC
Ejemplo 2: widget de puntos finales más lentos (barra)

Utilice un Bar gráfico para la clasificación. Ideal para API y paneles de control de colas.

SELECT
  endpoint,
  AVG(duration_ms) AS avg_duration_ms
FROM
  http_logs
WHERE
  timestamp_utc >= now() - INTERVAL '24 hours'
GROUP BY
  endpoint
ORDER BY
  avg_duration_ms DESC
LIMIT 15
Ejemplo 3: widget de desglose de fallos recientes (tabla)

Agregue esto como un widget de tabla junto a los gráficos de tendencias para una rápida depuración de la causa raíz.

SELECT
  timestamp_utc,
  service,
  endpoint,
  status_code,
  error_message
FROM
  http_logs
WHERE
  status_code >= 500
  AND timestamp_utc >= now() - INTERVAL '24 hours'
ORDER BY
  timestamp_utc DESC
LIMIT 200

Consejos para el diseño del tablero

  • Mantenga una pregunta principal por widget (por ejemplo: "¿Están aumentando las tasas de error?").
  • Combine widgets de tendencias con tablas desglosadas.
  • Agregue encabezados de sección antes de los grupos principales para que los paneles sigan siendo escaneables a medida que crecen.
  • Utilice notas de texto libre para alertar sobre el contexto, los vínculos del runbook o las definiciones que los compañeros de equipo necesitan durante la depuración.
  • Utilice títulos de widgets claros para que los compañeros de equipo puedan escanear la página rápidamente.
  • Comience con 4-8 widgets; agregue más solo cuando cada uno agregue una nueva señal de decisión.

Función relacionada

Convierta una consulta validada en una vista operativa enfocada y revisable.

Autores de la página y referencias

El equipo editorial de Telemetry es responsable de esta explicación; el equipo de producto revisa el comportamiento, los ejemplos y las limitaciones.

Cómo revisamos nuestra documentación