客户现场调试指南 — 第三方接口联调

接口清单

接口	地址
Token	`POST http://180.51.12.2/api/appsys/sso/httpheader/login/v1?username_=szls`
告警推送	`POST http://180.51.12.2/api/edge/edgecallmanages/vi-alarm/v1`
MinIO	`http://180.51.12.2:9000`

第一步：确认三个接口可达

在能访问 180.51.12.2 的机器上执行。

1. Token 接口

curl -s -X POST \
  "http://180.51.12.2/api/appsys/sso/httpheader/login/v1?username_=szls"

预期返回 JSON，responseBody.token 有值。

2. 告警推送接口

把上一步拿到的 token 替换 TOKEN_VALUE：

curl -s -X POST \
  "http://180.51.12.2/api/edge/edgecallmanages/vi-alarm/v1" \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: TOKEN_VALUE" \
  -d '{"tenantCode":"32","channelNo":"test","alarmContent":"test","alarmTime":"2026-01-01 00:00:00","picInfo":[],"videoInfo":[]}'

预期返回 200。

3. MinIO 存储

curl -s "http://180.51.12.2:9000"

预期返回 MinIO XML 响应。

第二步：查看 Edge-Server 日志

在 Edge 设备上执行。

查看启动时加载的第三方地址

journalctl -u safesight-edge-server --no-pager \
  | grep -E "ExternalApiAction initialized|HttpAction initialized"

预期看到 token_url=http://180.51.12.2/... 和 msg_url=http://180.51.12.2/...。

如果 IP 不是 180.51.12.2，说明管理端下发的配置未更新。

实时跟踪告警和接口调用

journalctl -u safesight-edge-server -f \
  | grep -E "alarm.*trigger|ExternalApi|token|send ok|send failed"

第三步：触发告警，观察完整链路

找人走到摄像头前触发告警，观察日志。

正常流程：

[alarm] trigger event_id=xxx rule=unknown_face
[ExternalApiAction] token fetched successfully
[ExternalApiAction] send ok http=200 event_id=xxx

异常对照：

日志	对策
没有 `[alarm] trigger`	检查阈值、摄像头、RTSP
无 `token fetched successfully`	回到第一步验证 token 接口
`send failed http=401`	token 过期，检查 SSO 账号
`send failed http=500`	第三方内部错误，找客户排查
日志里完全没有 `ExternalApiAction`	管理端集成服务未启用 external_api
`minio upload failed`	检查 MinIO 凭据和 bucket
`curl_easy_perform` 错误	Edge 到 180.51.12.2 网络不通

第四步：验证 Agent 本地告警

journalctl -u safesight-edge-agent --no-pager -n 200 \
  | grep -i "alarm\|report"

快速诊断

journalctl -u safesight-edge-server --no-pager -n 500 \
  | grep -E "ExternalApi|HttpAction|alarm.*trigger|token|send ok|send failed"

管理端配置检查

登录管理端 → 资产管理 → 第三方服务
确认告警服务和对象存储地址为 180.51.12.2
如有修改，保存后重新下发设备配置

2.9 KiB Raw Blame History Unescape Escape