kubernetes_workload_observed: del límite propio a la consulta confiable
Trate a kubernetes_workload_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
Cluster collector or deployment health controller emits only on a documented interval and immediately after a reviewed workload-state transition.
- 2
Elige los campos
8 required fields preserve the declared grain: One workload snapshot per cluster, namespace, and interval.
- 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é cargas de trabajo, clústeres y versiones se reinician, no están disponibles o tienen recursos limitados?
grano
Una instantánea de la carga de trabajo por clúster, espacio de nombres e intervalo.
propietario
Recopilador de clústeres o controlador de estado de implementación
Emitir cuando
En un intervalo documentado e inmediatamente después de una transición revisada del estado de la carga de trabajo.
Contrato de campo
Tipos de campos y datos que debes excluir
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. |
| cluster | string | yes | review | Identificador de clúster estable aprobado. |
| namespace | string | yes | review | Etiqueta de espacio de nombres aprobada sin valores derivados del inquilino. |
| workload | string | yes | non-sensitive | Nombre de implementación estable, StatefulSet o DaemonSet. |
| ready_replicas | number | yes | non-sensitive | Recuento de réplicas listas en el momento de la observación. |
| restart_count | number | yes | non-sensitive | Reinicios acumulativos para el alcance de la carga de trabajo medida. |
Evento JSON sintético
{
"timestamp_utc": "2026-07-29T09:25:00Z",
"event_id": "evt_k8s_01",
"release": "collector-2026.07.3",
"cluster": "production-us-west",
"namespace": "telemetry",
"workload": "query-api",
"ready_replicas": 4,
"restart_count": 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.
cluster: reviewnamespace: review
Lista de verificación de validación
Pruebe el contrato antes de crear un panel
- Send one known kubernetes_workload_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 kubernetes_workload_observed before cluster collector or deployment health controller 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
Envía un evento de prueba 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.