Saltar al contenido
Telemetry
Explorar documentación

GuíasActualizado el 28 de julio de 20263 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. Mida primero el contrato del evento
  2. Revisar cardinalidad y utilidad.
  3. Cambia de colección de forma segura

Gestión del coste y el volumen de telemetría

La facturación mide el tiempo real de CPU de todos los trabajadores, no el tiempo transcurrido: 8 CPU ocupadas durante 10 segundos son 80 segundos de CPU. Las esperas no cuentan. Cada fragmento completado y el trabajo propio del coordinador se cuentan una vez. Los fragmentos completados pueden facturarse aunque la solicitud falle; los reintentos pueden añadir consumo. Los nuevos registros no tienen un mínimo de 300 ms. Free incluye 1 hora de CPU al mes, Business 10 y Enterprise 100; el exceso de pago cuesta $0.30 por hora de CPU. Así se cobra el trabajo realizado, no la lentitud por espera. La ejecución paralela no garantiza un coste menor.

CPU billing: full details (English)

Para entender el costo de la telemetría, mida la frecuencia de eventos, el tamaño de los datos enviados, la retención, los datos que examinan las consultas, las exportaciones y la cantidad de valores distintos de cada campo. El total de bytes no basta para explicar una factura. Revise estas mediciones antes de reducir la recopilación para saber qué datos perdería y qué costos podría reducir.

Mida primero el contrato del evento

En el momento de la ingesta, registre un evento operativo compacto con el nombre del evento controlado, el origen del productor limitado, los bytes de carga útil serializados, la versión del esquema, el resultado de la aceptación y el entorno. No duplique la carga útil original en el evento de medición.

Los grupos receta de volumen de telemetría SQL cuentan y cargan bytes por contrato de evento. También calcula el tamaño promedio del evento y la tasa de rechazo. Esto distingue un evento pequeño de alta frecuencia de un evento de gran tamaño de baja frecuencia y evita que un cambio de costo degrade silenciosamente la calidad de los datos.

Los bytes serializados no son lo mismo que el almacenamiento comprimido, los bytes escaneados, la salida de la red o el costo de la factura. Conecte el agregado con su modelo real de retención y fijación de precios antes de pronosticar el dinero.

Revisar cardinalidad y utilidad.

Un evento pequeño aún puede crear un panel inutilizable si campos como URL sin formato, ID de solicitud, mensaje de error o etiqueta generada por el usuario se convierten en dimensiones de agrupación. Siga el guía de campos de alta cardinalidad y mantenga identificadores para desgloses específicos en lugar de gráficos predeterminados.

Para cada contrato grande, documente:

  1. Las decisiones, tablero, alerta o investigación que respalda.
  2. Campos obligatorios y campos que se pueden eliminar o categorizar.
  3. Reglas de muestreo de producción y las preguntas que el muestreo evitaría.
  4. Requisitos de retención y eliminación.
  5. El propietario que revisa los cambios de esquema y volumen.

Cambia de colección de forma segura

Comience con ruido de desarrollo, duplicados accidentales y campos que no tienen lector. Pruebe los cambios de esquema y el comportamiento de rechazo antes de reducir los datos de producción. Compare los segmentos diarios completos después del lanzamiento para que un cambio de tráfico no se confunda con una ganancia en instrumentación.

Utilice recopilación de recetas de calidad de datos para monitorear la actualización, los duplicados, los campos nulos y la adopción de esquemas mientras cambia el volumen. El guía de retención de datos cubre decisiones de política y eliminación que deben permanecer separadas de la optimización de consultas.

Función relacionada

Registra nombres de eventos estables, campos con tipos definidos y contexto revisado para proteger la privacidad.

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