环境变量
通用 / 网关 (Gateway)
| 环境变量名 | 说明 |
|---|---|
| ENV_OPS_TOKEN | 运维平台的访问认证密钥,首次部署务必修改 |
| ENV_OPS_SUB_PATH | 反向代理子路径,直接端口访问时无需配置,配置后网关、Grafana 均自动适配 GF_SERVER_ROOT_URL 和 GF_SERVER_SERVE_FROM_SUB_PATH。示例:/mdis |
| ENV_OPS_PORT | ops-server 内部监听端口,默认 8081,通常无需修改 |
| ENV_OPS_GATEWAY_PORT | 网关对外端口,默认 48881 |
主机监控 (Node Exporter)
| 环境变量名 | 说明 |
|---|---|
| ENV_PROMETHEUS_HOST | Node_Exporter 服务地址,需替换为实际服务器IP,端口固定 59100,多个 Node_Exporter 时使用逗号分隔,格式:自定义主机名/IP:59100。 基于 Docker Compose 部署时,Node_Exporter 默认单节点,填写服务器自身内网IP即可。示例: hap_1/192.168.1.12:59100 基于 Kubernetes 部署时,Node_Exporter 是多节点,使用逗号分隔。示例: service_01/192.168.1.12:59100,service_02/192.168.1.13:59100 |
Kubernetes 集群监控
运维平台 1.3.0 起支持监控 Kubernetes 集群(节点、容器、Pod、集群对象状态),完整配置见 Kubernetes 集群监控。
| 环境变量名 | 说明 |
|---|---|
| ENV_K8S_MONITOR_MODE | K8s 监控模式:off(默认,不启用)/ static(集群外,Docker Compose 远程抓取)/ incluster(集群内,Pod 自动发现) |
| ENV_PROMETHEUS_K8S_KSM | static 模式 kube-state-metrics 地址,格式 别名/IP:NodePort。示例:k8s/192.168.1.10:30080 |
| ENV_PROMETHEUS_K8S_NODE | static 模式 K8s node_exporter 地址,多节点逗号分隔。示例:n1/192.168.1.10:30081,n2/192.168.1.11:30081 |
| ENV_PROMETHEUS_K8S_KUBELET | static 模式 kubelet HTTPS 端点(采集容器级 cAdvisor 指标),格式 别名/IP:10250,多节点逗号分隔。示例:n1/192.168.1.10:10250 |
| ENV_K8S_BEARER_TOKEN | static 模式抓 kubelet 用的 ServiceAccount token(需 nodes/proxy 权限,由 15-metrics-reader.yaml 提供) |
| ENV_K8S_BEARER_TOKEN_FILE | 同上,改用已挂载的 token 文件路径(与 ENV_K8S_BEARER_TOKEN 二选一) |
| ENV_K8S_KSM_NAMESPACE | incluster 模式 kube-state-metrics 所在命名空间,默认 mdis-monitoring |
中间件 Exporter 代理地址
| 环境变量名 | 说明 |
|---|---|
| ENV_PROMETHEUS_KAFKA | Kafka 监控代理地址,默认无需修改。示例:kafka_1/agent:9308 |
| ENV_PROMETHEUS_ELASTICSEARCH | Elasticsearch 监控代理地址,默认无需修改。示例:elasticsearch_1/agent:9114 |
| ENV_PROMETHEUS_REDIS | Redis 监控代理地址,默认无需修改。示例:redis_1/agent:9121 |
| ENV_PROMETHEUS_MONGODB | MongoDB 监控代理地址,默认无需修改。示例:mongodb_1/agent:9216 |
| ENV_PROMETHEUS_MYSQL | MySQL 监控代理地址,默认无需修改。示例:mysql_1/agent:9104 |
| ENV_PROMETHEUS_SERVER | Prometheus 内部访问地址。示例:http://ops-prometheus:9090 |
中间件连接信息
| 环境变量名 | 说明 |
|---|---|
| ENV_MYSQL_HOST | MySQL 数据库主机地址。示例:10.206.0.6 |
| ENV_MYSQL_PORT | MySQL 数据库连接端口。示例:3306 |
| ENV_MYSQL_USERNAME | MySQL 数据库用户名。示例:root |
| ENV_MYSQL_PASSWORD | MySQL 数据库密码。示例:123456 |
| ENV_MONGODB_URI | MongoDB 连接URI。示例:mongodb://root:123456@10.206.0.6:27017 副本集示例: mongodb://root:123456@10.206.0.6:27017,10.206.0.7:27017,10.206.0.8:27017 |
| ENV_MONGODB_OPTIONS | MongoDB 附加连接选项,通常指定认证库为 admin,如果数据库未开启认证,则此值可为空。示例:?authSource=admin |
| ENV_REDIS_HOST | Redis 数据库主机地址。示例:10.206.0.6 |
| ENV_REDIS_PORT | Redis 数据库连接端口。示例:6379 |
| ENV_REDIS_PASSWORD | Redis 数据库密码。示例:123456 |
| ENV_KAFKA_ENDPOINTS | Kafka 服务地址。如果是集群只需填写一个节点,示例:10.206.0.6:9092 |
| ENV_ELASTICSEARCH_ENDPOINTS | Elasticsearch 服务地址。如果是集群只需填写一个节点,示例:http://10.206.0.6:9200 |
| ENV_ELASTICSEARCH_PASSWORD | Elasticsearch 用户及密码。示例:elastic:kF44FEchQU9k |
| ENV_FLINK_URL | Flink Web 服务地址,若不需要或没有部署 Flink 可注释。示例: http://flink:8081 |
数据保留时长
| 环境变量名 | 说明 |
|---|---|
| ENV_PROMETHEUS_RETENTION | Prometheus 指标数据保留 时长,不配置时默认 15d。示例:30d |
| ENV_LOKI_RETENTION | Loki 日志数据保留时长,不配置时默认 720h(30 天)。示例:360h |
| ENV_TEMPO_RETENTION | Tempo 链路数据保留时长,不配置时默认 720h(30 天)。示例:360h |
Alloy(统一可观测性采集)
| 环境变量名 | 说明 |
|---|---|
| ENV_TEMPO_GRPC_URL | alloy 转发链路数据到 Tempo 的 gRPC 地址。示例:http://ops-tempo:4317 |
| ENV_PROMETHEUS_REMOTE_WRITE_URL | alloy 通过 remote_write 上报指标到 Prometheus 的地址。示例:http://ops-prometheus:9090/api/v1/write |
| ENV_LOKI_PUSH_URL | alloy 推送日志到 Loki 的 HTTP API 地址。示例:http://ops-loki:3100/loki/api/v1/push |
Loki S3/MinIO 存储(可选)
不配置时使用 Loki 本地文件系统存储。
| 环境变量名 | 说明 |
|---|---|
| ENV_S3_ENDPOINT | S3 兼容存储端点。示例:http://minio:9000 |
| ENV_S3_BUCKET | 用于存放日志的 bucket 名。示例:loki |
| ENV_S3_ACCESS_KEY | S3 access key |
| ENV_S3_SECRET_KEY | S3 secret key |
告警邮件(可选)
| 环境变量名 | 说明 |
|---|---|
| ENV_SMTP_ENABLED | 启用 SMTP 邮件能力。示例:true |
| ENV_SMTP_HOST | SMTP 邮箱服务器地址。示例:smtp.example.com |
| ENV_SMTP_PORT | SMTP 邮箱服务器端口。示例:465 |
| ENV_SMTP_USER | SMTP 邮箱服务器帐号。示例:ops@example.com |
| ENV_SMTP_PASSWORD | SMTP 邮箱服务器授权码。示例:************ |
| ENV_SMTP_SKIPVERIFY | 跳过对邮件服务器的 SSL/TLS 证书验证。示例:true |
| ENV_SMTP_FROM_ADDR | 告警发送邮箱。示例:ops@example.com |
| ENV_SMTP_FROM_NAME | 告警邮件标题。示例:HAP Alert |