stackstate/stackstate-agent-2

StackState Agent Docker镜像文档

镜像概述

StackState Agent是StackState监控平台的客户端组件，专门用于从各类系统和服务中采集遥测数据、拓扑信息及分布式跟踪数据。该镜像提供轻量级、可扩展的部署方式，可无缝集成到容器化环境，为StackState平台提供关键的可观测性数据输入，支持构建全面的系统运行状态视图。

核心功能和特性

• 多维度数据采集：同步收集遥测指标（如CPU、内存、网络等系统和应用指标）、拓扑关系（系统组件间的依赖关系）及分布式跟踪数据（请求路径和性能信息）
• 标准化支持：兼容OpenTelemetry等行业标准跟踪协议，确保数据格式一致性
• 轻量级设计：优化资源占用，适合在容器化环境（如Kubernetes、Docker Swarm）中部署
• 灵活配置：支持通过环境变量和配置文件自定义采集规则、目标和频率
• 自动发现：具备服务和组件自动发现能力，减少手动配置工作量

使用场景和适用范围

• 容器化环境监控：在Kubernetes、Docker等容器平台中部署，监控容器、Pod及微服务的运行状态
• 分布式系统可观测性：为微服务架构、分布式应用提供统一的遥测、拓扑和跟踪数据采集
• 企业级监控架构：作为StackState平台的核心数据采集组件，适用于中大型企业的复杂IT环境监控
• 混合云/多云环境：支持从本地数据中心、公有云及私有云环境中跨平台采集数据

使用方法和配置说明

基本部署（Docker Run）

通过以下命令快速启动StackState Agent容器：

bash
docker run -d \
  --name stackstate-agent \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc:/host/proc:ro \
  -v /sys/fs/cgroup:/host/sys/fs/cgroup:ro \
  -e STACKSTATE_API_KEY="your-api-key" \
  -e STACKSTATE_URL="https://your-stackstate-instance.stackstate.io" \
  docker.xuanyuan.run/stackstate/agent:latest

关键环境变量配置

Docker Compose配置示例

yaml
version: '3'
services:
  stackstate-agent:
    image: docker.xuanyuan.run/stackstate/agent:latest
    container_name: stackstate-agent
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 用于Docker容器监控
      - /proc:/host/proc:ro  # 用于主机系统指标采集
      - /sys/fs/cgroup:/host/sys/fs/cgroup:ro  # 用于主机资源监控
    environment:
      - STACKSTATE_API_KEY=your-api-key
      - STACKSTATE_URL=https://your-stackstate-instance.stackstate.io
      - AGENT_LOG_LEVEL=info
      - COLLECTION_INTERVAL=10

高级配置（自定义采集规则）

如需自定义采集配置（如添加特定服务监控），可通过挂载配置文件实现：

bash
docker run -d \
  --name stackstate-agent \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc:/host/proc:ro \
  -v /sys/fs/cgroup:/host/sys/fs/cgroup:ro \
  -v /path/to/custom-config:/etc/stackstate-agent/conf.d  # 挂载自定义配置目录
  -e STACKSTATE_API_KEY="your-api-key" \
  -e STACKSTATE_URL="https://your-stackstate-instance.stackstate.io" \
  stackstate/agent:latest

自定义配置目录中的.yaml文件将覆盖默认采集规则，详细配置说明请参考StackState官方文档。