Saltar al contenido principal

Reenvío de sucesos a un servicio web REST

Puede configurar Lenovo XClarity Orchestrator para que reenvíe sucesos específicos a un servidor web REST.

Antes de empezar

Atención
No se establece una conexión segura al reenviar datos a este servicio. Los datos se envían a través de un protocolo no cifrado.

Acerca de esta tarea

Si el control de acceso basado en recursos está habilitado, los datos se reenvían solo para aquellos recursos a los que puede acceder mediante listas de control de acceso. Si no es miembro de un grupo al que se ha asignado el rol de Supervisor predefinido, debe asignar una o varias listas de control de acceso a los despachadores que cree. Si desea enviar datos para todos los recursos a los que puede acceder, seleccione todas las listas de control de acceso que están asociadas a su disposición. Si es miembro de un grupo al que se ha asignado el rol de Supervisor predefinido, puede elegir enviar los datos para todos los recursos o puede asignar listas de control de acceso para limitar los recursos.

Los filtros de reenvío de datos comunes se utilizan para definir el alcance de los sucesos que desea reenviar, según los códigos de suceso, las clases de suceso, los niveles de gravedad del suceso, los tipos de servicio y el recurso que generó el suceso. Asegúrese de que los filtros de suceso y recurso que desee utilizar para este despachador ya se hayan creado (consulte Creación de filtros de reenvío de datos).

En el siguiente ejemplo se muestra el formato predeterminado para los datos que se reenvían a un servicio web REST. Las palabras entre corchetes dobles son los atributos que se sustituyen con los valores reales cuando se reenvían datos.
{\"msg\":\"[[EventMessage]]\",\"eventID\":\"[[EventID]]\",\"serialnum\":
\"[[EventSerialNumber]]\",\"senderUUID\":\"[[EventSenderUUID]]\",\"flags\":
\"[[EventFlags]]\",\"userid\":\"[[EventUserName]]\",\"localLogID\":
\"[[EventLocalLogID]]\",\"systemName\":\"[[DeviceFullPathName]]\",\"action\":
[[EventActionNumber]],\"failFRUNumbers\":\"[[EventFailFRUs]]\",\"severity\":
[[EventSeverityNumber]],\"sourceID\":\"[[EventSourceUUID]]\",
\"sourceLogSequence\":[[EventSourceLogSequenceNumber]],\"failFRUSNs\":
\"[[EventFailSerialNumbers]]\",\"failFRUUUIDs\":\"[[EventFailFRUUUIDs]]\",
\"eventClass\":[[EventClassNumber]],\"componentID\":\"[[EventComponentUUID]]\",
\"mtm\":\"[[EventMachineTypeModel]]\",\"msgID\":\"[[EventMessageID]]\",
"sequenceNumber\":\"[[EventSequenceID]]\",\"timeStamp\":\"[[EventTimeStamp]]\",
\"args\":[[EventMessageArguments]],\"service\":[[EventServiceNumber]],
\"commonEventID\":\"[[CommonEventID]]\",\"eventDate\":\"[[EventDate]]\"}"

Procedimiento

Para reenviar datos a un servicio web REST, lleve a cabo los pasos siguientes.

  1. En la barra de menú de XClarity Orchestrator, haga clic en Supervisión (Icono de Supervisión) > Reenvío y, luego haga clic en Despachadores de datos en el menú de navegación izquierdo para mostrar la tarjeta Despachadores de datos.
  2. Haga clic en el icono de Crear (Icono de Añadir) para mostrar el cuadro de diálogo Crear despachador de datos.
  3. Especifique el nombre del despachador y una descripción opcional.
  4. Elija habilitar o deshabilitar el despachador haciendo clic en el icono de alternación de Estado.
  5. Seleccione REST como el tipo de despachador.
  6. Haga clic en Configuración y llene la información específica del protocolo.
    • Ingrese el nombre de host o dirección IP del servidor REST.
    • Especifique el puerto que se usará para reenviar sucesos. El valor predeterminado es 80.
    • Ingrese la ruta de acceso de recursos en el que el reenviador publicará los sucesos (por ejemplo, /rest/test).
    • Seleccione el método REST. Puede presentar uno de los valores siguientes.
      • PUT
      • POST
    • Seleccione el protocolo que se utilizará para reenviar sucesos. Puede presentar uno de los valores siguientes.
      • HTTP
      • HTTPS
    • Especifique el período de desconexión (en segundos) para la solicitud. El valor predeterminado es 30 segundos.
    • Si se requiere autenticación, seleccione uno de los siguientes tipos de autenticación.
      • Básico. Se autentica en el servidor especificado usando el Id. de usuario especificado y la contraseña.
      • Token. Se autentica en el servidor especificado usando el nombre de encabezado de token y valor.
  7. Haga clic en Filtros y, opcionalmente, seleccione los filtros que desea utilizar para este despachador.

    Puede seleccionar como máximo un filtro de sucesos y un filtro de recursos.

    Si no selecciona un filtro, los datos se despachan para todos los sucesos generados por todos los recursos (dispositivos, gestores de recursos y XClarity Orchestrator).

    En esta pestaña, también puede elegir reenviar sucesos excluidos configurando el alternador Sucesos excluidos en Sí.

  8. Haga clic en Listas de control de acceso y seleccione una o varias listas de control de acceso que desee asociar con este despachador.

    Si el acceso basado con recursos está habilitado, debe seleccionar al menos una lista de control de acceso.

    Consejo
    De manera opcional, los usuarios que son miembros de un equipo al que se ha asignado el rol de Supervisor predefinido, pueden seleccionar Hacer coincidir todo en lugar de seleccionar una lista de control de acceso de forma que los datos reenviados no se restrinjan.
  9. Haga clic en Crear para crear el despachador.

Después de finalizar

Puede realizar las siguientes acciones desde la tarjeta Despachadores de datos.

  • Habilite o deshabilite un despachador seleccionado seleccionando el conmutador de la columna Estado.
  • Modifique un despachador seleccionado haciendo clic en el icono Editar (Icono Editar).
  • Elimine un despachador seleccionado haciendo clic en el icono Eliminar (Icono Eliminar).