expediadotcom/haystack-agent

expediadotcom/haystack-agent 镜像说明

镜像概述

expediadotcom/haystack-agent是Haystack分布式追踪系统的核心代理组件，负责接收客户端生成的span追踪数据，并将其可靠转发至Haystack收集器，为分布式系统的链路分析、性能监控和故障排查提供数据传输支撑。

核心功能

1. 接收客户端发送的span格式追踪数据
2. 适配Haystack收集器的接口协议，确保数据兼容性
3. 实现数据的可靠推送，保障追踪数据不丢失
4. 支持通过环境变量配置关键参数（如收集器地址、端口等）

使用场景

• 分布式微服务架构中，收集各服务节点的调用链路数据
• 配合Haystack系统进行服务性能瓶颈分析
• 企业级应用的分布式追踪数据集成与传输
• 微服务故障排查时的链路数据采集

配置说明

通过环境变量配置核心参数：

• HAYSTACK_COLLECTOR_URL：Haystack收集器的HTTP/GRPC地址（必填，如http://haystack-collector:9090）
• AGENT_LISTEN_PORT：代理监听的端口（默认通常为42699）
• MAX_QUEUE_SIZE：数据缓存队列的最大容量（可选，用于流量峰值处理）

部署示例

Docker Run命令

bash
docker run -d \
  --name haystack-agent \
  -p 42699:42699 \
  -e HAYSTACK_COLLECTOR_URL=http://your-collector-host:9090 \
  expediadotcom/haystack-agent

Docker Compose示例

yaml
version: '3.8'
services:
  haystack-agent:
    image: expediadotcom/haystack-agent
    ports:
      - "42699:42699"
    environment:
      - HAYSTACK_COLLECTOR_URL=[***]
      - AGENT_LISTEN_PORT=42699
    restart: always