将事件转发到 REST Web 服务

可配置 Lenovo XClarity Orchestrator 以将特定事件转发到 REST Web 服务。

开始之前

注意

将数据转发到此服务时不会建立安全连接。数据会通过明文协议发送。

关于本任务

如果启用了基于资源的访问控制，则仅转发您可以使用访问控制列表访问的资源的数据。如果您不在分配了预定义主管角色的组内，则您必须为所创建的转发器分配一个或多个访问控制列表。如果要发送您可以访问的所有资源的数据，请选择所有您可以使用的相关访问控制列表。如果您在分配了预定义主管角色的组内，则既可以选择发送所有资源的数据，也可以选择分配访问控制列表以限制资源。

通用数据转发筛选条件 用于根据事件代码、事件类、事件严重性、服务类型和生成事件的资源来定义要转发的事件范围。确保已创建用于此转发器的事件和资源筛选条件（请参阅创建数据转发筛选条件）。

以下示例显示了转发到 REST Web 服务的数据的默认格式。双重方括号之间的单词均为转发数据时替换为实际值的属性。

{\"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]]\"}"

过程

要将数据转发到 REST Web 服务，请完成以下步骤。

从 XClarity Orchestrator 菜单栏中，单击监控（） > 转发，然后单击左侧导航栏中的数据转发器以显示“数据转发器”卡。
单击创建图标（）以显示“创建数据转发器”对话框。
指定转发器的名称和可选描述。
单击状态切换开关选择启用或禁用转发器。
选择 REST 作为转发器类型。
单击配置，并填写协议特定的信息。
- 输入 REST 服务器的主机名或 IP 地址。
- 输入用于转发事件的端口。默认值为 80。
- 输入转发器用于发布事件的资源路径（例如，/rest/test）。
- 选择 REST 方法。此项可以是以下某个值。
  - PUT
  - POST
- 选择用于转发事件的协议。此项可以是以下某个值。
  - HTTP
  - HTTPS
- 输入请求的超时时间段（以秒为单位）。默认值为 30 秒。
- 如果需要认证，选择以下认证类型之一。
  - 基本。使用指定用户标识和密码向指定服务器进行认证。
  - 令牌。使用指定的令牌标头名称和值向指定的服务器进行认证。
单击筛选条件，并（可选）选择用于此转发器的筛选条件。
最多可选择一个事件筛选条件和一个资源筛选条件。
如果未选择筛选条件，则将转发所有资源（设备、资源管理器和 XClarity Orchestrator）生成的所有事件的数据。
从此选项卡中，还可以将排除的事件切换开关设置为是以转发排除的事件。
单击访问控制列表，然后选择要与此转发器关联的一个或多个访问控制列表。
如果启用了基于资源的访问，则必须至少选择一个访问控制列表。
提示
如果用户在分配了预定义的主管角色的组内，则该用户可以选择全部匹配而非某个访问控制列表，以便让转发的数据不受限制。
单击创建以创建转发器。

完成之后

可在“数据转发器”卡上执行以下操作。

选择状态列中的切换开关以启用或禁用所选转发器。
单击编辑图标（）以修改所选转发器。
单击删除图标（）以删除所选转发器。

提供反馈