Saltar al contenido principal

Configuración del reenvío de sucesos a un servicio web REST

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

Acerca de esta tarea

Puede crear y habilitar hasta 20 despachadores de sucesos para enviar sucesos a destinatarios específicos.

Si XClarity Administrator se reinicia después de configurar los despachadores de sucesos, debe esperar que el servidor de gestión vuelva a generar los datos internos antes de que se puedan reenviar correctamente los sucesos.

Nota
Para la XClarity Administrator versión 1.2.0 y posteriores, Conmutadores se incluye en la pestaña Sucesos de los cuadros de diálogo Nuevo despachador de sucesos y Cambiar despachadores de sucesos. Si se actualizó a 1.2.0 o posterior a partir de una versión anterior, recuerde actualizar los despachadores de sucesos para incluir o excluir sucesos de RackSwitch, según corresponda. Esto es necesario, incluso si seleccionó la casilla de verificación Todos los sistemas para seleccionar todos los dispositivos.

Procedimiento

Realice los siguientes pasos para crear un despachador de sucesos para un servidor web REST.

  1. En la barra de menús de XClarity Administrator, haga clic en Supervisión > Reenvío de sucesos. Se muestra la página Reenvío de sucesos.
  2. Haga clic en la pestaña Despachador de sucesos.
  3. Haga clic en el icono Crear (Icono Crear). Se abre la pestaña General del cuadro de diálogo Nuevo despachador de sucesos.
  4. Seleccione REST como tipo de despachador de sucesos y rellene la información específica del protocolo:
    • Ingrese la ruta de acceso de recursos en el que el reenviador publicará los sucesos (por ejemplo, /rest/test).

    • Seleccione el protocolo que se utilizará para reenviar sucesos. Puede presentar uno de los valores siguientes.
      • HTTP

      • HTTPS

    • Seleccione el método REST. Puede presentar uno de los valores siguientes.

      • PUT

      • POST

    • Especifique el período de desconexión (en segundos) para la solicitud. El valor predeterminado es 30 segundos.

    • Opcional: 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.

      • Ninguno. No se utiliza ninguna autenticación.

  5. Haga clic en Formato de salida para elegir el formato de salida de los datos de sucesos que se reenviarán. La información varía según el tipo de despachador de sucesos.

    El siguiente formato de salida de ejemplo es el formato predeterminado para los destinatarios de servicio web REST. Todas las palabras entre corchetes dobles son las variables que se sustituyen con los valores reales cuando se despacha un suceso. Las variables disponibles para los destinatarios del servicio web REST se enumeran el cuadro de diálogo Formato de salida.

    {\"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]]\"}"

    Puede hacer clic en Restablecer valores predeterminados para cambiar el formato de salida a los campos predeterminados.

  6. Seleccione Permitir sucesos excluidos para evitar que los sucesos excluidos se reenvíen o borre Permitir sucesos excluidos para reenviar sucesos excluidos. Para obtener más información, consulte el apartado Exclusión de sucesos.
  7. Seleccione Habilitar este despachador para activar el reenvío de sucesos para este despachador de sucesos.
  8. Pulse Siguiente para mostrar la pestaña Dispositivos.
  9. Seleccione los dispositivos y grupos que desee supervisar para este despachador de sucesos.
    Consejo
    Para reenviar sucesos de todos los dispositivos gestionados (actuales y futuros), seleccione la casilla de verificación Igualar todos los sistemas.

    Si no selecciona la casilla Igualar todos los sistemas, asegúrese de que los dispositivos seleccionados no tengan un DUMMY-UUID en la columna UUID. Se asigna un Dummy-UUID a los dispositivos que aún no se recuperan después de un reinicio o no han sido detectados completamente por el servidor de gestión. Si selecciona un dispositivo con un Dummy-UUID, el reenvío de sucesos no funcionará para este dispositivo hasta que el dispositivo sea completamente detectado o recuperado y el Dummy-UUID cambie a su UUID real.

  10. Haga clic en Siguiente para mostrar la pestaña Sucesos.
  11. Seleccione los filtros que se utilizarán para este despachador de sucesos.
    • Asociar por categoría de suceso
      1. Para reenviar todos los sucesos de auditoría, sin importar el nivel de estado, seleccione Incluir todos los sucesos de auditoría.
      2. Para reenviar todos los sucesos de garantía, seleccione la opción Incluir los sucesos de garantía.
      3. Para volver a enviar todos los sucesos de cambio de estado y salud, seleccione Incluir los sucesos de cambio de estado.
      4. Para volver a enviar todos los sucesos de actualización de estado y salud, seleccione Incluir los sucesos de actualización de estado.
      5. Seleccione las clases de sucesos y niveles de capacidad de servicio que desee reenviar.
      6. Introduzca el Id. de uno o varios sucesos que desea excluir de reenvío. Separe los identificadores utilizando una coma (por ejemplo, FQXHMEM0214I,FQXHMEM0214I).
    • Coincidir por el código de suceso. Introduzca el Id. de uno o varios sucesos que desee reenviar. Separe los identificadores entre sí mediante comas.
    • Excluir por categorías de sucesos.
      1. Para excluir todos los sucesos de auditoría, sin importar el nivel de estado, seleccione Excluir todos los sucesos de auditoría.
      2. Para excluir todos los sucesos de garantía, seleccione la opción Excluir los sucesos de garantía.
      3. Para excluir todos los sucesos de cambio de estado y salud, seleccione Excluir los sucesos de cambio de estado.
      4. Para excluir todos los sucesos de actualización de estado y salud, seleccione Excluir los sucesos de actualización de estado.
      5. Seleccione las clases de sucesos y niveles de capacidad de servicio que desee excluir.
      6. Introduzca el Id. de uno o varios sucesos que desee reenviar. Separe los identificadores utilizando una coma.
    • Excluir por el código de suceso. Introduzca el Id. de uno o varios sucesos que desee excluir. Separe los identificadores entre sí mediante comas.
  12. Elija si se deben incluir determinados tipos de sucesos.
    • Incluir todos los sucesos de auditoría. Envía notificaciones sobre sucesos de auditoría, según las clases y gravedades de los sucesos seleccionados.
    • Incluir sucesos de garantía. Enviar notificaciones sobre garantías.
    • Incluye sucesos de cambio de estado. Envía notificaciones sobre cambios de estado.
    • Incluye sucesos de actualización de estado. Se enviaron notificaciones sobre nuevas alertas
    • Incluir sucesos del boletín. Envía notificaciones sobre boletines nuevos.
  13. Seleccione los tipos de sucesos y niveles de gravedad por los que desea que se le notifique.
  14. Seleccione si se deben filtrar sucesos por capacidad de servicio.
  15. Haga clic en Siguiente para mostrar la pestaña Programador.
  16. Opcional: defina las horas y los días en los que desea que se reenvíen sucesos específicos a este despachador de sucesos. Solo se reenvían los sucesos que se producen durante el periodo de tiempo especificado.

    Si no crea una planificación para el despachador de sucesos, los sucesos se reenviarán las 24 horas del día, 7 días a la semana.

    1. Use el icono Desplazar a la izquierda (Icono Desplazar a la izquierda) y el icono Desplazar a la derecha (Icono Desplazar a la derecha) y los botones Día, Semana y Mes para determinar el día y la hora a la que desea que comience la planificación.
    2. Haga clic en dos veces la hora para abrir el cuadro de diálogo Nuevo periodo de tiempo.
    3. Complete la información requerida, incluida la fecha, horas de inicio y término y si desea que se repita la programación.
    4. Haga clic en Crear para guardar la planificación y cerrar el cuadro de diálogo. La nueva planificación se añade al calendario.
    Consejos
    • Puede cambiar la hora arrastrando la entrada de programación hacia otra hora en el calendario.
    • Puede cambiar la duración al seleccionar la parte superior o inferior de la entrada de programación y arrastrarla hacia la nueva hora en el calendario.
    • Puede cambiar la hora de término al seleccionar la parte inferior de la entrada de programación y arrastrarla hacia la nueva hora en el calendario.
    • Puede cambiar la programación al pulsar dos veces la entrada de programación en el calendario y pulsar Editar entrada.
    • Se puede visualizar un resumen de todas las entradas de programación al seleccionar Mostrar resumen del planificador. El resumen incluye los espacios de tiempo de cada entrada y las entradas que se repiten.
    • Puede eliminar una entrada de programación del calendario o resumen de programador seleccionando la entrada y haciendo clic en Eliminar entrada.
  17. Haga clic en Crear.

    El despachador de sucesos aparecerá en la tabla Reenvío de sucesos.


    Muestra el cuadro de diálogo Reenvío de sucesos, en el que se incluye la lista de despachadores de los sucesos.
  18. Seleccione el nuevo despachador de sucesos, haga clic en Generar suceso de prueba y luego compruebe que el reenvío de sucesos se realice correctamente al servicio web REST correspondiente.

Después de finalizar

Desde la página Reenvío de sucesos, también puede realizar las acciones siguientes en un despachador de sucesos:
  • Actualizar la lista de despachadores de sucesos haciendo clic en el icono Actualizar (Icono Actualizar).
  • Ver los detalles de un despachador de sucesos pulsando el vínculo de la columna Nombre.
  • Cambiar las propiedades de los despachadores de sucesos y filtrar los criterios pulsando el nombre del despachador de sucesos en la columna Nombre.
  • Eliminar el despachador de sucesos haciendo clic en el icono Eliminar (Icono Eliminar).
  • Suspender el reenvío de sucesos (consulte Suspensión del reenvío de sucesos).