移动端¶

观测云 App 支持在移动设备上查看和处理工作空间内的故障、观测数据、值班排班与账号设置。App 当前围绕「首页、观测、故障、排班、我的」五个入口组织能力；您可以在收到告警或协作通知后快速进入故障详情，查看日志、链路、事件、RUM 与仪表板数据，并通过状态流转、协作评论、分享链接和隔空接力继续处理问题。

安装¶

在观测云的工作空间内，您可以通过「集成」-「移动端」进行下载，也可以通过下方扫码进行下载。

或者您也可以直接点击如下链接进行下载。

现有的观测云免费/商业版用户可以在 App 中选择账号所属站点，并通过密码、手机验证码或 SSO 登录。站点列表会按当前产品线展示，您也可以在登录页刷新站点信息。

密码登录：输入邮箱或账号、密码后登录，可选择记住账号；
验证码登录：输入手机号和 6 位验证码登录，发送验证码前可能需要完成图形验证；
SSO 登录：输入邮箱或完整 SSO 地址，按页面提示选择登录入口、工作空间并完成单点登录；
忘记密码：在密码登录页进入重置密码流程，完成账号验证后设置新密码；
MFA：当工作空间开启 MFA 安全策略时，登录或切换工作空间需要按页面提示完成验证；首次绑定时也会展示绑定流程。

如若您还没有观测云账号，您可以前往观测云官网立即申请，选择注册适合的站点账号。

登录成功后，App 会进入当前账号可访问的默认工作空间。您可以在首页、观测、故障、排班或「我的」中切换工作空间；切换后，对应页面的数据会按新工作空间重新加载。

如果您的团队使用私有化部署站点，可以在登录页的站点选择器中添加私有化站点，并在对应站点下完成登录。

添加私有化站点

在登录页点击「站点」，打开站点选择器；
点击「添加私有化站点」；
在「目标地址」中填写私有化站点的 Console 地址或站点目录地址，例如 https://console.company.com 或 https://urls.company.com/；
点击「识别并预览」，App 会自动识别站点名称、Console 地址、API 地址和支持的登录方式；
确认站点名称后点击「添加并保存」。如果识别到多个站点，请按页面提示选择登录页默认使用的站点。

保存成功后，私有化站点会出现在站点选择器的「私有化」分组中。选择目标站点后，您可以继续使用密码、验证码或 SSO 登录；具体可用登录方式取决于该私有化站点的配置。

管理私有化站点

已添加私有化站点后，您可以在登录页的站点选择器中点击「管理私有化站点」，刷新远程目录、切换默认站点、删除不再使用的配置，或复制诊断信息用于排查。远程目录刷新失败时，App 会优先使用上次成功同步的本地缓存。

站点目录地址格式

如果您使用站点目录地址，目录地址需要是一个 App 可访问的 HTTPS URL，例如 https://urls.company.com/ 或 https://urls.company.com/site-map.json。如果输入未带协议或输入了 http:// 地址，App 会统一转换为 https:// 后访问。该地址返回内容必须是 JSON 对象，顶层包含 urls 字段；urls 下的每个 key 表示一个站点，站点内需要提供 Console 与 API 地址。

示例如下：

{
  "urls": {
    "prod": {
      "name": "公司生产环境",
      "name_en": "Company Production",
      "console": "https://console.company.com",
      "console_api": "https://console-api.company.com"
    },
    "staging": {
      "name": "公司预发环境",
      "name_en": "Company Staging",
      "console": "https://staging-console.company.com",
      "console_api": "https://staging-console-api.company.com"
    }
  }
}

其中，name 和 name_en 用于展示站点名称；console 是网页控制台地址；console_api 是业务 API 地址。

注意：私有化站点地址需要在当前网络环境下可通过 HTTPS 访问。如果识别失败，请确认地址是否为有效的 Console 地址或站点目录地址，并检查网络、VPN、证书和站点配置。

首页¶

首页用于聚合当前需要关注的故障，包括当前工作空间内待分配的故障，以及已分配给您且尚未解决的故障。您可以在首页快速完成以下操作：

查看故障名称、等级、状态、处理人、更新时间和值班信息；
选择最近时间或精确时间范围，定位特定时间段内的故障；
下拉刷新当前工作空间的故障列表；
长按故障进入多选模式，批量接手、标记已解决或调整故障状态；
点击故障卡片进入详情页继续排查和协作；
切换工作空间并重新加载首页数据。

如果当前空间没有待处理故障，首页会展示空状态提示。

观测¶

