Docker Compose部署Elasticsearch 2.4.x如何开启查询日志？

作为和ES 2.4.x打过交道的老用户，我太清楚这个版本的日志配置和新版（比如7.x+）差异有多大了，之前踩过不少坑。下面给你一套一步步的可行方案，帮你顺利开启查询日志：

1. 准备自定义的日志配置文件 #

ES 2.4.x使用logging.yml作为日志配置文件（不是新版的log4j2格式），我们需要创建一个自定义版本来开启查询相关日志。

在本地项目目录下先建一个config文件夹，然后在里面创建logging.yml文件，内容如下：

# 基础日志配置
es.logger.level: INFO
rootLogger: ${es.logger.level}, console
logger:
  # 开启搜索查询日志（覆盖所有Search API请求）
  org.elasticsearch.action.search: DEBUG
  # 可选：开启Get API请求日志
  org.elasticsearch.action.get: DEBUG
  # 可选：开启索引/更新/删除操作日志
  org.elasticsearch.action.index: DEBUG
  org.elasticsearch.action.update: DEBUG
  org.elasticsearch.action.delete: DEBUG
  # 保留ES核心组件的默认日志级别，避免冗余日志
  org.elasticsearch: INFO
  # 抑制第三方库的冗余日志
  com.amazonaws: WARN

appender:
  console:
    type: console
    layout:
      type: pattern
      conversionPattern: "[%d{ISO8601}][%-5p][%-25c] %m%n"

说明：

• DEBUG级别会输出完整的查询DSL和请求参数，如果需要更详细的内容（比如请求头、响应体），可以改成TRACE，但日志量会大幅增加。
• 如果你只需要搜索查询日志，只保留org.elasticsearch.action.search: DEBUG这一行即可。

2. 编写Docker Compose配置文件 #

在项目根目录创建docker-compose.yml，内容如下：

version: '2' # ES 2.4.x版本较老，用compose v2兼容性更好
services:
  elasticsearch:
    image: elasticsearch:2.4.6 # 指定具体的2.4.x版本，避免自动更新到不兼容镜像
    container_name: es-local-2.4
    environment:
      - ES_JAVA_OPTS=-Xms512m -Xmx512m # 根据本地机器配置调整内存，至少保留512m
      - discovery.type=single-node # 单节点模式，避免集群发现失败导致启动异常
      - cluster.name=es-local-cluster
    ports:
      - "9200:9200"
      - "9300:9300"
    volumes:
      # 挂载自定义日志配置文件到容器默认配置路径
      - ./config/logging.yml:/usr/share/elasticsearch/config/logging.yml
      # 可选：挂载数据卷，避免容器删除后数据丢失
      - es-data-2.4:/usr/share/elasticsearch/data
    # 解决文件权限问题：ES容器默认用elasticsearch用户运行，确保挂载的配置文件可读取
    command: chmod 644 /usr/share/elasticsearch/config/logging.yml && /docker-entrypoint.sh elasticsearch

volumes:
  es-data-2.4:

关键提醒：

• command里的chmod 644是为了确保容器内的elasticsearch用户能读取挂载的logging.yml，这是很多新手启动失败的核心原因之一。
• 一定要指定具体的ES版本（比如2.4.6），避免拉取到不兼容的镜像。

3. 启动并验证日志 #

1. 启动容器：

docker-compose up -d

2. 查看实时日志：

docker-compose logs -f elasticsearch

3. 发送一个测试查询（比如用curl）：

curl -XGET 'http://localhost:9200/_search?q=*'

此时你应该能在日志中看到类似这样的DEBUG级别的查询日志：

[2024-05-20T10:00:00,123][DEBUG][org.elasticsearch.action.search.type] [es-local-2.4] [_all][0], node[abc123], [P], s[STARTED], a[id=xyz789]: Failed to execute [org.elasticsearch.action.search.SearchRequest@123456] lastShard [true]
...
[2024-05-20T10:00:00,124][DEBUG][org.elasticsearch.action.search] [es-local-2.4] All shards failed for phase: [query]

（实际日志会包含完整的查询DSL和请求详情）

常见问题排查 #

• 启动失败：检查logging.yml的YAML格式是否正确（缩进必须用空格，不能用Tab），内存设置是否足够，挂载的文件路径是否正确。
• 无查询日志输出：确认日志级别设置的是DEBUG，并且发送的查询确实命中了对应的logger（比如搜索用的是Search API，对应org.elasticsearch.action.search）。
• 无法连接ES：检查容器是否正常启动，端口映射是否正确，ES的discovery.type是否设置为single-node。

内容的提问来源于stack exchange，提问作者eirikir