Saltar al contenido
Telemetry
guía de integración

Carga de trabajo de Kubernetes Telemetry

Envíe observaciones limitadas de reinicio, preparación e implementación de Kubernetes a Telemetry para análisis SQL a nivel de carga de trabajo.

Revisado por el equipo de producto Telemetry en . Contrato de instrumentación, límites de privacidad y guía de implementación. Revisar los estándares y la propiedad

Obtén una clave APIVer fragmento
Útil para
  • Análisis de reinicio de contenedores
  • Monitoreo de preparación e implementación
  • Correlación de incidentes entre carga de trabajo y aplicación
Evidencia de implementación

Kubernetes Workload Telemetry: del límite a la fila verificada

Utilice Kubernetes Workload Telemetry en un límite de aplicación controlado, mantenga el contrato de evento pequeño y verifique un resultado conocido antes de crear vistas agregadas.

  1. 1

    Elige el resultado

    Análisis de reinicio de contenedores

  2. 2

    Definir el contrato

    clúster, espacio de nombres, carga de trabajo, pod, event_name y entorno

  3. 3

    Instrumentar el límite

    Resuelva cada pod en su propietario de implementación, StatefulSet, DaemonSet o trabajo antes de generar informes para que los paneles no se fragmenten en nombres de pods de corta duración.

  4. 4

    Verificar la evidencia

    Exercise a known fixture, then inspect kubernetes_workload_event for one correctly typed terminal row.

Antes de empezar

Requisitos previos y límites

  • Un recopilador o controlador con acceso de solo lectura a los campos de estado de la carga de trabajo dentro del alcance.
  • Clúster estable, espacio de nombres, propietario de carga de trabajo y etiquetas de lanzamiento de aplicaciones
  • Una política de redacción que excluye secretos, manifiestos, valores ambientales, registros sin procesar y cargas útiles de clientes.

Configuración de entrega

Instalar e inicializar el lado del servidor

Importe telemetry-sh en código solo de servidor e inicialícelo una vez con Process.env.TELEMETRY_API_KEY. Mantenga las credenciales de ingesta fuera de los paquetes de navegador, las variables de entorno visibles para el cliente, el control de fuente, los registros y los mensajes de excepción.

Instalación de kubernetes

Instalación npm

bash
npm install telemetry-sh
  1. 1Prepare un cliente de entrega del lado del servidor reutilizable con comportamiento de red limitado.
  2. 2Agregue el evento de resultado en el límite de éxito, error, reintento o tiempo de espera.
  3. 3Envíe accesorios controlados e inspeccione las filas almacenadas antes de habilitar una alerta.

Fragmento

Comience con un evento estructurado

Agregue esta forma donde el flujo de trabajo se completa, falla o se vuelve a intentar. Luego cree el panel a partir de campos reales.

kubernetes

Evento Kubernetes Workload Telemetry

javascript
import telemetry from "telemetry-sh";

export async function logKubernetesWorkloadSample({
  cluster,
  namespace,
  workload,
  pod,
  restartCount,
  ready,
  applicationRelease,
  previousRestartCount,
}) {
  const eventName =
    restartCount > previousRestartCount
      ? "container_restarted"
      : "workload_sampled";

  await telemetry.log("kubernetes_workload_event", {
    cluster,
    namespace,
    workload,
    pod,
    event_name: eventName,
    restart_count: restartCount,
    ready,
    application_release: applicationRelease,
    environment: "production",
  });
}

Contrato de evento

clúster, espacio de nombres, carga de trabajo, pod, event_name y entorno

restart_count, listo, rollout_id, application_release y observed_generation

Una categoría de motivo limitada solo cuando se aprueba la recopilación del valor de origen

Puntos de control de implementación

Punto de control 1

Resuelva cada pod en su propietario de implementación, StatefulSet, DaemonSet o trabajo antes de generar informes para que los paneles no se fragmenten en nombres de pods de corta duración.

Punto de control 2

Emite una transición container_restarted cuando aumenta el contador acumulativo; mantenga el contador como contexto y nunca sume muestras de calibre.

Punto de control 3

Correlacione los reinicios repetidos con la pérdida sostenida de preparación y los resultados de la aplicación antes de la paginación.

Verificación

Demuestra que el evento llegó

Ejecute esto después de ejercitar casos conocidos de éxito y fracaso. Reemplace el nombre de la tabla alternativa si su contrato de evento final difiere del fragmento.

Verificación kubernetes

Consulta de verificación Kubernetes Workload Telemetry

