site24x7/poller_docker_agent

Site24x7 On-Premise Poller Docker镜像文档

镜像概述

Site24x7 On-Premise Poller Docker镜像是Site24x7提供的容器化监控代理，专为企业内部网络环境设计。通过在本地网络部署该镜像，可监控无法直接从公网访问的内部资源（如私有服务器、内网应用、数据库等），并将采集的性能数据加密传输至Site24x7云平台，帮助用户实现跨环境统一监控、告警与数据分析。

核心功能与特性

主要功能

• 多类型资源监控：支持监控服务器（CPU、内存、磁盘等系统指标）、网络设备（交换机、路由器等）、应用程序（HTTP/HTTPS服务、Java应用、.NET应用等）、数据库（MySQL、PostgreSQL、Oracle等）及自定义服务。
• 数据加密传输：采用TLS加密协议将监控数据安全发送至Site24x7云平台，保障数据传输过程中的机密性。
• 低资源占用：容器化设计，运行时资源消耗低，适合部署在资源受限的边缘环境或小型服务器。
• 自动更新：支持通过Docker镜像版本更新实现Poller功能升级，简化维护流程。
• 灵活配置：支持通过环境变量或配置文件自定义监控项、采集频率、代理设置等。

关键特性

• 与Site24x7云平台无缝集成，统一监控视图与告警管理
• 支持离线缓存，网络中断时临时存储数据，恢复后自动同步
• 提供详细日志，便于问题排查与调试
• 兼容主流Linux发行版的Docker环境

使用场景与适用范围

适用场景

• 企业内部网络监控：监控无公网IP的内部服务器、数据库、应用系统
• 私有云/数据中心：监控私有云环境（如VMware、OpenStack）及数据中心基础设施
• 边缘计算环境：在边缘节点部署，监控边缘设备与本地化应用
• 混合云架构：结合Site24x7云监控，实现跨公有云、私有云、本地环境的统一监控

适用用户

• IT运维团队：集中管理企业内部与云端资源的监控数据
• DevOps工程师：监控CI/CD流水线、内部测试环境的应用性能
• 系统管理员：实时掌握服务器、网络设备的运行状态与健康度

使用方法与配置说明

前提条件

1. 已注册Site24x7账户，并在Site24x7控制台获取Poller密钥（Poller Key）
2. 部署环境已安装Docker Engine（20.10+）或Docker Desktop
3. 容器需具备访问内部监控目标（如服务器、网络设备）及Site24x7云平台（https://www.site24x7.com）的网络权限

获取镜像

从Docker Hub或Site24x7官方镜像仓库拉取最新版本镜像：

bash
docker pull docker.xuanyuan.run/site24x7/onpremise-poller:latest

快速部署（Docker Run）

使用以下命令启动容器，需替换<POLLER_KEY>为实际的Poller密钥：

bash
docker run -d \
  --name site24x7-onprem-poller \
  --restart unless-stopped \
  -e POLLER_KEY=<POLLER_KEY> \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \  # 可选，用于监控容器（需宿主机Docker权限）
  site24x7/onpremise-poller:latest

环境变量说明

Docker Compose配置

创建docker-compose.yml文件，配置示例如下：

yaml
version: '3.8'
services:
  site24x7-poller:
    image: docker.xuanyuan.run/site24x7/onpremise-poller:latest
    container_name: site24x7-onprem-poller
    restart: unless-stopped
    environment:
      - POLLER_KEY=<POLLER_KEY>  # 替换为实际Poller密钥
      - LOG_LEVEL=INFO
      # 如需代理，添加以下配置
      # - PROXY_HOST=proxy.example.com
      # - PROXY_PORT=8080
      # - PROXY_USER=proxy_user
      # - PROXY_PASSWORD=proxy_pass
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 可选，用于监控宿主机容器
    networks:
      - monitor-network

networks:
  monitor-network:
    driver: bridge

启动容器：

bash
docker-compose up -d

验证部署

1. 检查容器状态：

   bash
   docker ps | grep site24x7-onprem-poller
   

2. 查看容器日志，确认Poller已成功连接Site24x7云平台：

   bash
   docker logs -f site24x7-onprem-poller
   

   成功连接日志示例："Poller authenticated successfully with Site24x7 cloud. Starting data collection..."
3. 登录Site24x7控制台，在「On-Premise Pollers」页面查看已部署的Poller状态（显示为「Active」）

配置与管理

• 添加监控目标：在Site24x7控制台「监控」→「添加监控」中，选择监控类型（如服务器、数据库），并指定使用已部署的On-Premise Poller进行监控。
• 更新Poller：通过拉取最新镜像并重启容器实现更新：

  bash
  docker pull docker.xuanyuan.run/site24x7/onpremise-poller:latest
  docker restart site24x7-onprem-poller
  

• 卸载Poller：

  bash
  docker stop site24x7-onprem-poller
  docker rm site24x7-onprem-poller
  

注意事项

• Poller密钥（POLLER_KEY）是容器与Site24x7云平台通信的唯一凭证，需妥善保管，避免泄露。
• 确保容器运行用户对/var/run/docker.sock（如挂载）有只读权限，避免权限过高导致安全风险。
• 监控大型环境时，建议根据监控目标数量调整容器资源限制（如通过--memory、--cpus参数限制资源使用）。
• 如网络环境存在防火墙，需开放容器到Site24x7云平台的出站HTTPS（443端口）通信。