Saltar al contenido
Telemetry
Explorar documentación
GuíasActualizado el 28 de julio de 2026Revisado por los equipos editorial y de producto de Telemetry2 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. Instrumentar el límite de asignación
  2. Compare la confiabilidad primero
  3. Haga que las decisiones de implementación sean reproducibles

Análisis de implementación de funciones con SQL

Un lanzamiento progresivo necesita una comparación que preserve la asignación, el lanzamiento, el resultado del producto, el volumen y el tiempo de observación. Sin esos campos, un cambio en la combinación de tráfico puede parecer una regresión o mejora de una característica.

Instrumentar el límite de asignación

Registre el nombre del indicador de función controlada, la cohorte de implementación o control, la versión de la aplicación, el estado del terminal, la duración, el entorno y una cuenta aprobada o un identificador de solicitud cuando sea necesario para la deduplicación. Mantenga la asignación estable para la ventana de comparación. Si una cuenta cambia de cohorte, conserve el tiempo de transición en lugar de etiquetar todos sus eventos históricos con el valor más reciente.

No recopile cargas útiles de indicadores, reglas de orientación, atributos de clientes, cuerpos de solicitudes ni mensajes de error sin formato. Utilice una categoría de error controlada y una etiqueta de cohorte limitada.

Compare la confiabilidad primero

El Receta de implementación de funciones SQL agrupa las solicitudes por bandera, cohorte y versión. Mantiene juntos el recuento de solicitudes, el recuento de errores, la tasa de errores y la latencia promedio. El dispositivo determinista muestra una cohorte de implementación con una falla y una latencia promedio más lenta, mientras que su cohorte de control no tiene fallas.

Revise el resultado en orden:

  1. Confirme que ambas cohortes observaron la misma liberación y el mismo período de tiempo completo.
  2. Requerir suficientes solicitudes en control e implementación.
  3. Compare la tasa de error y la latencia, luego inspeccione las categorías de error controladas.
  4. Segmente por plan, ruta o región solo cuando la asignación y el volumen lo admitan.
  5. Pausa, continúa o expande usando una barandilla escrita.

Para obtener resultados comerciales, una la misma asignación estable a un hito de activación o de ingresos solo después de que la confiabilidad sea aceptable. El guía de viaje del producto muestra cómo mantener explícita la unidad de conteo.

Haga que las decisiones de implementación sean reproducibles

Guarde el SQL, la ventana retrospectiva, la regla de muestra mínima, el lanzamiento y el porcentaje de implementación con la decisión. Los paneles deben marcar los cambios de asignación y las implementaciones para que los respondedores puedan distinguir un efecto de característica de un cambio de código simultáneo.

Utilice Recetas de confiabilidad API para presupuestos de errores, comparaciones de versiones, impacto en el cliente y latencia de dependencia. Una barandilla debería requerir evidencia sostenida; una falla de bajo volumen debería desencadenar una revisión, no una conclusión automática e irreversible.

Función relacionada del producto

Ejecute DataFusion SQL de solo lectura sobre tablas de eventos estructurados y reutilice el resultado.

Responsabilidad y referencias técnicas

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

Consultar los criterios editoriales