「观测」提供仪表板、日志、链路、事件与 RUM 的移动端查询入口。您可以在移动设备上快速查看关键数据，也可以从分享链接或隔空接力跳转到对应的数据详情。

仪表板¶

在「观测」-「查看仪表板」中，您可以查看当前工作空间下可访问的仪表板列表。仪表板支持按名称搜索、快捷筛选、标签筛选、收藏和查看创建/更新信息。进入仪表板详情后，您可以：

查看仪表板内的图表、表格、排行榜、数值、文本等组件；
使用时间控件切换最近时间或精确时间范围；
调整仪表板变量，按服务、主机、应用等维度切换数据；
搜索组件名称，快速定位目标图表；
在图表总览与图表阅读模式之间切换，并按分组展开或收起图表；
放大单个组件，并分享或通过 Handoff 打开对应的控制台链接。

仪表板与网页端内容同步，详情可参考仪表板。

日志、链路、事件与 RUM 查询¶

在「观测」中，您可以分别进入日志、链路、事件与 RUM 查询页：

日志：支持选择日志索引，按关键字或 key:value 条件查询日志记录，并进入日志详情查看字段内容；
链路：支持按 trace_id、服务和状态等条件查询 Trace，并以瀑布图查看 Span 调用关系；
事件：支持查看关键事件明细，并通过事件 ID、监控器字段等条件定位事件；
RUM：支持按 View、Action、Resource、Long Task、Error 等类型查看用户访问数据，并在详情中关联 Trace 或 Resource。

查询页支持最近时间、精确时间、字段建议和值建议。打开记录详情后，您可以查看摘要、字段列表、原始内容，并分享控制台链接；在 Trace 瀑布图中，还可以查看关联 RUM Resource 或进入单个 Span 详情。日志查询与详情：

链路查询与瀑布图：

事件查询与详情：

RUM 查询与详情：

故障¶

「故障」用于查看、搜索、认领和跟踪当前工作空间内的故障。故障列表支持按状态切换，常见状态包括待分配、处理中、已解决等。

您可以在故障列表中：

按最近时间或精确时间过滤故障；
输入关键字或 key:value 条件搜索故障；
使用搜索建议快速选择标题、等级、状态、站点、主机、处理人等字段；
开启「与我相关」筛选，优先查看通知到您、分配给您或与您值班规则相关的故障；
长按进入多选模式，批量更新故障状态；
切换工作空间并刷新当前空间的数据。

故障详情¶

进入故障详情后，您可以查看故障的核心信息、状态流转和排查上下文。详情页支持：

查看故障标题、等级、状态、处理人、站点、检测维度和关联标签；
查看事件分布，了解同一故障在不同状态下的分布情况；
将故障接手为处理中、标记为已解决、重新打开或放弃处理；
查看详情、字段、协作记录等分区内容；
在协作记录中查看操作时间线、评论和系统变更，并可切换为只看评论；
编写评论、@ 提及空间成员，并上传附件；
通过分享或 Handoff 在移动端和电脑端继续查看同一故障。

收到故障推送或协作 @ 提及时，您可以点击通知进入对应故障；如果通知指向协作评论，App 会定位到协作区域并高亮目标评论。

排班¶

「排班」用于查看当前工作空间内的值班安排。您可以按月份查看排班组和每日值班成员，并进入值班详情确认当前值班、下次值班和历史记录。

排班页支持：

查看当前月份内可访问的排班组；
查看当天的当前值班人；
在月历中查看不同日期的值班安排；
打开成员值班详情，查看值班中、下次值班和值班记录；
查看成员值班联系方式，包括手机号和邮箱等已配置的信息；
查看排班升级策略、通知层级、通知方式和通知对象，确认告警如何触达值班成员；
切换工作空间并重新加载排班数据。

我的¶

「我的」用于管理账号、状态、工作空间协作、通知与 App 设置。

账号与状态¶

在「我的」中，您可以查看当前账号、邮箱、手机号、头像和当前工作空间。您也可以设置自己的工作状态，并查看今日值班概览。值班状态由排班决定，App 会结合当前排班展示您是否处于值班中。

切换工作空间¶

观测云 App 支持查看账号下全部有权限访问的工作空间数据。您可以在首页、观测、故障、排班或「我的」中打开工作空间选择器，搜索工作空间并切换。

如果您当前没有工作空间，可以前往观测云网页版创建新的工作空间，或者由其他空间的空间管理员邀请您成为其他空间的新成员。

工作空间成员¶

在「我的」-「工作空间成员」中，您可以查看当前空间成员，按姓名、邮箱或账号搜索成员，并查看成员详情。故障协作评论中的 @ 提及也会使用工作空间成员信息。

消息通知¶

