Verificar la ingesta y el esquema de eventos
Una solicitud API aceptada no es el final de una verificación de instrumentación. Verifique la tabla y la fila resultantes antes de copiar el evento en más rutas, trabajadores o servicios.
Esta página supone que envió el evento sintético api_request_completed desde Envíe su primer evento estructurado.
Encuentra la tabla
Abra su equipo Telemetry, seleccione Tablas y abra api_request_completed. Si la tabla está ausente:
- Confirme que la solicitud API haya devuelto una respuesta exitosa.
- Confirme que la clave pertenece al equipo previsto y que tiene un alcance con capacidad de escritura.
- Verifique el nombre exacto de la tabla después de la normalización.
- Vuelva a intentarlo una vez con un nuevo
request_idsintético. - Siga Solución de problemas de ingesta de eventos antes de cambiar el esquema.
Evite enviar repetidamente el mismo evento sin un nuevo identificador; Los reintentos pueden hacer que los recuentos posteriores sean ambiguos.
Inspeccionar el esquema inferido
El ejemplo sintético API debería exponer campos similares a:
| campo | Tipo analítico esperado | comprobar |
|---|---|---|
timestamp_utc |
Marca de tiempo | Agregado consistentemente y almacenado en UTC |
route_template |
Texto | Contiene una plantilla de ruta limitada, no una URL sin formato |
status_code |
Entero | Puede admitir comparaciones numéricas |
latency_ms |
Número | Utiliza milisegundos en todas partes |
status |
Texto | Utiliza un pequeño vocabulario documentado. |
request_id |
Texto | Conecta eventos relacionados sin exponer secretos |
Si un campo importante tiene un tipo incorrecto, detenga y corrija al productor antes de enviar el volumen de producción. Un campo que cambia de un número a texto arbitrario puede hacer que sea más difícil razonar sobre el SQL y los gráficos guardados.
Inspeccionar la fila exacta
Utilice la vista MuestrasoTabla y busque request_id = req_demo_001. Confirmar:
- La fila pertenece al entorno y la versión esperados.
latency_mses184, no0.184o184000.- La ruta no contiene un informe real ni un identificador de cuenta.
- No se incluyó ningún encabezado de autorización, cookie, cuerpo de solicitud, secreto, aviso o contenido privado del cliente.
- La hora generada coincide con la ventana de envío.
La fila esperada es evidencia de que el contrato de evento funciona. No es un punto de referencia de desempeño ni una distribución de producción representativa.
Verificar a través del API
También puede inspeccionar tablas y esquemas mediante programación:
curl https://api.telemetry.sh/tables \
-H "Authorization: Bearer $TELEMETRY_API_KEY"
Luego solicite el esquema de la tabla:
curl https://api.telemetry.sh/tables/api_request_completed/schema \
-H "Authorization: Bearer $TELEMETRY_API_KEY"
Utilice una clave con capacidad de lectura para la automatización de la verificación. El Tablas API documenta paginación, normalización, retención y respuestas de esquema.
registrar el contrato
Antes de ampliar la instrumentación, anotar:
- El nombre del evento y el grano comercial.
- Campos obligatorios y opcionales.
- Tipos de campo y unidades.
- Categorías de estado y error permitidas.
- Campos de identidad y correlación.
- Campos que están prohibidos.
- El titular y el plazo de conservación previsto.
Continúe con Escriba su primera consulta sobre SQL. Para conocer la estrategia de cambio de esquema, consulte Evolución del esquema.