visity/elasticsearch-curator

docker-elasticsearch-curator 镜像文档

镜像概述

该镜像的核心功能是清理Elasticsearch中的Logstash历史日志，仅保留配置指定天数的日志数据，并按照设定的时间间隔自动执行清理任务。旨在帮助用户管理Elasticsearch日志存储，避免日志无限制累积导致的存储资源耗尽问题。

核心功能与特性

• 自动日志清理：按配置的时间间隔自动执行Logstash历史日志清理任务
• 可配置保留天数：通过环境变量灵活设置需要保留的日志天数，超过该天数的日志将被删除
• 可配置运行间隔：支持自定义清理任务的执行频率，满足不同场景下的日志管理需求
• 容器链接支持：可直接链接Elasticsearch容器，简化服务访问配置

使用场景

适用于需要对Elasticsearch中的Logstash日志进行生命周期管理的场景，例如：

• 日志服务器：定期清理过期日志，释放存储空间
• 监控系统：控制监控日志的存储周期，确保系统高效运行
• 任何基于Elasticsearch+Logstash架构的日志收集与分析系统

使用方法与配置说明

基本使用命令

通过以下命令启动容器，执行日志清理任务：

bash
docker run -d \
  -e INTERVAL_IN_HOURS=24 \
  -e OLDER_THAN_IN_DAYS="10" \
  --link es1:elasticsearch \
  visity/elasticsearch-curator

参数说明

环境变量

• INTERVAL_IN_HOURS
  清理任务的执行间隔时间，单位为小时。例如设置为24表示每24小时执行一次清理。

• OLDER_THAN_IN_DAYS
  日志保留天数，超过该天数的日志将被删除。例如设置为10表示仅保留最近10天的日志。

容器链接

--link es1:elasticsearch 参数用于将当前容器与Elasticsearch容器链接，其中：

• es1 是Elasticsearch容器的名称
• elasticsearch 是链接别名，容器内部将通过该别名访问Elasticsearch服务

配置示例

示例1：每日清理，保留7天日志

bash
docker run -d \
  -e INTERVAL_IN_HOURS=24 \
  -e OLDER_THAN_IN_DAYS="7" \
  --link elasticsearch-container:elasticsearch \
  visity/elasticsearch-curator

示例2：每12小时清理，保留30天日志

bash
docker run -d \
  -e INTERVAL_IN_HOURS=12 \
  -e OLDER_THAN_IN_DAYS="30" \
  --link es-node:elasticsearch \
  visity/elasticsearch-curator