Skip to main content

Data forwarders

Lenovo XClarity One can forward data about events that occur in your environment, based on criteria (filters) that you select, to external services that you can then use to monitor and analyze the data. Every generated event is monitored to see if it matches the criteria. If it matches, the event is forwarded to the specified destination using the appropriate protocol.

To create a data forwarder, click Data forwarding in the context menu of the Settings view, click the Add icon (Add icon), and then follow instructions in the wizard.

Important
Only the organization owners can create, modify and delete data forwarders.

You can test the connection to the external service from the Configure tab in the wizard before saving the data forwarder. When you click Test connection, a test event is sent using the provided configuration settings.

Event criteria

Use the search field to choose the events to forward based on the following types of criteria. If you do not provide criteria, data is forwarded for all events that are generated by all resources (managed devices, management hubs, and XClarity One portal).
  • Name of resources and device components that generated the events
  • Event severity

Forwarder destinations

You can forward event data to the following destinations.
  • Email

    For XClarity One in the cloud, you can forward event data to email addresses for one or more users in the organization. You cannot forward event data to external users.

    New events that match the selected criteria are forwarded via email every hour. The emails are sent from noreply@xc1mail.lenovo.com with the subject “Buffered Event Forwarding.”

    Tip
    If you change the filter criteria for the forwarder, events that were buffered before the changes were saved will match the previous filter criteria, and events that were buffered after the changes were saved will match the latest filter criteria. So, the email that is sent after the changes were save might have some events that match the previous filter criteria.

    Events are listed in tabular format, one row per event.

  • Web service

    You can forward event data to ServiceNow Cloud. Other user-defined REST web services are not supported.

    New events that match the selected criteria are forwarded over the network to the web service as soon as the events are raised, using the HTTPS protocol. Port 443 is used by default.

    Attention
    • Ensure that ServiceNow Cloud is configured to accept valid incoming traffic.
    • Ensure that ServiceNow Cloud uses a trusted CA-signed certificate. Self-signed certificates are not supported.
    • Ensure that you test the connection to the web service by clicking Test Connection in the Data Forwarder wizard. During the test-connection process, XClarity One imports and validates the certificate chain from the web service. After the certificate is validated, XClarity One sends a sample event to the web service.
    Events are forwarded in JSON format. The following example shows event data that is forwarded to an email or web service.
    {
    "id": 3395,
    "action": "new",
    "category": "drives",
    "description": "When a hardware event is detected by the Lenovo XClarity Controller on the
    server, the Lenovo XClarity Controller writes that event in the system-event
    log on the server.",
    "eventClass": "service",
    "eventCode": "FQXSPSD0001L",
    "flags": [],
    "fruType": "drives",
    "manager": {
    "id": "B0018518B16549398A088862CAF1F705",
    "ipAddress": "10.241.36.230",
    "name": "DEV HUB 2757",
    "type": "XClarity Management Hub"
    },
    "message": "Drive Drive 0 in the enclosure has been disabled due to a detected fault.",
    "messageArgs": [ "Drive 0" ],
    "service": "serviceable",
    "severity": "critical",
    "source": {
    "id": "AE9FBDFA62F911E988453A68DD01A3F7-B0018518B16549398A088862CAF1F705",
    "groups": [],
    "name": "J100CVZW",
    "type": "server"
    },
    "targetResource": {
    "id": "AE9FBDFA62F911E988453A68DD01A3F7-B0018518B16549398A088862CAF1F705",
    "groups": [],
    "name": "J100CVZW",
    "type": "server"
    },
    "timestamp": "2025-02-18T12:32:06.419Z",
    "userAction": "Complete the following steps until the problem is solved: \n1) Reboot the system
    and confirm that the drive is still in failed state.\n2) Collect Service Data
    log.\n3) Contact Lenovo Support.",
    "_links": {
    "rel": "self",
    "uri": "/api/v1/monitoring/events/3395"
    }
    }