Configurando o encaminhamento de evento em um serviço Web REST

É possível configurar o Lenovo XClarity Administrator para encaminhar eventos específicos a um serviço da Web REST.

Procedimento

Conclua as etapas a seguir para criar um encaminhador de evento para um serviço Web REST.

1. Na barra de menu do XClarity Administrator, clique em Monitoramento > Encaminhamento de Evento. A página Encaminhamento de Evento é exibida.
2. Clique na guia Encaminhamento de eventos.
3. Clique no ícone Criar (). A guia Geral da caixa de diálogo Novo Encaminhador de Evento é exibida.
4. Selecione REST como o tipo de encaminhador de evento e preencha as informações específicas do protocolo:

   • Insira o caminho do recurso em que o encaminhador deve publicar os eventos (por exemplo, /rest/test).

   • Selecione o protocolo a ser usado para o encaminhamento de eventos. Este pode ser um dos valores a seguir.

     • HTTP

     • HTTPS

   • Selecione o método REST. Este pode ser um dos valores a seguir.

     • PUT

     • POST

   • Insira o período de tempo limite (em segundos) para a solicitação. O padrão é 30 segundos.

   • Opcional: Se a autenticação for necessária, selecione um dos tipos de autenticação a seguir:

     • Básico. Autentica ao servidor especificado usando o ID do usuário e senha especificados.

     • Nenhum. Nenhuma autenticação é usada.

5. Clique em Formato de saída para escolher o formato de saída dos dados de evento a serem encaminhados. As informações variam para cada tipo de encaminhador de evento.

   O formato de saída de exemplo a seguir é o formato padrão para destinatários do serviço Web REST. Todas as palavras entre colchetes duplos são as variáveis que são substituídas por valores reais quando um evento é encaminhado. As variáveis disponíveis para destinatários do serviço Web REST estão listadas na caixa de diálogo Formato de Saída.

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

   É possível clicar em Redefinir para padrões para alterar o formato de saída novamente para os campos padrão.
6. Clique no botão de alternância Permitir Eventos Excluídos para permitir ou impedir que o evento excluído seja encaminhado.
7. Selecione Habilitar este encaminhador para ativar o encaminhamento de eventos para esse encaminhador.
8. Clique em Avançar para exibir a guia Dispositivos.
9. Selecione os dispositivos e os grupos que deseja monitorar para este encaminhador de evento.
   Dica

   para encaminhar eventos para todos os dispositivos gerenciados (atuais e futuros), marque a caixa de seleção Combinar todos os sistemas.

   Se você não marcar a caixa de seleção Combinar todos os sistemas, certifique-se que os dispositivos selecionados não tenham um DUMMY-UUID na coluna UUID. Um Dummy-UUID é atribuído para dispositivos que ainda não se recuperaram após uma reinicialização ou não foram totalmente descobertos pelo servidor de gerenciamento. Se você selecionar um dispositivo com um Dummy-UUID, o encaminhamento de evento funcionará para este dispositivo até o ponto quando o dispositivo for descoberto ou recuperado, e o Dummy-UUID é alterado para o UUID real.

10. Clique em Avançar para exibir a guia Eventos.
11. Selecione os filtros a serem usados para este encaminhador de evento.

    • Fazer a correspondência por categoria de evento.

      1. Para encaminhar todos os eventos de auditoria independentemente do nível de status, selecione Inclui todos os eventos de Auditoria.

      2. Para encaminhar todos os eventos de garantia, selecione Inclui eventos de Garantia.

      3. Para encaminhar todos os eventos de alteração de status de funcionamento, selecione Incluir eventos de alteração de status.

      4. Para encaminhar todos os eventos de atualização de status de funcionamento, selecione Incluir eventos de atualização de status.

      5. Selecione o nível de classes e capacidade de manutenção de evento que você deseja encaminhar.

      6. Insira os IDs para um ou mais eventos que você deseja que o encaminhamento seja excluído. Separe os IDs usando uma vírgula (por exemplo, FQXHMEM0214I,FQXHMEM0214I).

    • Faça a correspondência por código de evento. Insira os IDs de um ou mais eventos que você deseja encaminhar. Separe diversos IDs usando uma vírgula.

    • Excluir por categoria de evento.

      1. Para excluir todos os eventos de auditoria independentemente do nível de status, selecione Excluir todos os eventos de Auditoria.

      2. Para excluir todos os eventos de garantia, selecione Excluir eventos de Garantia.

      3. Para excluir todos os eventos de alteração de status de funcionamento, selecione Excluir eventos de alteração de status.

      4. Para excluir todos os eventos de atualização de status de funcionamento, selecione Excluir eventos de atualização de status.

      5. Selecione o nível de classes e capacidade de manutenção de evento que você deseja excluir.

      6. Insira os IDs de um ou mais eventos que você deseja encaminhar. Separe os IDs usando uma vírgula.

    • Exclua por código de evento. Insira os IDs de um ou mais eventos que você deseja excluir. Separe diversos IDs usando uma vírgula.

12. Decida se deve incluir determinados tipos de eventos.

    • Incluir Todos os Eventos de Auditoria. Envia notificações sobre eventos de auditoria, com base nas classes de eventos e gravidades selecionadas.

    • Incluir eventos de Garantia. Envia notificações sobre garantias.

    • Incluir eventos de alteração de status. Envia notificações sobre alterações no status.

    • Incluir eventos de atualização de status. Enviou notificações sobre novos alertas.

    • Incluir eventos do boletim. Envia notificação sobre novos boletins.

13. Selecione os tipos de eventos e as gravidades sobre os quais deseja ser notificado.
14. Selecione se deve filtrar eventos por capacidade de manutenção.
15. Clique em Avançar para exibir a guia Planejador.
16. Opcional: Defina a hora e os dias em que deseja que os eventos especificados sejam encaminhados para este encaminhador de evento. Apenas eventos que ocorrem durante o slot de tempo especificado são encaminhados.

    Se você não criar um planejamento para o encaminhador de evento, os eventos serão encaminhados 24h por dia/7 dias por semana.

    1. Use o ícone Rolar para a esquerda () e o ícone Rolar para a direita (), e os botões Dia, Semana e Mês para localizar o dia e a hora em que você deseja iniciar o planejamento.

    2. Clique duas vezes no slot de tempo para abrir a caixa de diálogo Novo Período de Tempo.

    3. Preencha as informações necessárias, incluindo a data e a hora de início e encerramento, e se está planejado para ocorrer novamente.

    4. Clique em Criar para salvar o planejamento e fechar a caixa de diálogo. O novo planejamento é incluído no calendário.

    Dicas

    • É possível alterar o período arrastando a entrada de programação para outro período no calendário.

    • É possível alterar a duração selecionando o início ou o fim da entrada da programação e arrastando para o novo horário no calendário.

    • É possível alterar o horário de encerramento selecionando o fim da entrada da programação e arrastando para o novo horário no calendário.

    • É possível alterar uma programação clicando duas vezes na entrada da programação no calendário e clicando em Editar Entrada.

    • É possível exibir um resumo de todas as entradas da programação selecionando Mostrar Resumo do Planejador. O resumo inclui o período de cada entrada e quais entradas são repetíveis.

    • É possível excluir uma entrada da programação do calendário ou do resumo planejador selecionando a entrada e clicando em Excluir Entrada.

17. Clique em Criar.

    O encaminhador de evento está listado na tabela Encaminhamento de Evento.

    
    
    
18. Selecione o novo encaminhador de evento, clique em Gerar Evento de Teste e verifique se os eventos foram encaminhados corretamente para o serviço Web REST apropriado.