热门搜索:
jaegertracing/jaeger-remote-storage-debug
jaegertracing
远程存储代理的调试版本，用于对远程存储代理功能进行调试、日志收集和问题排查。
下载次数: 0状态：社区镜像维护者：jaegertracing仓库类型：镜像最近更新：28 天前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
远程存储代理调试版镜像文档
镜像概述和主要用途
本镜像为远程存储代理的调试版本，基于正式版远程存储代理构建，针对开发和测试场景优化。主要用于开发、测试阶段对远程存储代理的功能逻辑、数据流转、错误处理等进行调试分析，提供增强的日志输出、调试工具和性能分析能力，帮助开发人员快速定位和解决问题。
核心功能和特性
核心功能
- 实现远程存储代理基础功能，支持对S3、GCS、Azure Blob等主流远程存储服务的代理访问
- 提供请求转发、身份验证代理、数据缓存等核心代理能力
调试增强特性
- 详细日志记录：输出包含请求/响应头、 payload 摘要、错误堆栈、内部状态变更等调试级日志
- 调试接口暴露：内置 HTTP 调试端点（默认
/debug），支持查看当前连接状态、缓存命中率、请求队列等实时信息 - 性能指标收集：自动采集并暴露响应时间分布、吞吐量、错误率等性能指标（兼容 Prometheus 格式）
- 配置热更新：支持通过文件挂载或 API 动态更新配置，无需重启容器即可应用变更
- 故障注入工具：内置延迟注入、错误模拟（如随机 5xx 响应）等故障测试功能
使用场景和适用范围
适用场景
- 开发环境中调试远程存储代理的功能逻辑
- 测试环境中复现并排查生产环境中出现的代理访问问题
- 性能优化阶段分析代理瓶颈（如缓存策略、网络延迟）
- 新功能开发时验证代理与远程存储服务的兼容性
适用范围
- 开发人员、测试人员、运维调试人员
- 仅用于非生产环境（开发/测试/预发布），不建议在生产环境部署
使用方法和配置说明
获取镜像
通过 Docker Hub 或私有仓库拉取镜像：
bashdocker pull [镜像仓库地址]/remote-storage-proxy:debug-latest
基本运行命令
简单启动（默认配置）
bashdocker run -d \ --name remote-storage-proxy-debug \ -p 8080:8080 \ [镜像仓库地址]/remote-storage-proxy:debug-latest
带调试配置启动
bashdocker run -d \ --name remote-storage-proxy-debug \ -p 8080:8080 \ -p 9090:9090 \ # 性能指标暴露端口 -e LOG_LEVEL=debug \ # 开启调试级日志 -e REMOTE_STORAGE_TYPE=s3 \ # 远程存储类型（s3/gcs/azure） -e REMOTE_STORAGE_ENDPOINT=https://s3.example.com \ # 远程存储服务端点 -e DEBUG_ENDPOINT_ENABLE=true \ # 启用调试接口 -v $(pwd)/config.yaml:/app/config.yaml \ # 挂载自定义配置文件 [镜像仓库地址]/remote-storage-proxy:debug-latest
环境变量配置
通过环境变量可快速配置核心参数，常用配置如下表：
| 环境变量名 | 描述 | 默认值 | 是否必填 |
|---|---|---|---|
LOG_LEVEL | 日志级别（debug/info/warn/error） | info | 否 |
PROXY_PORT | 代理服务监听端口 | 8080 | 否 |
REMOTE_STORAGE_TYPE | 远程存储类型（s3/gcs/azure） | - | 是 |
REMOTE_STORAGE_ENDPOINT | 远程存储服务端点 URL | - | 是 |
DEBUG_ENDPOINT_ENABLE | 是否启用调试接口（true/false） | true | 否 |
METRICS_PORT | 性能指标暴露端口 | 9090 | 否 |
CACHE_SIZE_MB | 本地缓存大小（MB） | 1024 | 否 |
配置文件挂载
如需自定义详细配置（如高级缓存策略、访问控制规则），可通过挂载配置文件实现：
- 本地创建
config.yaml（参考官方配置模板） - 启动时挂载文件：
bashdocker run -d \ --name remote-storage-proxy-debug \ -p 8080:8080 \ -v $(pwd)/config.yaml:/app/config.yaml \ -e CONFIG_FILE=/app/config.yaml \ # 指定配置文件路径 [镜像仓库地址]/remote-storage-proxy:debug-latest
调试功能使用
访问调试接口
启动后通过 http://<容器IP>:8080/debug 访问调试页面，可查看：
- 当前活跃连接列表及详细信息
- 最近 100 条请求的处理日志
- 缓存统计（命中/未命中次数、缓存项分布）
查看性能指标
通过 http://<容器IP>:9090/metrics 访问 Prometheus 格式指标，关键指标包括：
proxy_request_duration_seconds：请求响应时间分布proxy_cache_hit_ratio：缓存命中率proxy_errors_total：按错误类型统计的错误总数
注意事项
- 调试版本默认开启所有调试功能，可能会增加资源消耗（CPU/内存/网络带宽），建议根据需求通过配置关闭不必要的调试特性
- 日志中可能包含敏感信息（如认证令牌、请求 payload），使用时需确保符合数据安全规范
- 不建议在生产环境使用，正式环境请使用非调试版本镜像
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 jaeger-remote-storage-debug 镜像标签
docker pull docker.xuanyuan.run/jaegertracing/jaeger-remote-storage-debug:<标签>
DockerHub 原生拉取命令
docker pull jaegertracing/jaeger-remote-storage-debug:<标签>
更多 jaeger-remote-storage-debug 镜像推荐
jaegertracing/jaeger-agent
jaegertracing
该镜像已弃用，详情请参见https://github.com/jaegertracing/jaeger/issues/4739。
28 次收藏1亿+ 次下载
1 年前更新
jaegertracing/jaeger-remote-storage
jaegertracing
远程存储代理工具，用于中转和管理远程存储资源，简化远程存储访问流程。
5万+ 次下载
7 天前更新
jaegertracing/jaeger-query
jaegertracing
暂无描述
16 次收藏1亿+ 次下载
6 个月前更新
jaegertracing/jaeger-remote-storage-debug-snapshot
jaegertracing
远程存储代理的调试版本，基于最新主干构建。
1万+ 次下载
15 小时前更新
jaegertracing/jaeger-remote-storage-snapshot
jaegertracing
提供远程存储代理服务的Docker镜像，基于最新主干构建版本。
10万+ 次下载
15 小时前更新
jaegertracing/jaeger-operator
jaegertracing
用于在Kubernetes集群中自动化部署、管理和运维Jaeger分布式追踪系统的Operator。
6 次收藏1亿+ 次下载
10 个月前更新
镜像拉取常见问题
功能
排错
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"