跳到主要内容

环境变量

通用 / 网关 (Gateway)

环境变量名说明
ENV_OPS_TOKEN运维平台的访问认证密钥,首次部署务必修改
ENV_OPS_SUB_PATH反向代理子路径,直接端口访问时无需配置,配置后网关、Grafana 均自动适配 GF_SERVER_ROOT_URLGF_SERVER_SERVE_FROM_SUB_PATH。示例:/mdis
ENV_OPS_PORTops-server 内部监听端口,默认 8081,通常无需修改
ENV_OPS_GATEWAY_PORT网关对外端口,默认 48881

主机监控 (Node Exporter)

环境变量名说明
ENV_PROMETHEUS_HOSTNode_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_MODEK8s 监控模式:off(默认,不启用)/ static(集群外,Docker Compose 远程抓取)/ incluster(集群内,Pod 自动发现)
ENV_PROMETHEUS_K8S_KSMstatic 模式 kube-state-metrics 地址,格式 别名/IP:NodePort。示例:k8s/192.168.1.10:30080
ENV_PROMETHEUS_K8S_NODEstatic 模式 K8s node_exporter 地址,多节点逗号分隔。示例:n1/192.168.1.10:30081,n2/192.168.1.11:30081
ENV_PROMETHEUS_K8S_KUBELETstatic 模式 kubelet HTTPS 端点(采集容器级 cAdvisor 指标),格式 别名/IP:10250,多节点逗号分隔。示例:n1/192.168.1.10:10250
ENV_K8S_BEARER_TOKENstatic 模式抓 kubelet 用的 ServiceAccount token(需 nodes/proxy 权限,由 15-metrics-reader.yaml 提供)
ENV_K8S_BEARER_TOKEN_FILE同上,改用已挂载的 token 文件路径(与 ENV_K8S_BEARER_TOKEN 二选一)
ENV_K8S_KSM_NAMESPACEincluster 模式 kube-state-metrics 所在命名空间,默认 mdis-monitoring

中间件 Exporter 代理地址

环境变量名说明
ENV_PROMETHEUS_KAFKAKafka 监控代理地址,默认无需修改。示例:kafka_1/agent:9308
ENV_PROMETHEUS_ELASTICSEARCHElasticsearch 监控代理地址,默认无需修改。示例:elasticsearch_1/agent:9114
ENV_PROMETHEUS_REDISRedis 监控代理地址,默认无需修改。示例:redis_1/agent:9121
ENV_PROMETHEUS_MONGODBMongoDB 监控代理地址,默认无需修改。示例:mongodb_1/agent:9216
ENV_PROMETHEUS_MYSQLMySQL 监控代理地址,默认无需修改。示例:mysql_1/agent:9104
ENV_PROMETHEUS_SERVERPrometheus 内部访问地址。示例:http://ops-prometheus:9090

中间件连接信息

环境变量名说明
ENV_MYSQL_HOSTMySQL 数据库主机地址。示例:10.206.0.6
ENV_MYSQL_PORTMySQL 数据库连接端口。示例:3306
ENV_MYSQL_USERNAMEMySQL 数据库用户名。示例:root
ENV_MYSQL_PASSWORDMySQL 数据库密码。示例:123456
ENV_MONGODB_URIMongoDB 连接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_OPTIONSMongoDB 附加连接选项,通常指定认证库为 admin,如果数据库未开启认证,则此值可为空。示例:?authSource=admin
ENV_REDIS_HOSTRedis 数据库主机地址。示例:10.206.0.6
ENV_REDIS_PORTRedis 数据库连接端口。示例:6379
ENV_REDIS_PASSWORDRedis 数据库密码。示例:123456
ENV_KAFKA_ENDPOINTSKafka 服务地址。如果是集群只需填写一个节点,示例:10.206.0.6:9092
ENV_ELASTICSEARCH_ENDPOINTSElasticsearch 服务地址。如果是集群只需填写一个节点,示例:http://10.206.0.6:9200
ENV_ELASTICSEARCH_PASSWORDElasticsearch 用户及密码。示例:elastic:kF44FEchQU9k
ENV_FLINK_URLFlink Web 服务地址,若不需要或没有部署 Flink 可注释。示例: http://flink:8081

数据保留时长

环境变量名说明
ENV_PROMETHEUS_RETENTIONPrometheus 指标数据保留时长,不配置时默认 15d。示例:30d
ENV_LOKI_RETENTIONLoki 日志数据保留时长,不配置时默认 720h(30 天)。示例:360h
ENV_TEMPO_RETENTIONTempo 链路数据保留时长,不配置时默认 720h(30 天)。示例:360h

Alloy(统一可观测性采集)

环境变量名说明
ENV_TEMPO_GRPC_URLalloy 转发链路数据到 Tempo 的 gRPC 地址。示例:http://ops-tempo:4317
ENV_PROMETHEUS_REMOTE_WRITE_URLalloy 通过 remote_write 上报指标到 Prometheus 的地址。示例:http://ops-prometheus:9090/api/v1/write
ENV_LOKI_PUSH_URLalloy 推送日志到 Loki 的 HTTP API 地址。示例:http://ops-loki:3100/loki/api/v1/push

Loki S3/MinIO 存储(可选)

不配置时使用 Loki 本地文件系统存储。

环境变量名说明
ENV_S3_ENDPOINTS3 兼容存储端点。示例:http://minio:9000
ENV_S3_BUCKET用于存放日志的 bucket 名。示例:loki
ENV_S3_ACCESS_KEYS3 access key
ENV_S3_SECRET_KEYS3 secret key

告警邮件(可选)

环境变量名说明
ENV_SMTP_ENABLED启用 SMTP 邮件能力。示例:true
ENV_SMTP_HOSTSMTP 邮箱服务器地址。示例:smtp.example.com
ENV_SMTP_PORTSMTP 邮箱服务器端口。示例:465
ENV_SMTP_USERSMTP 邮箱服务器帐号。示例:ops@example.com
ENV_SMTP_PASSWORDSMTP 邮箱服务器授权码。示例:************
ENV_SMTP_SKIPVERIFY跳过对邮件服务器的 SSL/TLS 证书验证。示例:true
ENV_SMTP_FROM_ADDR告警发送邮箱。示例:ops@example.com
ENV_SMTP_FROM_NAME告警邮件标题。示例:HAP Alert