笔记¶

笔记是观测云内置的结构化知识载体，专为可观测性场景设计，用于沉淀故障分析、性能排查等过程中产生的关键信息。笔记支持在正文中直接嵌入实时数据图表，使记录的内容始终与系统的真实状态保持关联，可与工作空间成员共享，有助于问题的回溯、定位与协作处理。

新建笔记¶

进入笔记，点击新建笔记，定义笔记标题后即可开始编辑。笔记正文支持 Markdown 格式，可按需插入文本或 Chart Block 图表。编辑完成后点击右上角预览切换至预览模式，Chart Block 将实时渲染为可交互图表。

详见创建/编辑笔记。

核心功能¶

结构化记录¶

每篇笔记支持配置标题、可见性、标签及业务标签（KV 格式）等属性。业务标签用于关联具体业务对象，是 AI 检索的核心路径，例如 service:checkout、host:prod-node-01。

Chart Block¶

笔记正文支持 Chart Block 语法扩展，在预览模式下实时渲染为可交互图表，支持时序折线图、数值概览、表格、柱状图、告警事件时间线、饼图、蜂窝图共 7 种图表类型，数据来自工作空间的实时查询。

在编辑模式下，可直接按照 Chart Block 配置说明中的语法填写图表类型、查询语句和展示参数，也可在预览时查看到由平台图表组件执行查询并渲染出的图表。

多 Tab 标签页¶

笔记编辑区支持同时打开多篇笔记，以 Tab 标签页形式并排展示，适合在处理故障时同时对照多篇历史记录。重新进入笔记模块时，上次打开的 Tab 状态自动保留。

多模块联动¶

通过为笔记配置业务标签（KV 格式），笔记可与观测云其他模块的对象自动关联。在主机、服务、仪表板、链路等对象的详情页中，可直接访问与该对象关联的笔记列表，无需跳转笔记模块，实现上下文内的知识沉淀与查阅。

例如，为笔记添加 host:prod-node-01 标签后，该笔记将自动出现在对应主机详情页的「笔记」Tab 中。

管理笔记¶

笔记列表操作¶

• 搜索：通过关键字搜索笔记；
• 收藏：点击笔记右侧收藏图标，收藏后可在「我的收藏」快捷入口下查看；
• 删除：点击笔记右上角操作菜单，选择删除，二次确认后删除当前笔记。

筛选与检索¶

左侧目录栏支持通过标签、业务标签对笔记进行筛选，并提供以下快捷入口：

• 全部笔记：工作空间内所有笔记；
• 我的收藏：当前用户收藏的笔记；
• 我创建的：当前用户创建的所有笔记；
• 私有笔记：仅创建者本人可见的笔记。

可见性¶

笔记支持配置以下两种可见性：

• 公开：工作空间所有成员可查看；
• 私有：仅创建者本人可查看和编辑。

开始使用¶