Saltar a contenido

Halted origins

Descripción

Este endpoint muestra el registro de los orígenes configurados en la plantilla que han sido filtrados en el arranque del Driver de MQTT por contener errores.

Esta información se puede consultar cuando subimos o actualizamos una plantilla de Netin para poder realizar un diagnóstico más preciso de su configuración.

En el caso de que la plantilla contenga errores de validación este endpoint nos indica cuales son los orígenes que han presentado algún tipo de fallo durante su arranque, así como los posibles puntos de fallo de los servicios o subcomponentes que dependen de dichos orígenes, además nos indica el motivo por el cual se ocasiona el error.

Podemos encontrarlo en la ruta <ip>:<mqtt_port>/v1/halted-origins.

Visualización

Al realizarse una petición GET al endpoint nos devuelve una respuesta en formato JSON.

{
    "uuid": "b074fe58-1483-45dd-b18a-7bea77c15c26",
    "links": {
        "alarms": "http://10.10.50.21:3000/v1/alarms",
        "haltedOrigins": "http://10.10.50.21:3000/v1/halted-origins",
        "health": "http://10.10.50.21:3000/v1/health",
        "metrics": "http://10.10.50.21:3000/v1/metrics",
        "quarantine": "http://10.10.50.21:3000/v1/quarantine",
        "registers": "http://10.10.50.21:3000/v1/registers"
    },
    "status": 404,
    "code": "HTTP",
    "title": "Not Found",
    "detail": "Not Found",
    "source": {
        "pointer": "/v1/halted-origin",
        "parameter": {
            "body": {},
            "query": {}
        }
    }
}

Listado de campos

  • quantity(number): Indica la cantidad de origenes con errores que se han detectado.

  • halted(healtedOrigins[]): Muestra el conjunto de plantillas filtradas. En un arrayList que contiene datos del tipo HealtedOrigins con los siguientes atributos:

  • origin(string): origen en el que ha ocurrido el error, que puede ser un sistema monitorizado, un subsitema, un dispositivo o codigo fuente del datapoint.

  • template(string): identificador del template del dispositivo.

  • version(string): indica la versión del template.

  • reasons(string[]): array que contiene información mas detallada de los errores producidos y/o corregidos.