Synthetics Private Location Worker Docker镜像文档

镜像概述与主要用途

Synthetics Private Location Worker是Datadog Synthetics的官方Docker镜像，用于部署私有位置（Private Location） Worker节点。该镜像允许用户在私有网络环境中执行合成监控测试（如API测试、浏览器测试、SSL证书检查等），并将测试结果上报至Datadog平台，实现对内部服务、私有应用及无法通过公网访问的资源的监控。

支持的架构

• amd64

核心功能与特性

• 私有网络测试执行：在用户私有环境中运行Datadog Synthetics测试，无需暴露内部资源至公网。
• 与Datadog平台集成：自动与Datadog后端通信，上报测试结果、性能指标及日志。
• 兼容性：支持Datadog Synthetics的各类测试类型（HTTP、TCP、ICMP、浏览器测试等）。
• 轻量级部署：通过Docker容器化部署，简化环境配置与版本管理。

使用场景与适用范围

• 私有网络监控：监控企业内部数据中心、私有云或混合云环境中的应用与服务。
• 内部服务可用性检测：验证内部API、数据库、消息队列等组件的可用性与性能。
• 隔离环境测试：在开发、测试或预发布环境中执行合成测试，确保上线前质量。
• 合规性要求：满足数据隐私或合规性要求，避免敏感测试数据通过公网传输。

使用方法与配置说明

前提条件

• 已在Datadog平台创建私有位置（Private Location），获取私有位置ID及配置凭证。
• 已安装Docker或Docker Compose环境。
• 容器需能够访问Datadog API端点（[***] 或对应区域端点）及私有网络内的目标资源。

Docker Run部署示例

docker run -d \
  --name datadog-synthetics-worker \
  -e DD_API_KEY=<YOUR_DATADOG_API_KEY> \
  -e DD_SYNTHETICS_PRIVATE_LOCATION_ID=<YOUR_PRIVATE_LOCATION_ID> \
  -e DD_REGION=<YOUR_DATADOG_REGION> \  # 如"us1"、"eu1"，默认"us1"
  gcr.io/datadoghq/synthetics-private-location-worker:latest

注意：上述环境变量为示例，具体配置参数需参考Datadog私有位置文档获取完整列表（如代理配置、资源限制等）。

Docker Compose部署示例

创建docker-compose.yml文件：

version: '3'
services:
  synthetics-worker:
    image: gcr.io/datadoghq/synthetics-private-location-worker:latest
    container_name: datadog-synthetics-worker
    environment:
      - DD_API_KEY=<YOUR_DATADOG_API_KEY>
      - DD_SYNTHETICS_PRIVATE_LOCATION_ID=<YOUR_PRIVATE_LOCATION_ID>
      - DD_REGION=us1  # 根据实际区域调整
      # 如需代理，添加代理配置（示例）
      # - HTTP_PROXY=[***]
      # - HTTPS_PROXY=[***]
    restart: always
    # 根据测试需求调整资源限制
    resources:
      limits:
        cpus: '2'
        memory: 2G

启动容器：

docker-compose up -d

支持与故障排除

• 文档参考：私有位置的详细配置与管理，请参见Datadog官方文档。
• 问题反馈：如遇部署或运行问题，可通过Datadog支持团队获取帮助。

许可证信息

本软件的使用与操作受《最终用户许可协议》（EULA）约束，详情参见此处。

与所有Docker镜像一样，本镜像可能包含其他软件，这些软件可能受其他许可证约束（如基础发行版中的Bash等，以及主软件的直接或间接依赖项）。使用预构建镜像时，用户有责任确保其使用符合镜像中所有软件的相关许可证要求。

本镜像包含第三方分发的软件，以下是这些库及其许可证的列表：