Recursos · 113

Fallo de recogida: conciliar registros y eventos ausentes

Distinguir eventos producidos, recibidos y utilizables sin interpretar el silencio como ausencia de incidentes.

Actualizado · 2 min

Lo que esta guía ayuda a lograr

  • Definir una referencia observable
  • Ensayar una interrupción controlada
  • Comparar identificadores y declarar lo desconocido

Comprobación rápida

  • Secuencia de referencia y esquema de conciliación.
  • Cronología del fallo y comportamiento en límites.
  • Lista de diferencias y estado de cobertura.

Método paso a paso

  1. 1

    Definir una referencia observable

    Relaciona aplicación, colector y almacenamiento con responsables. Prepara una secuencia finita de eventos ficticios con identificadores estables, sin secretos ni datos de clientes. Conserva tiempos de evento y observación: el retraso no equivale automáticamente a pérdida.

    Secuencia de referencia y esquema de conciliación.

  2. 2

    Ensayar una interrupción controlada

    En pruebas, interrumpe el destino y restablécelo. Observa llenado de cola, reintentos, rechazos y reinicio. Una cola persistente puede limitar pérdidas, pero tiene capacidad y depende del almacenamiento; define qué ocurre al llenarse. Verifica que la recogida no bloquee silenciosamente el servicio.

    Cronología del fallo y comportamiento en límites.

  3. 3

    Comparar identificadores y declarar lo desconocido

    Concilia la referencia con eventos realmente legibles al mismo corte. Cuenta repeticiones, retrasos y ausencias por separado; un acuse de red no prueba utilidad final. Sin referencia fiable declara cobertura desconocida, no cero pérdidas ni cero incidentes.

    Lista de diferencias y estado de cobertura.

Caso de aceptación reproducible

Ejemplo ficticio: estos datos no describen clientes ni resultados observados.

Ver datos del caso
{
    "expected_ids": [
        "E1",
        "E2",
        "E3"
    ],
    "received_ids": [
        "E1",
        "E1",
        "E3"
    ],
    "received_rows": 3,
    "unique_received": 2,
    "missing_ids": [
        "E2"
    ],
    "observation_cutoff": "same_for_both_sets"
}

Decisión esperada

Ejemplo ficticio: se esperan E1, E2 y E3, pero llegan E1, E1 y E3. Tres filas no prueban completitud: E1 se repite y E2 falta al corte.

OpenTelemetry — Collector resiliency

Su cuaderno de aceptación

Registre observaciones según los criterios de esta guía. El registro no es una certificación.

El cuaderno no guarda automáticamente. Exporte antes de salir.

Indicadores de gestión

IndicadorQué midePrimera acción
Ausencias conocidasIdentificadores esperados ausentes en destinoMisma referencia y corte
Repeticiones recibidasFilas − identificadores únicosNo mide pérdidas desconocidas

Errores comunes

    Preguntas frecuentes

    ¿Tres filas recibidas prueban que se conservaron tres eventos?

    No. Dos filas pueden repetir un identificador y ocultar una ausencia. Compara identificadores, periodo observado y etapas de la cadena.

    Referencias oficiales

    Las referencias respaldan el método. Adapte los controles a su contexto; no constituyen certificación. Los títulos de referencia originales y los documentos fuente pueden estar en otro idioma.

    Referencias consultadas el .