Skip to main content

Forwarding events to a REST web service

You can configure Lenovo XClarity Orchestrator to forward specific events to a REST web service.

Before you begin

Attention
A secure connection is not established when forwarding data to this service. Data is sent over a clear text protocol.

About this task

If resource-based access control is enabled, data is forwarded for only those resources that you can access using access-control lists. If you are not a member of a group to which the predefined Supervisor role is assigned, you must assign one or more access-control lists to the forwarders that you create. If you want to send data for all resources that you can access, select all access-control lists that are associated that are available to you. If you are a member of a group to which the predefined Supervisor role is assigned, you can choose to send data for all resources, or you can choose to assign access control lists to limit the resources.

Common data-forwarding filters are used to define the scope of events that you want to forward, based on event codes, event classes, event severities, service types, and resource that generated the event. Ensure that the event and resource filters that you want to use for this forwarder are already created (see Creating data-forwarding filters).

The following example shows the default format for data that is forwarded to a REST web service. Words between double square brackets are attributes that are replaced with actual values when data is forwarded.
{\"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]]\"}"

Procedure

To forward data to a REST web service, complete the following steps.

  1. From the XClarity Orchestrator menu bar, click Monitoring (Monitoring icon) > Forwarding, and then click Data Forwarders in the left navigation to display the Data Forwarders card.
  2. Click the Create icon (Add icon) to display the Create Data Forwarder dialog.
  3. Specify the forwarder name and optional description.
  4. Choose to enable or disable the forwarder by clicking the State toggle.
  5. Select REST as the forwarder type.
  6. Click Configuration, and fill in the protocol-specific information.
    • Enter the hostname or IP address of the REST server.
    • Enter the port to use for forwarding events. The default is 80.
    • Enter the resource path on which the forwarder is to post the events (for example, /rest/test).
    • Select the REST method. This can be one of the following values.
      • PUT
      • POST
    • Select the protocol to use for forwarding events. This can be one of the following values.
      • HTTP
      • HTTPS
    • Enter the time-out period (in seconds) for the request. Default is 30 seconds.
    • If authentication is required, select one of the following authentication types.
      • Basic. Authenticates to the specified server using the specified user ID and password.
      • Token. Authenticates to the specified server using the specified token header name and value.
  7. Click Filters, and optionally select the filters that you want to use for this forwarder.

    You can select at most one event filter and one resource filter.

    If you do not select a filter, data is forwarded for all events that are generated by all resources (devices, resource managers, and XClarity Orchestrator).

    From this tab, you can also choose to forward excluded event by setting the Excluded Events toggle to Yes.

  8. Click Access Control Lists, and select one or more access-control lists that you want to associated with this forwarder.

    If resource-based access is enabled, you must select at least one access-control list.

    Tip
    Users that are members of a group to which the predefined Supervisor role is assigned can optionally select Match Everything instead of selecting an access control lists so that forwarded data is not restricted.
  9. Click Create to create the forwarder.

After you finish

You can perform the following actions from the Data Forwarders card.

  • Enable or disable a selected forwarder by selecting the toggle in the State column
  • Modify a selected forwarder by clicking the Edit icon (Edit icon).
  • Remove a selected forwarder by clicking the Delete icon (Delete icon).