快速开始

一台 Linux 主机、一个 agent，就能看到第一份完整数据。这一页只做一件事：让你在最短时间里确认 Diting 能在你的环境里跑起来。

准备

• Linux 主机，内核 3.10 及以上
• root 权限（安装 agent 需要）
• 能访问平台的网络路径
• 建议先关闭 SELinux 或确认已加载 Diting 的策略模块

平台侧需要先完成部署。单机、性能集群、HA 集群三种形态的安装步骤见部署与离线安装。

安装 agent

把 agent 安装包带到目标主机，解压后执行：

sudo ./install.sh

安装脚本会检查内核、挂载 debugfs 与 tracefs、写入 systemd 单元，并启动 agent。安装完成后确认服务状态：

systemctl status diting-agent

验证

先看 agent 自己的判断：

diting-agent probe

再确认内核能力报告：

curl -s localhost:<agent-port>/kernel-capabilities | jq

这份报告会列出每一项采集能力是否可用。不可用的项会给出原因，不会静默失败。

最后打开控制台，在主机列表里找到这台机器。看到主机指标、网络流量和服务，说明链路已经通了。

第一份数据

建议按这个顺序看：

1. 主机列表：确认 agent 在线、采集通道正常
2. 链路：找一条最近的请求，看 span 是否完整
3. 日志：确认日志已经进来，搜索一个关键词
4. 数据库：如果有数据库流量，看 QAN 是否出现语句

常见问题

• agent 不在线：先看 systemctl status，再看 /var/log/diting/agent.log
• 主机在线但没有链路：确认采集模式与网卡，检查是否有东西向流量
• 能力显示不可用：看 /kernel-capabilities 里的原因，多数是权限或内核配置

更细的排查见故障排查。

相关文档：部署与离线安装、主机接入与内核要求、故障排查。