Consultas guardadas, historial, favoritos y colaboración

Una consulta guardada convierte una investigación en un artefacto de equipo reutilizable. Telemetry organiza las consultas dentro de los espacios de trabajo del equipo, conserva el historial de consultas y permite que cada persona marque como favoritas las consultas a las que regresa con más frecuencia.

Guardar SQL no hace que la métrica sea correcta. Revise el detalle del evento, los filtros, el denominador, las unidades y los límites de tiempo antes de que otras personas o flujos de trabajo automatizados dependan de ello.

Elige un espacio de trabajo

Utilice espacios de trabajo para agrupar análisis relacionados por servicio, área de producto, flujo de trabajo operativo o equipo. Los espacios de trabajo se pueden anidar, lo que permite que un área amplia contenga colecciones más específicas sin forzar cada consulta en una lista plana.

Mantenga la estructura lo suficientemente superficial como para escanearla. Un arreglo práctico podría ser:

reliability
  api
  background-jobs
product
  activation
  retention
ai
  model-cost
  agent-quality

La membresía del equipo controla quién ve los espacios de trabajo y las consultas guardadas. Un nombre de espacio de trabajo como "personal" describe la organización o propiedad; no hace que ese espacio de trabajo sea privado. Cada miembro del equipo puede acceder al análisis del espacio de trabajo del equipo, por lo tanto, utilice un equipo independiente cuando una consulta contenga identificadores o detalles operativos destinados a un público más limitado.

Guardar y nombrar una consulta

Comience en un borrador, ejecute la consulta en un rango de tiempo representativo e inspeccione el resultado. Cuando esté listo para conservar:

1. Guárdelo en el espacio de trabajo propietario de la decisión.
2. Cambie el nombre con el resultado, el alcance y la unidad cuando sea útil.
3. Mantenga el volumen al lado de tasas y percentiles.
4. Agregue el resultado a un panel solo después de revisar la versión guardada.

Prefiera API error rate by route — production a query 14 o incident query. Un nombre debería ayudar a alguien a encontrar e interpretar la consulta sin abrir todos los resultados.

Comprender el historial de consultas

Guardar cambios crea un historial de consultas. Utilice las entradas del historial para revisar cómo evolucionó SQL y recuperar la lógica anterior cuando una edición cambie el resultado inesperadamente.

Antes de cambiar materialmente una consulta compartida:

• tenga en cuenta las definiciones de métricas antiguas y nuevas;
• compare ambas versiones en la misma ventana fija;
• identificar paneles, alertas o informes que utilizan la consulta;
• conservar la versión anterior hasta que los consumidores hayan revisado el cambio;
• actualice el texto explicativo del panel cuando cambie el significado.

El historial no sustituye a una pista de auditoría más amplia o a un proceso de revisión de código cuando una consulta impulsa informes regulados, decisiones de acceso o conciliaciones financieras exactas.

Utilice favoritos como atajo personal

Los favoritos son ayudas de navegación por persona. Favorecer una consulta no cambia su espacio de trabajo, sus permisos, SQL ni su estado para otros miembros del equipo. Utilice favoritos para vistas de incidentes activos, revisiones semanales o preguntas recurrentes sobre productos sin duplicar la consulta compartida.

Promover resultados estables

Una consulta guardada puede convertirse en:

• un cuadro de mando o una tabla de resultados;
• una alerta con un umbral y un propietario explícitos;
• una exportación repetible;
• un punto de partida para una investigación más profunda.

Mantenga la consulta guardada como definición analítica inspeccionable. Coloque las instrucciones de respuesta y la propiedad junto al panel o alerta para que el artefacto siga siendo comprensible durante una transferencia.

Lista de verificación de colaboración

Antes de compartir ampliamente una consulta guardada, confirme:

1. Cada miembro del equipo es una audiencia prevista para el espacio de trabajo y la consulta.
2. El título describe el resultado y las unidades.
3. El SQL utiliza campos documentados y reglas de conteo.
4. Se ha comprobado un dispositivo representativo o un intervalo conocido.
5. Los identificadores sin procesar sensibles se omiten en los paneles amplios.
6. Los cambios materiales se comparan con la entrada anterior del historial.
7. Cada alerta tiene un propietario, una ventana de evaluación y una acción de respuesta.

Continúe con Crear paneles, Alertas o Equipos, espacios de trabajo y miembros.