观测云 App 提供基于工作空间告警和故障协作的移动推送能力。您可以在「我的」-「设置」-「推送设置」中查看系统通知权限，开启或关闭 App 推送，并管理通知偏好。

推送设置支持只通知与我相关的故障、接收待分配故障提醒、接收处理中故障状态变化等偏好。若系统通知权限未开启，请先前往 iOS 系统设置中允许通知。

仪表板快捷入口¶

观测云 App 支持配置仪表板桌面快捷入口。配置后，您可以在 iOS 主屏幕长按 App 图标，直接打开指定仪表板。每个工作空间最多可配置 4 个仪表板快捷入口。

您可以通过「我的」-「设置」-「仪表板快捷入口」搜索并选择需要快捷查看的仪表板，也可以调整已选快捷入口的顺序或移除不再需要的入口。

语言、外观与账号安全¶

在「我的」-「设置」中，您还可以配置以下内容：

语言设置：选择跟随系统、简体中文、繁体中文或 English；
外观设置：选择跟随系统、白天或黑夜模式；
账号安全：查看当前登录方式、站点、工作空间、最近登录时间和本地凭证保存说明；
调试信息：查看用于排查登录、站点和推送注册的设备信息，不展示 token 或密钥；
本地数据与缓存：清除本地登录信息、头像缓存，或清除全部本地数据；
退出登录：结束当前设备会话并返回登录页。

通用能力¶

时间控件¶

观测云 App 支持通过时间控件设定首页故障、观测查询和仪表板展示的时间范围。您可以选择最近 1 分钟、5 分钟、15 分钟、1 小时、1 天、7 天等预设时间，也可以选择开始时间和结束时间进行精确查询。

在故障、日志、链路、事件、RUM 和仪表板列表中，您可以使用搜索和筛选快速定位目标数据。部分页面支持 key:value 字段条件、字段建议和值建议；更多字段筛选详情可参考文档搜索说明。

观测云 App 支持在故障详情、仪表板、观测数据详情和图表放大页分享控制台链接。点击页面中的「分享」按钮后，您可以将链接发送给其他协作成员。

注意：查看分享链接内容时，对方也需要拥有被分享内容所在工作空间的访问权限。

场景一：分享至 PC 端

在此场景下，您点击收到的分享链接即可在 PC 端登录查看对应的数据。

场景二：分享至安装有观测云 App 的 iOS 或 Android 移动设备

在此场景下，您点击收到的分享链接即可打开 App 中对应的数据页面；如果目标站点与当前登录站点不同，App 会提示您切换站点或重新登录。

链接跳转¶

如果在您的 iOS 或 Android 设备上安装有观测云 App，那么您在任意地方打开来自观测云的网页链接，都可以跳转至 App 中对应内容的页面，包括钉钉、飞书、邮件中的告警通知。

目前支持从链接打开故障、仪表板、日志、链路、事件和 RUM 等相关页面。链接中包含站点或工作空间信息时，App 会尝试进入目标上下文；如果目标站点与当前登录站点不同，App 会提示切换站点并重新登录；如果当前账号无权限访问目标空间，请先确认账号权限。

隔空接力¶

观测云 App 支持通过隔空接力（Handoff）在移动端和电脑端之间同步查看故障与观测数据，帮助您在处理告警、排查问题或协作跟进时快速切换设备。

注意：使用隔空接力时，需要电脑端为 macOS 系统，移动端设备为 iOS 系统，每台设备开启隔空接力功能，并使用同一个 Apple ID 登录 iCloud。App 需已安装并登录，当前账号也需要拥有目标工作空间权限。更多设置可参考文档如何使用隔空接力。

当前支持隔空接力的页面包括：故障详情、仪表板详情、放大的仪表板图表、日志/事件/RUM 等观测记录详情、链路瀑布图和链路 Span 详情。App 会发布当前页面对应的控制台 URL，便于在另一台设备上继续查看同一份数据。

场景一：移动端查看数据，电脑端继续处理

在此场景下，当您在移动端查看支持隔空接力的故障或观测数据页面时，macOS 的 Dock 中会出现观测云 App 的同步查看提示。点击提示后，即可在浏览器中打开对应的控制台页面。

场景二：电脑端查看数据，移动端继续处理

在此场景下，当您在电脑端查看支持移动端打开的数据链接时，iOS 设备底部会出现观测云 App 的同步查看提示。点击提示后，即可打开 App 中对应的数据页面；如果目标站点或工作空间与当前上下文不同，App 会提示切换站点、重新登录或确认工作空间权限。

移动端¶

安装¶

首页¶

观测¶