INFINI Agent 镜像文档

镜像概述

INFINI Agent 是一款轻量级监控与数据收集工具，专为 Elasticsearch、OpenSearch 和 Easysearch 搜索引擎设计，旨在提供实时、全面的指标采集、分析与监控能力，帮助用户及时掌握搜索引擎集群的运行状态与性能表现。

核心功能与特性

• 多引擎兼容：全面支持 Elasticsearch（5.x+）、OpenSearch（1.x+）及 Easysearch 各版本集群，实现统一监控接入
• 实时指标采集：定时采集集群健康状态、节点资源使用率（CPU/内存/磁盘）、索引性能（查询QPS/延迟）等关键指标，采样间隔可配置
• 轻量化设计：容器化部署，资源占用低（默认内存<100MB），支持单机或分布式部署模式
• 灵活数据输出：支持对接 Prometheus、Grafana、Elasticsearch 等主流监控平台，便于集成现有运维体系

使用场景与适用范围

• 企业级搜索引擎监控：适用于部署 Elasticsearch/OpenSearch/Easysearch 的业务系统，实现集群全生命周期监控
• 性能优化分析：通过实时指标定位性能瓶颈（如慢查询、JVM 内存溢出、磁盘 I/O 瓶颈等）
• 故障预警与排查：支持配置指标阈值告警，提前预警集群风险（如节点离线、磁盘空间不足），加速故障排查
• 多集群统一管理：支持同时监控多个异构搜索引擎集群，满足复杂架构下的集中化运维需求

使用方法与配置说明

快速启动（Docker Run）

通过以下命令启动容器，默认连接本地搜索引擎集群（需替换 <ENDPOINT> 等参数）：

docker run -d \
  --name infini-agent \
  -p 8080:8080 \
  -e AGENT_COLLECT_INTERVAL=10s \
  -e SEARCH_ENGINE_ENDPOINTS=http://<ENDPOINT>:9200 \
  -e AUTH_USERNAME=admin \
  -e AUTH_PASSWORD=password \
  infini/agent:latest

Docker Compose 部署示例

创建 docker-compose.yml 文件，集成监控目标与 Agent：

version: '3'
services:
  infini-agent:
    image: infini/agent:latest
    container_name: infini-agent
    ports:
      - "8080:8080"  # Prometheus指标暴露端口
    environment:
      - AGENT_COLLECT_INTERVAL=10s  # 指标采集间隔
      - SEARCH_ENGINE_ENDPOINTS=[***]  # 多节点地址（逗号分隔）
      - AUTH_USERNAME=elastic
      - AUTH_PASSWORD=changeme
      - OUTPUT_PROMETHEUS_ENABLE=true  # 启用Prometheus输出
      - LOG_LEVEL=info  # 日志级别（debug/info/warn/error）
    restart: unless-stopped
    depends_on:
      - es-node1
      - es-node2

  # 示例：Elasticsearch集群（实际使用时替换为目标集群）
  es-node1:
    image: elasticsearch:8.6.0
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    ports:
      - "9200:9200"
  es-node2:
    image: elasticsearch:8.6.0
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    ports:
      - "9201:9200"

核心配置参数（环境变量）

部署验证

1. 检查容器状态：docker ps | grep infini-agent
2. 查看指标输出：curl http://localhost:8080/metrics，验证是否包含 es_cluster_health_status 等指标
3. 查看运行日志：docker logs -f infini-agent，确认无错误信息