快速入门¶
观测云提供一站式云、云原生、应用及业务的可观测解决方案。无论是服务器状态、应用性能瓶颈，还是用户真实访问体验，都可以在一个平台统一采集、关联分析与实时洞察。配合 Obsy AI Copilot 与智能体团队，从异常发现到根因定位，都能获得 AI 辅助决策，实现从观测到行动的完整闭环。
观测云提供免费版、商业版和 部署版三种产品版本：
免费版：面向独立开发者与小团队，支持基础数据采集和核心功能体验；
商业版：面向正式业务环境，提供完整功能栈与按量计费；
部署版：面向私有化环境，需在本地基础设施安装观测云系统软件。
本文档面向 SaaS 版（免费版/商业版）用户，引导您在快速完成从安装采集器到看到第一条监控数据的完整闭环。
如果您使用的是部署版，请参考 私有化部署文档 进行安装和配置。
准备工作：注册并登录¶
如果您尚未拥有观测云账号，请先注册观测云账号。注册完成后，选择您账号所在的站点进入观测云控制台工作空间。
第一步：安装 DataKit¶
DataKit 是观测云官方开源的数据采集客户端，部署在您的服务器上，负责将主机指标、容器状态、应用日志等数据实时上报到观测云。安装完成后，DataKit 默认开启一批基础采集器，无需额外配置即可开始采集。
观测云支持多种安装方式，您可以根据实际环境选择：
- 主机安装：适用于 Linux、Windows、macOS 等操作系统
- 容器安装：适用于 Docker 环境
- Kubernetes 安装：适用于 K8s 集群，支持 Helm 部署
- 其他方式：包括 AWS ECS Fargate、AWS EKS、离线安装等
进入观测云控制台，点击左侧导航栏集成 > DataKit，选择您的操作系统类型，复制页面提供的安装命令并在目标主机执行即可。安装成功后，终端将提示安装成功。
更多安装细节及高级配置，请参考 DataKit 安装。
第二步：确认数据已上报¶
安装完成后，DataKit 默认已开启一批 Linux 主机常用采集器，无需手动配置即可开始采集基础指标。数据会按照各采集器的默认频率自动上报至工作空间，通常稍等片刻即可在控制台看到。
要确认采集是否成功，请进入控制台 > 基础设施，在主机列表中查看是否已出现您的服务器。若主机名称、IP 地址及状态正常显示，即表示 DataKit 已成功接入并开始工作。
若主机列表中未出现目标机器，建议排查以下情况：
- 检查 DataKit 服务状态：在主机上确认 DataKit 进程是否正常运行；
- 检查网络连通性：确认服务器能够访问公网，DataKit 需要向观测云上报数据；
- 检查工作空间：确认控制台当前所在的工作空间与安装 DataKit 时使用的 token 对应。
若仍无法解决，请前往 DataKit 无数据排查获取完整的排查流程。
第三步：查看内置可视化视图¶
数据上报后，系统已内置一系列可视化视图模板，覆盖主机、容器、数据库等常见场景。您无需从零搭建仪表板，只需选择并复用这些模板，即可快速查看系统运行状态。
进入场景 > 内置视图 > 系统视图，选择主机分类下的视图模板，点击即可查看 CPU 使用率、内存占用、磁盘 I/O、网络流量等关键指标的实时图表。您可以选择直接创建为新仪表板或新用户视图，将模板应用到自己的工作空间。
观测云提供覆盖基础设施、中间件、应用性能、云厂商等多个领域的系统视图模板，开箱即用。系统视图不可直接编辑，如需修改请先克隆为用户视图。
第四步：配置监控与告警¶
在确认数据正常采集并可视化后，建议为您的关键指标配置告警规则，以便在异常发生时第一时间收到通知。
观测云内置 700+ 开箱即用的监控器模板，覆盖主机资源、数据库、网络、应用性能等常见场景。进入监控 > 监控器 > 新建监控器 > 官方模板库，在左侧检测库中勾选“主机检测库”，选择所需的检测规则（如主机 CPU 平均负载过高），即可一键创建监控器。
创建监控器后，需配置告警策略及通知对象等。观测云支持通过邮件、钉钉、飞书、企业微信、短信、Webhook 等多种渠道发送告警，确保异常信息及时触达相应负责人。
关于监控器配置与通知策略的详细说明，请参考 开始使用监控器。
第五步：探索更多数据类型¶
完成主机监控的基础闭环后，您可以根据业务需要逐步接入更多数据类型，构建全栈可观测能力：
| 数据类型 | 说明 | 推荐场景 |
|---|---|---|
| 日志 | 采集应用与系统日志，支持全文检索与模式分析 | 故障排查、审计追溯 |
| 应用性能监测（APM） | 追踪分布式应用请求链路，定位性能瓶颈 | 微服务架构、API 性能优化 |
| 用户访问监测（RUM） | 采集真实用户访问体验数据 | Web/小程序性能优化 |
| Agent 监测 | 追踪 Agent 请求与整个应用链路关联，计量每次生成任务消耗的 Token 数量 | AI 应用、大模型服务治理 |
| 安全监测 | 集成 CSPM 与 SIEM 能力，构建资产-配置-行为一体化的安全监测体系 | 安全事件管理、合规审计 |
| 云资源集成 | 同步阿里云、AWS、华为云等云厂商资源数据 | 混合云/多云统一监控 |
进入集成模块，您可以查看观测云支持的所有数据源及对应接入指引文档。所有数据接入后均可在同一工作空间进行关联分析，无需在多个工具间切换。
进阶：查询与分析数据¶
当您熟悉基础可视化与告警后，如需进行更灵活的数据探查，可以使用观测云自研的 DQL（Data Query Language）查询语言。DQL 专为时间序列数据、日志、事件等可观测数据设计，支持在查看器、仪表板、指标分析、查询工具等多个模块中使用。
DQL 语法及使用示例，请参考 DQL 查询语言。
完成以上步骤后，您已具备使用观测云进行基础系统监控的能力。如需深入了解某一功能模块，可通过左侧导航栏查阅对应专题文档，或在控制台中通过页面内帮助入口获取上下文指引。
常见问题¶
安装 DataKit 会影响服务器性能吗？
DataKit 默认开启资源保护机制，宿主机安装时即通过 cgroup（Linux）限制 CPU 和内存占用。低负载情况下内存占用约 100MB 左右，CPU 消耗较低，对业务系统影响极小。若采集数据量较大，可在 datakit.conf 中调整 [resource_limit] 配置。容器或 Kubernetes 部署时，资源限制需手动配置。
免费版真的是永久免费吗？有没有隐藏收费？
免费版无需支付费用，但受使用配额限制（如用户数量、主机数量、监控器数量、数据存储量等）。超出配额后，观测云有权暂停或限制服务使用权限，直至您升级商业版或降低使用量。免费版不提供商业级技术支持与开票服务。
我不想监控某台主机了，怎么从控制台移除它？
停止或卸载该主机上的 DataKit 后，主机将不再上报数据。若超过 24 小时没有数据上报，该主机将从列表中自动移除。主机列表默认仅展示最近 10 分钟在线的主机，您也可以点击"仅显示在线主机"按钮查看当前活跃主机。
主机列表里显示的名字是 IP 地址，能改成自定义名称吗？
可以。在安装 DataKit 时，通过环境变量 DK_GLOBAL_HOST_TAGS 设置主机标签（如 host=my-server），或在安装后修改 datakit.conf 中的全局标签配置。修改后，控制台将按照您设置的标签显示主机名称。
配置监控器需要写代码或复杂的查询语句吗？
不需要。观测云提供官方模板库，覆盖主机、数据库、网络等常见场景，您只需选择模板并调整阈值、通知渠道等参数即可。如需更灵活的配置，也可通过可视化界面自定义检测规则，无需编写代码。
我能用观测云监控家里的电脑、虚拟机或树莓派吗？
可以。DataKit 支持 Linux、Windows、macOS 等多种操作系统，只要设备能访问公网，均可安装 DataKit 并接入观测云。虚拟机、云服务器、物理机、个人电脑等环境均适用。
我的数据存在哪里？安全吗？
SaaS 版（免费版/商业版）的数据会上传并存储在观测云云端数据中心，观测云提供数据加密传输与存储机制。如果您对数据主权有严格要求，可选择部署版，将数据完全保留在本地基础设施中。
免费版的数据能保留多久？
免费版的数据保留期限受订阅协议限制，具体时长以控制台或官方说明为准。若需更长的数据保留周期或更大的存储容量，可升级至商业版。