创建 Issue¶
简介¶
Issue 作为异常追踪这一功能的最终落地单元,承担了整合当前工作空间中的异常问题来源、描述、相关成员等信息的角色。观测云将任何成员观测到的现象定义成一个 Issue,并通知相关成员来追踪处理。本文将介绍 Issue 主要创建入口及相关操作。
概念先解¶
字段 | 说明 |
---|---|
标题 | 即 Issue 标题。 |
投递频道 | 默认投递到 “全部”,支持自定义添加其他频道。 |
来源 | 包含以下几种来源:仪表板、未恢复事件、事件、查看器、监控器。 |
等级 | 可选择默认等级配置,其中等级的紧急程度依次为:P0 > P1 > P2;支持手动修改; 也可以选择自定义等级。 |
描述 | 详细描述当前 Issue 的现象,支持在文本框中 @成员 发送通知或添加 #频道 将当前 Issue 投递到对应频道。 |
附件 | 支持上传图片、视频、文本(CSV/TXT/JSON/PDF等); 支持配置关联链接。 |
新建 Issue¶
Issue 的创建支持两种方式:手动创建、自动创建。
手动创建¶
观测云支持您在异常追踪或在查看器及视图级别的功能模块根据图标快速手动创建 Issue。
异常追踪¶
进入异常追踪,点击新建 Issue。
仪表板¶
进入场景 > 仪表板 > 设置,点击新建 Issue;
自动显示当前仪表板的名称为该条 Issue 来源名称。点击来源可自动跳转至对应仪表板,若仪表板不存在,则跳转至场景默认页面。
查看器¶
进入观测云工作空间,可以在各大查看器级别的功能模块页面点击右下角按钮 新建 Issue;
比如,在日志 > 查看器,点击右下角创建 Issue 图标,即可进入新建页面。
自动显示当前查看器为该条 Issue 来源。点击来源可自动跳转至对应查看器,并按照 Issue 创建时查看器保存的时间范围和筛选搜索条件做过滤显示。
您还可以点击进入查看器下某条日志的详情页,点击右下角按钮后新建 Issue。会自动显示当前查看器详情页为该条 Issue 来源。点击来源可自动跳转至对应查看器详情页,若该条数据已不存在,则跳转至查看器默认显示状态。
事件¶
入口 1:进入未恢复事件,鼠标 hover 某一事件列表,即可点击进入左侧出现的新建 Issue;
自动显示该条未恢复事件标题为该条 Issue 来源名称。点击来源可自动跳转至对应事件详情页,若该条事件已不存在,则跳转至事件默认进入显示页面。
入口 2:点击进入某一事件的详情页,可在右上角点击新建 Issue。
自动显示该条事件标题为该条 Issue 来源名称。点击来源可自动跳转至对应事件详情页,若该条事件已不存在,则跳转至事件默认进入显示页面。
自动创建¶
当您在配置监控器时,可选择关联频道。当监控器产生异常事件告警,则会自动创建 Issue。以配置阈值检测为例:
1、由事件触发创建的 Issue,状态默认 Open、等级默认未知;
2、来源为当前监控器;
3、输入事件标题,默认为 Issue 标题;
4、输入事件内容,默认为 Issue 描述;
注意:
- 如需在事件描述中
@成员
,您可以在内容框上方点击@
按钮、在内容框内输入@
或直接在下方@
选择下拉框点击选择通知成员。选定后,当事件创建完成,会自动向该成员发送邮箱通知。 - @ 通知成员仅在同步创建的异常追踪问题中生效,正常监控器事件的告警通知列表请参考对应的告警策略配置。
5、在事件通知 > 同步创建 Issue,点击启用按钮,即可按需选择等级及频道。在频道下拉框,可多选当前频道或新建频道。选定后,当事件创建完成,会将一同自动创建的 Issue 投递到此时您选定的频道显示。
注意:默认频道即为异常追踪里的全部频道。
6、当监控器的事件通知规则配置完成后,若该监控器下产生了异常事件,将同步创建 Issue 异常追踪,您可以前往异常追踪 > 您选定的频道进行查看。
注意:若您在当前事件对应的监控器 > 检测指标中选定了 by 分组条件,且当前监控器关联的 Issue 状态为 Open 或 Pending,那么后续来自同一来源的产生的多个事件则不会创建新的 Issue,而是追加到已存在的 Issue 的回复下。
示例¶
1、在日志 > 查看器,点击新建 Issue。在新建弹窗,自动显示该条 Issue 来源为当前查看器。
2、输入该条 Issue 标题为“测试数据”,设置等级为 P2;
3、在描述中,除输入文本外,艾特相关成员;
4、还可以在描述中输入形式为 #异常数据
的频道进行关联;
5、按需选择添加附件,点击保存。
6、保存后即可在 异常追踪 的全部频道或已关联的 异常数据
频道进行查看;
7、被艾特通知的成员会在邮箱收到该条 Issue 的通知。
自定义等级¶
观测云为异常追踪 Issue 配置了 4 种默认等级选项:P0、P1、P2 和未知。除此之外,您可以配置自定义等级,以满足您的多种需求。
注意:您最多支持添加 10 个等级。
进入异常追踪 > 配置管理,即可开始配置:
点击添加等级,选择等级色块、输入等级名称及其描述,即可创建成功。
启用 / 禁用默认配置:¶
-
启用:若默认配置为启用状态,且当前工作空间内有新增的自定义等级,则您在创建或修改异常追踪时可选择默认和自定义等级;
-
禁用:若默认配置为禁用状态,则您在创建/修改异常追踪时仅能选择自定义等级配置。
禁用此选项需要注意三点:
- 已经存在自定义等级,从而保证在创建/修改 Issue 时有可选择的等级;
- 在监控器产生了异常事件并同步创建 Issue 异常追踪的情况下,需要将其调整为自定义等级;
- 若工作空间内仍然存在使用默认等级的 Issue,需要将仍然处于【Open】【Pending】的 Issue 调整为自定义等级。
在配置管理页面,您可进行以下操作:
编辑:点击编辑按钮,即可修改当前自定义等级的颜色、名称及描述。
删除:点击即刻删除当前等级。