sql
SELECT *
FROM kubernetes_workload_event
ORDER BY timestamp_utc DESC
LIMIT 20;
Confirme una fila terminal por resultado lógico, con el estado esperado, identificadores, unidades y hora UTC.
Inspeccione el esquema inferido y verifique que los reintentos no cambien los tipos de campos ni generen un nuevo ID de evento lógico.
Busque en los campos almacenados credenciales, cargas útiles sin procesar, mensajes, contenido privado y mensajes de error ilimitados.
Realice un tiempo de espera del proveedor, un rechazo de la ingesta y un cierre del proceso antes de considerar el panel como completo.

Referencias de implementación

Revise el contrato del evento, la guía de seguridad de los datos y la documentación primaria previa antes de habilitar una nueva ruta de producción.

Caso de uso de confiabilidad de KubernetesGuía SQL de confiabilidad de KubernetesReinicio de carga de trabajo SQLCiclo de vida del módulo de Kubernetes

Límite de producción

Mantenga el evento de resultado pequeño y recuperable

Este patrón proporciona

  • Un resultado limitado y listo para SQL junto al flujo de trabajo ascendente.
  • Campos estables para paneles, alertas y correlación entre eventos.
  • Una ruta basada en dispositivos para validar el comportamiento de éxito, fracaso, reintento y tiempo de espera.

Este patrón no proporciona

  • Un exportador de OTLP, un canal de recopilación automática o un reemplazo para seguimientos detallados y registros de diagnóstico.
  • Entrega exactamente una vez simplemente porque la carga útil contiene un ID de evento.
  • Permiso para recopilar cargas útiles sin procesar del proveedor, contenido de usuario, credenciales o datos regulados.
Entrega e idempotenciaProcesamiento por lotes y apagadoSolucionar problemas de ingestión

Puntos de partida del esquema de eventos

Contratos de eventos para este flujo de trabajo

Revise el detalle de la fila, el límite de emisión, los tipos requeridos, las clases de privacidad, la carga útil de ejemplo y la lista de verificación de validación antes de adaptar una consulta o fragmento a producción.

Fiabilidad de Kubernetes8 campos

kubernetes_workload_observed

Una instantánea de la carga de trabajo por clúster, espacio de nombres e intervalo.

inspeccionar contrato

Función relacionada del producto

Continúe este flujo de trabajo en Alertas

Promueva la consulta de confiabilidad revisada a un umbral propio y un flujo de trabajo de respuesta.

Explorar AlertasRevisar la evidencia del cliente

Recetas SQL relacionadas

Responde la siguiente pregunta con SQL

Ejecute la consulta en los campos estructurados de este flujo de trabajo, inspeccione el resultado del ejemplo y convierta una respuesta útil en un panel o alerta.

Explorar todas las recetas
InfraestructuraPrincipiante

Encuentre reinicios de Kubernetes por carga de trabajo

¿Qué cargas de trabajo de Kubernetes se reinician y no superan las comprobaciones de preparación?

Receta abierta
InfraestructuraPrincipiante

Encuentre la saturación de recursos de host y contenedor

¿Qué fuentes de infraestructura tienen recursos persistentemente limitados?

Receta abierta
InfraestructuraAvanzado

Calcular el tiempo de detección y recuperación de incidentes

¿Cuánto tiempo tarda cada servicio en detectar y recuperarse de incidentes?

Receta abierta
Eventos estructuradosPrincipiante

Detectar latidos de servicio faltantes

¿Qué fuentes de telemetría esperadas han dejado de enviar latidos?

Receta abierta
colecciones completasEventos estructurados SQLInfraestructura SQL

Explorar por familia de implementación

Comparar patrones de integración relacionados

Integraciones de nube e infraestructura Telemetry

Plantillas para combinar con esta integración

Monitor de latencia y errores de API

Observe el volumen de solicitudes, los códigos de estado, la latencia de ruta, los puntos finales fallidos y los incidentes de API que afectan al cliente.

Abrir plantilla

Más integraciones

Integración de AWS ECS y Fargate Telemetry

Agregue la familia de tareas de ECS, la revisión, la zona de disponibilidad y el contexto de lanzamiento a los resultados de la aplicación utilizando el punto final de metadatos de la tarea local.

abrir guia

Flujo de trabajo n8n Telemetry

Envíe los resultados de finalización, error, reintento, recuento de elementos y entrega posterior del flujo de trabajo n8n a un evento Telemetry limitado a través del nodo de solicitud HTTP.

abrir guia

Monitoreo de eventos estructurados de AWS Lambda

Realice un seguimiento de las invocaciones de Lambda, los arranques en frío, la duración, los reintentos y los resultados comerciales con eventos estructurados compactos.

abrir guia