Overview

Full name
docker.io/kubehan/promai
Registry
docker.io
Namespace
kubehan
Repository
promai
Cached tags
96
Last synced
07/06/2026, 07:53 PM

Introduction

PromAI 智能运维助手镜像,结合 Prometheus 指标与自然语言查询,用 LLM 解释告警根因并生成 PromQL,适合 SRE 值班辅助。

Details

kubehan/promai 将 Prometheus HTTP API 与大模型编排为 Chat 界面,支持上传告警上下文、自动生成查询与 Runbook 建议。部署需配置 Prometheus URL 与 OpenAI 兼容 API Key; outbound 网络需可达 LLM 端点。适合内网可观测性 Copilot 原型,注意 PromQL 生成结果需人工复核后再执行,避免误删数据。

快速启动

docker run -d --name promai \
  -p 8080:8080 \
  -e PROMETHEUS_URL=http://prometheus:9090 \
  -e OPENAI_API_KEY=sk-xxx \
  docker.io/kubehan/promai:latest

推荐实践

docker run -d --name promai \
  --restart unless-stopped \
  -p 8080:8080 \
  -e PROMETHEUS_URL=http://prometheus.monitoring.svc:9090 \
  -e OPENAI_API_KEY=sk-xxx \
  -e OPENAI_BASE_URL=https://api.openai.com/v1 \
  -e TZ=Asia/Shanghai \
  docker.io/kubehan/promai:1.2.0

核心参数说明

  • -e PROMETHEUS_URL — 目标 Prometheus 基址
  • -e OPENAI_API_KEY — 大模型 API 密钥
  • -e OPENAI_BASE_URL — 兼容私有化 LLM 网关
  • -p 8080:8080 — Web Chat 界面
  • --restart unless-stopped — 值班助手持续可用

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: promai
spec:
  replicas: 1
  selector:
    matchLabels:
      app: promai
  template:
    metadata:
      labels:
        app: promai
    spec:
      containers:
        - name: promai
          image: docker.io/kubehan/promai:1.2.0
          ports:
            - containerPort: 8080
          env:
            - name: PROMETHEUS_URL
              value: http://prometheus.monitoring.svc:9090
            - name: OPENAI_API_KEY
              valueFrom:
                secretKeyRef:
                  name: promai-secrets
                  key: openai-key
---
apiVersion: v1
kind: Service
metadata:
  name: promai
spec:
  selector:
    app: promai
  ports:
    - port: 8080
      targetPort: 8080

API Key 存 Secret;NetworkPolicy 允许访问 monitoring 命名空间 9090 与 LLM Egress,Ingress 限制 SRE 组访问。

Latest tags (20)

View all 96 tags →
TagArchPushed AtSizeDigestSyncWishAction
docker.io/kubehan/promai
:latest
linux/amd64linux/arm64
2026/07/02 23:3215.0 MBsha256:3964c7e1810f
docker.io/kubehan/promai
:main-2026-07-02_15-16
linux/amd64linux/arm64
2026/07/02 23:3215.0 MBsha256:3964c7e1810f
docker.io/kubehan/promai
:main-2026-06-30_16-50
linux/amd64linux/arm64
2026/07/01 01:0715.0 MBsha256:95cf9bf5d42e
docker.io/kubehan/promai
:main-2026-06-30_16-47
linux/amd64linux/arm64
2026/07/01 01:0415.0 MBsha256:0b770fcbe019
docker.io/kubehan/promai
:main-2026-06-30_16-46
linux/amd64linux/arm64
2026/07/01 01:0415.0 MBsha256:c62cfc042d8c
docker.io/kubehan/promai
:main-2026-06-30_16-32
linux/amd64linux/arm64
2026/07/01 00:5015.0 MBsha256:1b573867bba1
docker.io/kubehan/promai
:main-2026-06-30_16-04
linux/amd64linux/arm64
2026/07/01 00:2115.0 MBsha256:cb12553ba5b1
docker.io/kubehan/promai
:main-2026-06-30_15-57
linux/amd64linux/arm64
2026/07/01 00:1315.0 MBsha256:f7112ac0fb66
docker.io/kubehan/promai
:main-2026-06-30_14-32
linux/amd64linux/arm64
2026/06/30 22:4915.0 MBsha256:04ef0bde4a75
docker.io/kubehan/promai
:main-2026-06-29_15-49
linux/amd64linux/arm64
2026/06/30 00:0615.0 MBsha256:5b0251aceaa0
docker.io/kubehan/promai
:main-2026-06-29_14-52
linux/amd64linux/arm64
2026/06/29 23:0815.0 MBsha256:8516258797f8
docker.io/kubehan/promai
:main-2026-06-29_14-49
linux/amd64linux/arm64
2026/06/29 23:0615.0 MBsha256:5e542a2e55bd
docker.io/kubehan/promai
:main-2026-06-29_14-47
linux/amd64linux/arm64
2026/06/29 23:0415.0 MBsha256:b0a6a79e2491
docker.io/kubehan/promai
:main-2026-06-29_14-34
linux/amd64linux/arm64
2026/06/29 22:5115.0 MBsha256:8ed6c84e6341
docker.io/kubehan/promai
:main-2026-06-29_14-32
linux/amd64linux/arm64
2026/06/29 22:5015.0 MBsha256:5d59b0a5573d
docker.io/kubehan/promai
:main-2026-06-29_14-28
linux/amd64linux/arm64
2026/06/29 22:4515.0 MBsha256:8679c40ba90f
docker.io/kubehan/promai
:main-2026-06-29_10-08
linux/amd64linux/arm64
2026/06/29 18:2415.0 MBsha256:0ad48377758b
docker.io/kubehan/promai
:main-2026-06-27_02-40
linux/amd64linux/arm64
2026/06/27 10:5514.8 MBsha256:1b2b42c75ed1
docker.io/kubehan/promai
:main-2026-06-18_01-49
linux/amd64linux/arm64
2026/06/18 10:0611.2 MBsha256:b0868829bb23
docker.io/kubehan/promai
:main-2026-06-17_10-06
linux/amd64linux/arm64
2026/06/17 18:2311.2 MBsha256:99a937eb3546