使用 IBM Cloud Logs 中的操作与第三方服务集成
在 IBM Cloud Logs 中,您可以根据搜索结果和值触发第三方服务,并向这些服务发送数据。 您可以从视图和仪表盘创建管理操作。
创建操作
要创建操作:
-
在左侧导航中,单击 浏览日志 图标
> 日志。
-
在“日志”视图中,单击  设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。
-
单击 管理操作。
-
单击添加新操作。
-
对于 无标题操作,指定操作的名称。
-
在 URL TEMPLATE 中,输入外部服务的 URL。 例如,
https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}。 仅支持http://和https://。支持 JavaScript 语法。 例如,可以指定诸如
{{ condition ? "true value" : "false value" }}之类的条件。 支持大多数 JavaScript 函数。您可以在 URL 中加入 变量 来传递数据。 如果输入双花括号 (
{{}}),那么将显示可用变量的列表。 -
选择与操作关联的 数据类型。 操作将显示在所选上下文中。
-
单击 高级 以访问可选设置。
-
要使操作成为公共操作,请切换 保存时设为公共。
-
要将操作限制为特定 应用程序 或 子系统,请从列表中选择值。
-
单击 保存操作
编辑操作
编辑现有操作:
-
在左侧导航中,单击 浏览日志 图标
> 日志。
-
在“日志”视图中,单击  设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。
-
在操作列表中,单击要更改的操作。
-
进行更改。
-
单击 保存操作 以保存更改,或者单击 重置 以将操作还原为操作的上次保存版本。
克隆操作
如果要根据现有操作创建新操作,那么可以克隆操作。
-
在左侧导航中,单击 浏览日志 图标
> 日志
-
在“日志”视图中,单击  设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。
-
在操作列表中,将鼠标悬停在要克隆的操作上。
-
单击 克隆 图标。 将创建重复的操作。
-
编辑 克隆的操作并进行更改。
-
单击“保存操作”保存更改。
在“操作”菜单上显示和隐藏操作
您可以配置用户是否可以 触发 操作。
-
在左侧导航中,单击 浏览日志 图标
> 日志。
-
在“日志”视图中,单击  设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。
-
在操作列表中,单击要配置的操作。
-
单击 从操作菜单中隐藏 图标,以在操作菜单中不包含针对用户的操作。 单击 在操作菜单上显示 图标以将操作包含在操作菜单中。
触发操作
通过执行以下步骤来触发操作:
-
在左侧导航中,单击 浏览日志 图标
> 日志。
-
单击视图中显示的数据。 此时会显示菜单。
-
将鼠标悬停在操作上。 显示可用操作列表。
-
单击该操作以触发该操作。
只有配置为 显示在操作菜单中 的操作才会在操作菜单中列出。
删除操作
-
在左侧导航中,单击 浏览日志 图标
> 日志。
-
在“日志”视图中,单击  设置。 此设置图标与左侧导航中的图标不同。 可以在页面右上角的日志视图中找到设置图标。
-
在操作列表中,单击要删除的操作。
-
单击删除。
将立即执行删除操作。 不要求您确认是否要删除该操作。
可以包含在操作中的变量
您可以在 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}}