xenit/alfresco-solr6-xenit

Solr 6 遥测版 Docker 镜像文档

镜像概述

本镜像基于 Solr 6 版本构建，集成遥测功能，提供开箱即用的企业级搜索引擎服务。通过内置的监控组件，可实时收集性能指标、请求数据与系统状态，适用于需要对搜索服务进行精细化管理与优化的场景。

核心功能与特性

Solr 6 基础功能

• 支持全文检索、分面搜索、高亮显示等核心搜索引擎能力
• 兼容 JSON/XML 数据格式，提供 RESTful API 接口
• 支持分布式部署（SolrCloud），具备水平扩展能力
• 内置管理界面，支持索引配置、查询调试与集群监控

遥测增强功能

• 集成性能指标采集模块，支持输出 QPS、响应时间、索引大小等关键指标
• 提供遥测数据导出接口，兼容 Prometheus、Grafana 等监控平台
• 支持自定义监控规则，可配置告警阈值与数据采样频率
• 内置日志聚合功能，记录搜索请求详情与系统异常日志

使用场景与适用范围

• 企业内部搜索引擎：用于文档管理系统、知识库的全文检索，需监控服务可用性
• 电商平台：支持商品搜索与推荐功能，需跟踪查询性能与用户检索行为
• 日志分析平台：对接 ELK 栈，提供结构化日志的快速检索，需监控索引效率
• SaaS 应用：为多租户提供搜索服务，需隔离遥测数据并按租户维度监控

使用方法与配置说明

快速启动

通过以下命令启动基础 Solr 6 服务（默认禁用遥测）：

bash
docker run -d -p 8983:8983 --name solr6-telemetry docker.xuanyuan.run/solr6-telemetry:latest

启用遥测功能

通过环境变量启用遥测并配置监控端口：

bash
docker run -d \
  -p 8983:8983 \
  -p 9090:9090 \  # 遥测数据暴露端口
  -e TELEMETRY_ENABLED=true \
  -e TELEMETRY_PORT=9090 \
  -e TELEMETRY_INTERVAL=10s \  # 指标采集间隔
  --name solr6-telemetry \
  solr6-telemetry:latest

持久化数据与配置

挂载数据卷以持久化索引数据与配置文件：

bash
docker run -d \
  -p 8983:8983 \
  -v /host/solr/data:/opt/solr/server/solr/mycores \  # 索引数据卷
  -v /host/solr/config:/opt/solr/server/solr/configsets \  # 配置文件卷
  -v /host/telemetry/logs:/var/log/telemetry \  # 遥测日志卷
  --name solr6-telemetry \
  solr6-telemetry:latest

环境变量配置

遥测数据访问

启用遥测后，可通过 http://<容器IP>:<TELEMETRY_PORT>/metrics 访问指标数据，例如：

# HELP solr_query_total Total number of search queries
# TYPE solr_query_total counter
solr_query_total{core="products"} 1250
# HELP solr_query_latency_ms Average query latency in milliseconds
# TYPE solr_query_latency_ms gauge
solr_query_latency_ms{core="products"} 42.3

注意事项

• 遥测功能会产生额外性能开销，建议在生产环境中根据实际需求调整采集间隔
• 持久化卷需确保宿主目录权限正确（容器内 Solr 用户 UID 为 8983）
• Solr 6 已停止官方维护，建议仅用于存量系统，新部署优先选择更高版本 Solr 镜像