使用 IBM Cloud Logs 中的操作与第三方服务集成

在 IBM Cloud Logs 中,您可以根据搜索结果和值触发第三方服务,并向这些服务发送数据。 您可以从视图和仪表盘创建管理操作。

创建操作

要创建操作:

  1. 在左侧导航中,单击 浏览日志 图标 "浏览日志" 图标 > 日志。

  2. 在“日志”视图中,单击 ![设置图标](/icons/setting.svg ""设置" 图标") 设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。

  3. 单击 管理操作。

  4. 单击添加新操作。

  5. 对于 无标题操作,指定操作的名称。

  6. 在 URL TEMPLATE 中,输入外部服务的 URL。 例如,https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}。 仅支持 http:// 和 https://。

    支持 JavaScript 语法。 例如,可以指定诸如 {{ condition ? "true value" : "false value" }}之类的条件。 支持大多数 JavaScript 函数。

    您可以在 URL 中加入 变量 来传递数据。 如果输入双花括号 ({{}}),那么将显示可用变量的列表。

  7. 选择与操作关联的 数据类型。 操作将显示在所选上下文中。

  8. 单击 高级 以访问可选设置。

  9. 要使操作成为公共操作,请切换 保存时设为公共。

  10. 要将操作限制为特定 应用程序 或 子系统,请从列表中选择值。

  11. 单击 保存操作

编辑操作

编辑现有操作:

  1. 在左侧导航中,单击 浏览日志 图标 "浏览日志" 图标 > 日志。

  2. 在“日志”视图中,单击 ![设置图标](/icons/setting.svg ""设置" 图标") 设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。

  3. 在操作列表中,单击要更改的操作。

  4. 进行更改。

  5. 单击 保存操作 以保存更改,或者单击 重置 以将操作还原为操作的上次保存版本。

克隆操作

如果要根据现有操作创建新操作,那么可以克隆操作。

  1. 在左侧导航中,单击 浏览日志 图标 "浏览日志" 图标 > 日志

  2. 在“日志”视图中,单击 ![设置图标](/icons/setting.svg ""设置" 图标") 设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。

  3. 在操作列表中,将鼠标悬停在要克隆的操作上。

  4. 单击 克隆 图标。 将创建重复的操作。

  5. 编辑 克隆的操作并进行更改。

  6. 单击“保存操作”保存更改。

在“操作”菜单上显示和隐藏操作

您可以配置用户是否可以 触发 操作。

  1. 在左侧导航中,单击 浏览日志 图标 "浏览日志" 图标 > 日志。

  2. 在“日志”视图中,单击 ![设置图标](/icons/setting.svg ""设置" 图标") 设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。

  3. 在操作列表中,单击要配置的操作。

  4. 单击 从操作菜单中隐藏 图标,以在操作菜单中不包含针对用户的操作。 单击 在操作菜单上显示 图标以将操作包含在操作菜单中。

触发操作

通过执行以下步骤来触发操作:

  1. 在左侧导航中,单击 浏览日志 图标 "浏览日志" 图标 > 日志。

  2. 单击视图中显示的数据。 此时会显示菜单。

  3. 将鼠标悬停在操作上。 显示可用操作列表。

  4. 单击该操作以触发该操作。

    只有配置为 显示在操作菜单中 的操作才会在操作菜单中列出。

删除操作

  1. 在左侧导航中,单击 浏览日志 图标 "浏览日志" 图标 > 日志。

  2. 在“日志”视图中,单击 ![设置图标](/icons/setting.svg ""设置" 图标") 设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。

  3. 在操作列表中,单击要删除的操作。

  4. 单击删除。

    将立即执行删除操作。 不要求您确认是否要删除该操作。

可以包含在操作中的变量

您可以在 URL 模板中指定变量,将信息传递给外部服务。

支持以下变量

$m.<metadata>
元数据变量在日志中可用。 例如,$m.applicationName 或 $m.timestamp。
$d.<key>.<subkey>
日志中可用的数据。 例如,$d.kubernetes.labels.my_label。
$p.start_time
所选时间范围的起始时间,以 Unix epoch 时间戳表示,单位为毫秒。
$p.end_time
所选时间范围的终点,作为 Unix 时间戳,单位为毫秒。
$p.selected_value
用户在 UI 中选择的值。 如果通过单击键激活,那么将包含该键的整个值。

示例操作

以下操作将生成 Jira 问题。

http://<company_name>.atlassian.net//secure/CreateIssueDetails!init.jspa?pid=<Jira_PID>&issuetype=<Jira_issueType>&description={{$d.logRecord.body}}&summary={{$d.msg}}