Passa al contenuto principale

Inoltro di eventi a un servizio Web REST

È possibile configurare Lenovo XClarity Orchestrator in modo che inoltri eventi specifici a un servizio Web REST.

Prima di iniziare

Attenzione
Non viene stabilita una connessione sicura durante l'inoltro dei dati a questo servizio. I dati vengono inviati tramite un protocollo in testo semplice.

Informazioni su questa attività

Se il controllo degli accessi basato sulle risorse è abilitato, i dati vengono inoltrati solo per le risorse accessibili mediante gli elenchi di controllo degli accessi. Se non si è un membro di un gruppo a cui è assegnato il ruolo predefinito di Supervisore, è necessario assegnare uno o più elenchi di controllo degli accessi ai server d'inoltro creati. Se si desidera inviare i dati per tutte le risorse a cui è possibile accedere, selezionare tutti gli elenchi di controllo degli accessi associati disponibili. Se si è un membro di un gruppo a cui è assegnato il ruolo predefinito di Supervisore, è possibile scegliere di inviare i dati per tutte le risorse oppure di assegnare gli elenchi di controllo degli accessi per limitare le risorse.

I comuni filtri per i server d'inoltro dei dati vengono utilizzati per definire l'ambito degli eventi che si desidera inoltrare, in base ai codici, alle classi e alla gravità degli eventi, nonché ai tipi di servizio e alla risorsa che ha generato l'evento. Verificare che i filtri eventi e per risorsa da utilizzare per questo server d'inoltro dei dati siano già stati creati (vedere Creazione di filtri di inoltro dei dati).

L'esempio che segue mostra il formato predefinito dei dati inoltrati a un servizio Web REST. Le parole tra parentesi quadre doppie sono attributi che vengono sostituiti con i valori effettivi quando i dati vengono inoltrati.
{\"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]]\"}"

Procedura

Per inoltrare dati a un servizio Web REST, effettuare le operazioni che seguono.

  1. Dalla barra del menu di XClarity Orchestrator fare clic su Monitoraggio (Icona Monitoraggio) > Inoltro eventi, quindi su Server d'inoltro dei dati nel riquadro di navigazione sinistro per visualizzare la scheda Server d'inoltro dei dati.
  2. Fare clic sull'icona Crea (Icona Aggiungi) per visualizzare la finestra di dialogo Crea server d'inoltro dei dati.
  3. Specificare il nome del server d'inoltro e la descrizione facoltativa.
  4. Scegliere di abilitare o disabilitare il server d'inoltro facendo clic sull'interruttore Stato.
  5. Selezionare REST come tipo di server d'inoltro.
  6. Fare clic su Configurazionee immettere le informazioni specifiche del protocollo.
    • Immettere il nome host o l'indirizzo IP del server REST.
    • Immettere la porta da utilizzare per l'inoltro di eventi. Il valore predefinito è 80.
    • Immettere il percorso della risorsa in cui il server d'inoltro pubblicherà gli eventi (ad esempio, /rest/test).
    • Selezionare il metodo REST. È possibile selezionare uno dei seguenti valori.
      • PUT
      • POST
    • Selezionare il protocollo da utilizzare per l'inoltro di eventi. È possibile selezionare uno dei seguenti valori.
      • HTTP
      • HTTPS
    • Immettere il periodo di timeout (in secondi) per la richiesta. Il valore predefinito è 30 secondi.
    • Se l'autenticazione è obbligatoria, selezionare uno dei tipi di autenticazione che seguono.
      • Base. Esegue l'autenticazione server specificato utilizzando l'ID utente e la password specificati.
      • Token. Esegue l'autenticazione al server specificato utilizzando il nome e il valore dell'intestazione del token.
  7. Fare clic su Filtri e, facoltativamente, selezionare i filtri da utilizzare per questo server d'inoltro.

    È possibile selezionare al massimo un filtro eventi e un filtro per risorsa.

    Se non si seleziona un filtro, i dati vengono inoltrati per tutti gli eventi generati da tutte le risorse (dispositivi, strumenti di gestione delle risorse e XClarity Orchestrator).

    Da questa scheda è anche possibile scegliere di inoltrare l'evento escluso impostando l'interruttore Eventi esclusi su Sì.

  8. Fare clic su Elenchi di controllo accessi e selezionare uno o più elenchi di controllo degli accessi che si desidera associare a questo server d'inoltro.

    Se l'accesso basato sulle risorse è abilitato, è necessario selezionare almeno un elenco di controllo degli accessi.

    Suggerimento
    gli utenti che sono membri di un gruppo a cui è assegnato il ruolo predefinito di Supervisore possono selezionare facoltativamente Associa tutto invece di selezionare gli elenchi di controllo degli accesso, in modo che i dati inoltrati non siano limitati.
  9. Fare clic su Crea per creare il server d'inoltro.

Al termine

Nella scheda Server d'inoltro dei dati è possibile effettuare le operazioni che seguono.

  • Abilitare o disabilitare un server d'inoltro specifico selezionando l'interruttore nella colonna Stato.
  • Modificare un server d'inoltro selezionato facendo clic sull'icona Modifica (Icona Modifica).
  • Rimuovere un server d'inoltro selezionato facendo clic sull'icona Elimina (Icona Elimina).