ydkn/sensu-oss

Sensu Go 开源构建版 Docker 镜像文档

镜像概述

本镜像为Sensu Go的开源构建版本，提供轻量级、可扩展的监控和可观测性平台部署能力。Sensu Go是一款开源监控工具，采用现代化架构设计，支持对物理机、虚拟机、容器及云环境的统一监控，适用于DevOps和SRE工作流。该镜像封装了Sensu Go的核心组件，可快速部署并集成到现有IT基础设施中。

核心功能与特性

• 轻量级架构：组件化设计，资源占用低，支持在边缘设备到大型数据中心的各类环境部署。
• 可扩展性：通过基于角色的访问控制（RBAC）、命名空间和动态配置，支持多团队协作和大规模监控。
• 多环境监控：原生支持Kubernetes、Docker等容器环境，同时兼容传统基础设施监控。
• 数据集成：支持Prometheus、Graphite、InfluxDB等时序数据库，以及Slack、PagerDuty等告警工具。
• 自动化操作：通过检查、处理和过滤器规则，实现监控数据的自动分析与响应。
• REST API：提供完整的API接口，支持配置即代码（IaC）和第三方系统集成。

使用场景

• 中小规模基础设施监控：快速部署轻量级监控系统，覆盖服务器、网络设备等基础组件。
• 云原生环境监控：在Kubernetes集群中部署，监控Pod、Service及容器化应用健康状态。
• DevOps工作流集成：与CI/CD管道结合，实现部署前后的应用可用性验证。
• 混合云环境统一监控：跨私有云、公有云和边缘环境，提供一致的监控视图。
• 自定义业务指标监控：通过插件扩展支持业务系统指标采集与告警。

使用方法与配置说明

基本部署（Docker Run）

1. 启动Sensu Backend（核心服务）

bash
docker run -d \
  --name sensu-backend \
  -p 8080:8080 \  # API端口
  -p 8081:8081 \  # WebSocket端口（Agent通信）
  -v /path/to/sensu/data:/var/lib/sensu \  # 持久化数据目录
  -e SENSU_BACKEND_CLUSTER_ADMIN_USER=admin \  # 管理员用户名
  -e SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=P@ssw0rd \  # 管理员密码
  sensu/sensu-go:latest backend

2. 启动Sensu Agent（监控代理，需连接Backend）

bash
docker run -d \
  --name sensu-agent \
  -e SENSU_BACKEND_URL=ws://sensu-backend:8081 \  # Backend地址（需与Backend容器网络互通）
  -e SENSU_NAMESPACE=default \  # 命名空间
  -e SENSU_SUBSCRIPTIONS=linux,web \  # 订阅的检查标签（用于接收Backend下发的监控任务）
  --pid=host \  # 共享主机PID命名空间（可选，用于采集主机进程信息）
  sensu/sensu-go:latest agent

环境变量配置

持久化数据

Sensu Backend需要持久化存储配置数据、监控指标和元数据，建议挂载宿主机目录或使用Docker Volume：

bash
# 创建数据卷
docker volume create sensu-data

# 使用数据卷启动Backend
docker run -d \
  --name sensu-backend \
  -p 8080:8080 \
  -p 8081:8081 \
  -v sensu-data:/var/lib/sensu \  # 挂载数据卷
  -e SENSU_BACKEND_CLUSTER_ADMIN_USER=admin \
  -e SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=P@ssw0rd \
  sensu/sensu-go:latest backend

Docker Compose配置示例

以下是包含Backend、Agent及etcd（可选，用于高可用部署）的docker-compose.yml示例：

yaml
version: '3'

services:
  sensu-backend:
    image: sensu/sensu-go:latest
    command: backend
    ports:
      - "8080:8080"  # API端口
      - "8081:8081"  # WebSocket端口
    environment:
      - SENSU_BACKEND_CLUSTER_ADMIN_USER=admin
      - SENSU_BACKEND_CLUSTER_ADMIN_PASSWORD=P@ssw0rd
      - SENSU_LOG_LEVEL=info
    volumes:
      - sensu-data:/var/lib/sensu
    restart: unless-stopped

  sensu-agent:
    image: sensu/sensu-go:latest
    command: agent
    depends_on:
      - sensu-backend
    environment:
      - SENSU_BACKEND_URL=ws://sensu-backend:8081
      - SENSU_NAMESPACE=default
      - SENSU_SUBSCRIPTIONS=linux,web
      - SENSU_LOG_LEVEL=info
    pid: host  # 可选，用于主机进程监控
    restart: unless-stopped

volumes:
  sensu-data:

验证部署

1. 访问Sensu API（需先获取管理员Token）：

bash
# 获取认证Token
TOKEN=$(curl -X POST http://localhost:8080/api/enterprise/authentication/v2/tokens \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"P@ssw0rd"}' | jq -r .access_token)

# 验证Backend状态
curl -H "Authorization: Bearer $TOKEN" http://localhost:8080/api/core/v2/namespaces/default/health

2. 预期返回健康状态：

json
{"Alarms":[],"Healthy":true}

注意事项

• 生产环境建议部署多节点Backend实现高可用，并使用外部etcd集群存储数据。
• Agent与Backend需确保网络互通（8081端口WebSocket通信）。
• 敏感配置（如密码）建议通过Docker Secrets或环境变量注入，避免硬编码。
• 详细文档及高级配置可参考Sensu Go官方文档。