Pular para o conteúdo principal

Encaminhando eventos para um serviço Web REST

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

Antes de iniciar

Atenção
Uma conexão segura não é estabelecida ao encaminhar dados para esse serviço. Os dados são enviados por um protocolo de texto claro.

Sobre esta tarefa

Se o controle de acesso baseado em recursos estiver ativado, os dados serão encaminhados apenas para os recursos que você pode acessar usando listas de controle de acesso. Se você não for um membro de um grupo ao qual a função predefinida de Supervisor é atribuída, deverá atribuir uma ou mais listas de controle de acesso aos encaminhadores que você criar. Se desejar enviar dados para todos os recursos que você pode acessar, selecione todas as listas de controle de acesso associadas que estão disponíveis para você. Se você for um membro de um grupo ao qual a função predefinida de Supervisor é atribuída, poderá optar por enviar dados para todos os recursos ou por atribuir listas de controle de acesso para limitar os recursos.

Os filtros de encaminhamento de dados são usados para definir o escopo de eventos que você deseja encaminhar, com base em códigos de evento, classes de evento, severidades de evento, tipos de serviço e no recurso que gerou o evento. Certifique-se de que os filtros de eventos e de recursos que você deseja usar para este encaminhador já estejam criados (consulte Criando filtros de encaminhamento de dados).

O exemplo a seguir mostra o formato padrão dos dados encaminhados para um serviço da Web REST. Palavras entre colchetes duplos são atributos substituídos por valores reais quando os dados são encaminhados.
{\"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]]\"}"

Procedimento

Para encaminhar dados a um serviço Web REST, conclua as seguintes etapas.

  1. Na barra de menus do XClarity Orchestrator, clique em Monitoramento (Ícone de Monitoramento) > Encaminhamento e clique em Encaminhadores de Dados na navegação esquerda para exibir o cartão Encaminhadores de Dados.
  2. Clique no ícone Criar (Ícone de Adicionar) para exibir a caixa de diálogo Criar Encaminhador de Dados.
  3. Especifique o nome do encaminhador e a descrição opcional.
  4. Escolha para habilitar ou desabilitar o encaminhador clicando no botão de alternância Estado.
  5. Selecione REST como o tipo de encaminhador.
  6. Clique em Configuração e preencha as informações específicas do protocolo.
    • Inclua o nome do host ou o endereço IP do servidor REST.
    • Insira a porta a ser usada para o encaminhamento de eventos. O padrão é 80.
    • Insira o caminho do recurso em que o encaminhador deve publicar os eventos (por exemplo, /rest/test).
    • Selecione o método REST. Este pode ser um dos valores a seguir.
      • PUT
      • POST
    • Selecione o protocolo a ser usado para o encaminhamento de eventos. Este pode ser um dos valores a seguir.
      • HTTP
      • HTTPS
    • Insira o período de tempo limite (em segundos) para a solicitação. O padrão é 30 segundos.
    • 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.
      • Token. Autentica para o servidor especificado usando o nome de cabeçalho e valor do token especificado.
  7. Clique em Filtros e, como opção, selecione os filtros que você deseja usar para este encaminhador.

    É possível selecionar no máximo um filtro de eventos e um filtro de recursos.

    Se você não selecionar um filtro, os dados serão encaminhados para todos os eventos gerados por todos os recursos (dispositivos, gerenciadores de recursos e o XClarity Orchestrator).

    Nessa guia, também é possível optar por encaminhar o evento excluído definindo o botão de alternância Eventos Excluídos como Sim.

  8. Clique em Listas de controle de acesso e selecione uma ou mais listas de controle de acesso que você deseja associar a esse encaminhador.

    Se o acesso baseado em recursos estiver habilitado, você deverá selecionar pelo menos uma lista de controle de acesso.

    Dica
    como opção, os usuários que são membros de um grupo ao qual a função predefinida de Supervisor é atribuída podem selecionar Associar tudo em vez de selecionar listas de controle de acesso para que os dados encaminhados não sejam restritos.
  9. Clique em Criar para criar o encaminhador.

Depois de concluir

Você pode executar as seguintes ações no cartão Encaminhadores de Dados.

  • Ative ou desative um encaminhador selecionado clicando no botão de alternância na coluna Estado
  • Modifique um encaminhador selecionado clicando no ícone Editar (Ícone de Editar).
  • Remova um encaminhador selecionado clicando no ícone Excluir (Ícone de Excluir).