browser_performance_observed: del límite propio a la consulta confiable
Trate a browser_performance_observed como un contrato analítico duradero: el propietario emite un grano documentado, un dispositivo prueba los campos y una consulta revisada responde a la pregunta formulada.
- 1
El resultado se vuelve definitivo
Browser instrumentation after a performance measurement settles emits only when a reviewed web vital or application navigation measurement becomes final.
- 2
El contrato está limitado.
8 required fields preserve the declared grain: One sampled browser metric observation.
- 3
El accesorio está verificado
Tipos de verificación, hora UTC, resultados alternativos, idempotencia y todos los campos seudónimos o clasificados por revisión.
- 4
La pregunta esta respondida
¿Qué rutas, versiones y clases de dispositivos han degradado el rendimiento visible para el usuario?
grano
Una observación de métrica del navegador de muestra.
propietario
Instrumentación del navegador después de que se establece una medición del rendimiento
Emitir cuando
Cuando una medición revisada de Web Vital o de navegación de aplicaciones se vuelve definitiva.
Contrato de campo
Campos escritos con límites de privacidad explícitos
Mantenga estables los nombres y tipos de campos existentes después de que las consultas de producción dependan de ellos. El contexto opcional debe permanecer limitado, documentado y justificado por una decisión específica.
| Campo | Tipo | Requerido | Privacidad | Significado |
|---|---|---|---|---|
| timestamp_utc | timestamp | yes | non-sensitive | Hora UTC en el límite del resultado. |
| event_id | string | yes | non-sensitive | Identificador único estable utilizado para la deduplicación. |
| release | string | yes | non-sensitive | Versión de la aplicación o servicio que emitió el evento. |
| session_id | string | yes | pseudonymous | Identificador de sesión de navegador giratorio y con revisión de privacidad. |
| route_template | string | yes | non-sensitive | Ruta normalizada sin cadenas de consulta ni identificadores. |
| metric_name | string | yes | non-sensitive | Métrica limitada como LCP, INP, CLS o navigation_ms. |
| metric_value | number | yes | non-sensitive | Valor numérico en la unidad definida por metric_name. |
| sample_rate | number | yes | non-sensitive | Probabilidad de selección utilizada para esta observación. |
Evento JSON sintético
{
"timestamp_utc": "2026-07-29T09:18:11Z",
"event_id": "evt_browser_01",
"release": "2026.07.3",
"session_id": "browser_session_71a2",
"route_template": "/team/:team/dashboard/:dashboard",
"metric_name": "LCP",
"metric_value": 2180,
"sample_rate": 0.1
}Revisión de privacidad
Revisar los identificadores antes de la ingestión
Este ejemplo utiliza identificadores sintéticos. Los valores seudónimos aún pueden ser datos personales y los campos de revisión pueden exponer el contexto empresarial o del proveedor. Aplique sus propios requisitos de consentimiento, retención, acceso, residencia y eliminación.
session_id: pseudonymous
Lista de verificación de validación
Pruebe el contrato antes de crear un panel
- Send one known browser_performance_observed fixture after the documented outcome boundary.
- Verify all 8 required fields arrive with the documented types.
- Vuelva a intentar el mismo identificador de evento y confirme el comportamiento de deduplicación elegido.
- Envíe un error controlado o un resultado alternativo cuando el flujo de trabajo lo admita.
- Ejecute el SQL relacionado en una ventana fija y concilie el resultado con el dispositivo.
Errores comunes
Mantenga una fila igual a un resultado duradero
- Emitting browser_performance_observed before browser instrumentation after a performance measurement settles knows the final outcome.
- Mezclar varios granos en una tabla, lo que hace que los recuentos y tasas sean ambiguos.
- Reemplazar categorías controladas con URL sin formato, cargas útiles, mensajes o texto de error.
- De ello depende el cambio de un tipo de campo después de las consultas y los paneles guardados.
- Agregar identificadores sin una necesidad documentada de investigación, acceso y retención.
Usa el contrato
Consultar y operacionalizar el evento.
Contratos relacionados
Enviar un dispositivo antes del tráfico de producción.
Cree una clave API gratuita, envíe el evento sintético e inspeccione la tabla inferida antes de conectar un flujo de trabajo en vivo.