Skip to main content

Forwarding metrics data to a Lenovo TruScale Infrastructure Services

You can configure Lenovo XClarity Orchestrator to forward metrics (telemetry) data to a Lenovo TruScale Infrastructure Services.

Before you begin

Attention
These configuration steps are intended only for Lenovo Service representatives.

A secure connection is established when forwarding data to TruScale Infrastructure Services.

Ensure that the XClarity Orchestrator is running v1.2.0 or later.

Ensure that the Lenovo XClarity Administrator resource managers that manage the devices for which you want to forward metrics data are running v3.0.0 plus the fix pack or later.

Ensure that the appropriate XClarity Administrator resource managers are connected to XClarity Orchestrator (see Connecting resource managers).

Ensure that the devices for which you want to forward metrics data are running the latest Lenovo XClarity Controller firmware (see Applying and activating updates to resource managers).

Ensure that the data and time settings are configured correctly in the following resources.

Ensure that the networking settings in XClarity Orchestrator are configured correctly (see Configuring network settings).

Ensure that metrics data is being collected for the managed devices by viewing the utilization graphs on the device summary page (see Viewing device details). If metrics data is not displayed, see Troubleshooting data forwarding issues.

To learn more about Lenovo TruScale Infrastructure Services, see the TruScale Infrastructure Services website.

About this task

You can define multiple Lenovo TruScale Infrastructure Services configurations; however, XClarity Orchestrator can forward events to only one Lenovo TruScale Infrastructure Services instance. Therefore, only one Lenovo TruScale Infrastructure Services configuration can be enabled at a time.

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.

You cannot filter data that is forwarded to a Lenovo TruScale Infrastructure Services.

The following example shows the default format for data that is forwarded to a Lenovo TruScale Infrastructure Services. 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 Lenovo TruScale Infrastructure Services, complete the following steps.

  1. Add the trusted SSL certificates that is provided by the Lenovo TruScale Infrastructure Services.
    1. From the XClarity Orchestrator menu bar, click XClarity Orchestrator menu bar, click Administration (Administration icon) > Security, and then click Trusted Certificates in the left navigation to display the Trusted Certificates card.
    2. Click the Add icon (Add icon) to add a certificate. The Add Certificate dialog is displayed.
    3. Copy and paste the certificate data in PEM format.
    4. Click Add.
  2. 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.
  3. Click the Create icon (Add icon) to display the Create Data Forwarder dialog.
  4. Specify the forwarder name and optional description.
  5. Choose to enable or disable the forwarder by clicking the State toggle.
  6. Select TruScale Infrastructure Services as the forwarder type.
  7. Click Configuration, and fill in the protocol-specific information.
    • Enter the hostname or IP address of the TruScale Infrastructure Service.
    • Enter the port to use for forwarding events. The default is 9092.
    • Optionally enter the frequency, in minutes, when data is pushed. The default is 60 minutes.
    • Enter the topic name.
    • Enter the time-out period (in seconds) for the request. Default is 300 seconds.
  8. Click Validate Connection to ensure that a connection can be established based on the configuration.
    Attention
    Validating the connection might take several minutes to complete. You can close the pop-up message and continue creating the forwarder without disrupting the validation process. When the validation completes, another popup message is displayed to notify you whether the connection is successful.
  9. 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.
  10. 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).