telicent/smart-cache-debug-tools

智能缓存调试工具Docker镜像文档

镜像概述

本Docker镜像提供智能缓存调试功能，专注于Kafka主题中RDF（资源描述框架）内容的处理。通过集成检查、捕获和重放功能，帮助开发与运维人员高效调试Kafka RDF数据流，定位数据处理过程中的问题，提升调试效率。

核心功能和特性

主要功能

• Kafka RDF内容检查：实时查看指定Kafka主题中的RDF数据内容，支持格式化展示与基本语法校验
• RDF数据捕获：捕获Kafka主题中的RDF数据流并存储，支持按时间范围、数据量等条件筛选
• RDF内容重放：将已捕获的RDF数据重新发送至指定Kafka主题，支持速率控制和数据过滤
• 智能缓存机制：内置缓存策略，减少重复数据处理开销，提升调试操作响应速度

使用场景和适用范围

典型使用场景

• Kafka RDF数据流异常排查：检查主题中RDF数据格式、内容完整性
• RDF数据处理流程验证：通过捕获和重放功能，验证下游服务对RDF数据的处理逻辑
• 缓存机制调试：分析智能缓存对RDF数据处理性能的影响
• 开发环境数据模拟：重放生产环境捕获的RDF数据，在开发环境复现问题

适用人群

• Kafka RDF数据开发工程师
• 数据平台运维人员
• RDF数据处理系统测试人员

使用方法和配置说明

前置条件

• 已安装Docker引擎（20.10+版本）
• 可访问目标Kafka集群（需开放网络端口）
• 具备Kafka主题操作权限（读/写权限，根据操作类型）

Docker Run示例

bash
docker run -d \
  --name smart-cache-debug \
  -e KAFKA_BROKERS=kafka-cluster:9092 \
  -e TARGET_TOPIC=rdf-data-stream \
  -e CACHE_MAX_ENTRIES=5000 \
  smart-cache-debug-tools:latest

Docker Compose示例

yaml
version: '3.8'
services:
  smart-cache-debug:
    image: smart-cache-debug-tools:latest
    container_name: smart-cache-debug
    environment:
      - KAFKA_BROKERS=kafka:9092
      - TARGET_TOPIC=rdf-processing-topic
      - CACHE_MAX_ENTRIES=10000
      - LOG_LEVEL=info
    network_mode: "host"  # 如需直接访问主机Kafka服务

环境变量配置

基本操作命令

容器启动后，可通过docker exec进入容器执行调试命令：

• 检查Kafka主题RDF内容：./debug-tool inspect --topic $TARGET_TOPIC
• 捕获RDF数据：./debug-tool capture --duration 300s（捕获5分钟数据）
• 重放捕获数据：./debug-tool replay --file /app/captures/20240520-1200-capture.json

注意事项

• 确保Kafka集群与容器网络互通，可通过--network参数指定自定义网络
• 捕获大量数据时建议挂载宿主机目录到CAPTURE_DIR，避免容器存储限制
• 重放操作前需确认目标主题存在且有写入权限
• 生产环境使用时建议限制CACHE_MAX_ENTRIES，避免内存溢出