服务日志
「服务日志」面板查询的是 HAP/HDP 各微服务推送到运维平台 Loki 的结构化日志。默认不推送,需要在产品服务侧打开写入开关。
需要配置的是 HAP/HDP 服务侧的 ENV_LOKI_URL。运维平台侧也有同名变量,两者作用不同:
| 配置位置 | 作用 | 配置要求 |
|---|---|---|
| HAP/HDP 服务侧 | 写入开关,默认空 —— 不配置则不会向 Loki 写入服务日志 | 配置此项 |
运维平台侧(ops.yaml/ConfigMap) | 查询地址,部署后已有默认值 | 标准拓扑下无需修改 |
只修改运维平台侧变量不会启用服务日志写入,面板仍会为空,且两侧通常都不会报错。
第 1 步:按部署形态填写地址
A. 产品服务与运维平台在同一个 Kubernetes 集群
ENV_LOKI_URL=http://ops-loki.<运维平台所在命名空间>.svc.cluster.local:3100
命名空间填写运维平台实际所在的命名空间(部署配置默认使用 hap-ops)。可通过以下命令确认:
kubectl get svc -A | grep ops-loki
输出结果第一列即为命名空间。
运维平台的 ops-loki 是 ClusterIP Service,只在集群内可解析。填运维平台所在节点的 IP,
会返回 503 或连接失败——即使目标机器是运维平台所在节点,也应使用 Service DNS。
B. 产品服务与运维平台在同一台机器,都是 Docker Compose
ENV_LOKI_URL=http://ops-loki:3100
可直接使用服务名,前提是产品服务与运维平台已接入同一个 Docker 网络。
C. 运维平台单机部署(Docker Compose),产品服务在另一台机器
ENV_LOKI_URL=http://运维平台主机IP:3100
需要为 ops-loki 配置 3100:3100 端口映射,并控制该端口的访问范围。本文使用的 Docker Compose 配置示例默认未启用此映射,跨主机接入时需要取消相应配置的注释。
D. 运维平台集群部署(Kubernetes),产品服务在集群外
先为 ops-loki 配置 NodePort 或 Ingress(默认 ClusterIP 无法从集群外访问),再将 ENV_LOKI_URL
指向该对外地址。
第 2 步:重启产品服务
单机部署时修改 docker-compose.yaml 或 .env;集群部署时修改对应的 ConfigMap(私有部署服务通常集中在 env-list 中)。变量在启动时读取,修改后需重启产品服务。
第 3 步:确认连通性
- 在产品服务的任一容器中,使用已配置的地址验证可达性:
curl -s -o /dev/null -w '%{http_code}\n' <你填的 ENV_LOKI_URL>/ready
返回 200 表示连通。503 通常表示地址配置错误,例如情况 A 中填写了节点 IP。
-
触发一次业务操作,例如登录或发送验证码,使微服务写入日志。
-
刷新运维平台的日志查询,确认「服务日志」面板出现内容。
若页面持续为空,见常见问题。
容器日志
「容器控制台」面板查询容器的 stdout/stderr。采集方式取决于部署方式:
| 部署方式 | 采集方式 | 配置要求 |
|---|---|---|
| 单机(Docker Compose) | ops-alloy 经 /var/run/docker.sock 采集 Docker 容器日志 | 无需配置,部署后自动启用 |
集群 · PVC(k8s-cluster/) | 50-daemonsets.yaml 中的 alloy-logs 经 Kubernetes API 读取 Pod 日志 | 无需配置,随清单部署 |
集群 · hostPath(单文件 ops.yaml) | 默认不采集 | 需额外部署 alloy-logs,见下文 |
hostPath 部署配置文件不包含 Kubernetes 容器日志采集组件。ops-alloy 的 Docker 日志采集配置不能采集 Kubernetes Pod 日志。
「容器控制台」面板将无数据,且两侧通常都不会报错。需要安装
k8s-addons.tar.gz 中的 40-alloy-logs.yaml。部署前,检查该文件中的镜像地址和版本,确保各节点能够获取镜像;下载包内的镜像版本不会随站点配置自动更新。根据运维平台的位置修改配置:
- 运维平台在本集群:
http://ops-loki.<运维平台所在命名空间>.svc.cluster.local:3100/loki/api/v1/push,ENV_LOKI_PUSH_TOKEN留空 - 运维平台在其它集群:
ops-loki是 ClusterIP、跨集群无法访问,要走网关http://<运维平台地址>:30881/mdis/loki/api/v1/push,并把ENV_LOKI_PUSH_TOKEN填成运维平台的ENV_OPS_TOKEN(网关那条写入入口用 Bearer 鉴权,不填返回 401)
这两项配置错误通常不会产生显式报错,界面表现为面板无数据。
修改后在被监控集群中部署:
kubectl apply -f k8s-addons/00-namespace.yaml
kubectl apply -f k8s-addons/40-alloy-logs.yaml
两个面板的详细说明见 日志查询。