把访问量、错误率、构建结果放在一个面板上，比每周翻日志更省时间。这份文档说明如何把采集数据接进面板、配置图表口径，并把面板发布到站点的固定路径下。

一、适用范围

• 适用：为自建站点搭建访问与健康度面板；把已有日志、监控数据接入统一数据源；调整图表指标与刷新频率；面板改版后的发布与回退。
• 不适用：商业监控平台的开通与计费；告警通道的对接与值班流程；面板后端的数据库运维，按既有运维规范执行。

二、准备工作

项目	要求	检查方法
数据文件	面板读取的数据位于 /srv/axis/data，格式为 JSON 或时序库接口	ls -l /srv/axis/data，用 jq 校验首条记录
时间口径	时间字段统一为 UTC 或带偏移的 ISO 8601	抽查一条记录，确认含时区信息
站点路径	面板发布路径已确定，例如 example.com/dashboard/	现有站点未被该路径占用
权限	面板数据只包含聚合结果，不含用户标识	检查字段清单，剔除 IP、邮箱等明细
工具	jq、curl、node 可用	jq --version、node -v

• 数据接入前先确认指标定义，同一图表只使用一种统计口径。
• 面板要能离线打开，不依赖未授权的第三方脚本。

三、操作步骤

本节拆成三个子步骤，建议按顺序执行；每一步完成后先确认结果，再进入下一步。

3.1 数据接入

把日志或监控数据整理成面板可读的结构，写入固定路径，并约定字段名与刷新频率。聚合在服务端完成，面板只读聚合结果；把原始明细直接交给前端，数据量一上来页面就会卡住。详见 3.1 数据接入。

3.2 图表配置

按“先总量、后趋势、再明细”的顺序配置图表，明确每个指标的计算方式与时间粒度。同一屏内的图表必须共用同一时间范围，否则“今日”与“近 7 天”混排会让读者得出错误结论。详见 3.2 图表配置。

3.3 发布步骤

把面板构建产物发布到站点子路径，校验资源路径、缓存策略与访问权限，必要时加访问控制。发布用整体目录替换而不是逐文件覆盖，回滚时也整体换回，避免新旧文件混用导致页面白屏。详见 3.3 发布步骤。

数据、图表、发布三步完成后，用一次“数据更新 → 页面刷新”的完整循环验收：采集脚本按点写入新数据，面板在约定时间后显示新数值，且数值与直接读文件的结果一致。

四、验证方法

1. 执行 jq '. | length' /srv/axis/data/summary.json，预期返回大于 0 的记录数；文件为空或字段缺失说明采集脚本没有跑成功，先查定时任务再查面板。
2. 执行 curl -sS https://example.com/dashboard/ | grep -o "<title>[^<]*"，预期返回面板标题，而不是默认页或错误页；返回默认页时优先检查资源路径前缀。
3. 打开面板核对：当日访问量、错误率、最近 7 天趋势三块图表的数值与源数据一致；若因图表取整产生差异，把取整规则记录在面板说明里，不要留在口头约定中。
4. 执行 curl -sSI https://example.com/dashboard/data/summary.json，预期数据文件可访问且缓存时长较短；缓存过长会让面板长期显示旧数据，排查时容易误判为采集失败。

五、常见问题

现象	可能原因	处理方式
面板打开空白	资源路径写成了绝对根路径	构建时设置子路径前缀，改为相对引用
图表数值与日志不符	统计口径或时区不一致	统一按 UTC 聚合，核对过滤条件
数据不更新	采集任务失败或缓存过长	查采集日志，缩短数据文件缓存时长
页面加载慢	一次加载全部明细数据	只加载聚合结果，明细按需请求
面板被公开访问	未加访问控制	在站点配置中为该路径加认证或 IP 限制

六、回滚与注意事项

• 回滚：保留上一版面板构建产物与数据快照，异常时整体替换回上一版目录，不要逐文件回退。
• 注意：面板只展示聚合指标，用户名、IP、邮箱等明细不得进入公开数据文件。
• 注意：数据文件与面板页面分开缓存，页面可长缓存，数据文件必须短缓存或加版本号。

上一页3.3 同步检查

下一页3.1 数据接入