nomad-journald-logs 镜像文档

概述

nomad-journald-logs镜像是一个专为Nomad集群设计的日志收集工具，旨在高效收集Nomad任务产生的journald日志，并提供灵活的日志转发能力，帮助用户实现集群内任务日志的集中化管理、存储与分析。

核心功能与特性

• 实时日志收集：实时监控并收集Nomad任务的journald日志，确保日志数据的及时性。
• 多目标日志转发：支持将日志转发至多种日志系统，如Elasticsearch、Logstash、Fluentd、AWS CloudWatch等。
• 日志过滤与处理：可根据任务ID、服务名称等条件对日志进行过滤，支持日志格式转换（如JSON格式化）。
• Nomad元数据关联：自动关联Nomad任务元数据（如任务ID、分配ID、节点信息等），丰富日志上下文。
• 轻量级设计：镜像体积小，资源占用低，适合在Nomad集群节点中部署运行。

使用场景与适用范围

• Nomad集群日志集中管理：适用于需要统一收集、存储和分析Nomad集群中所有任务日志的场景。
• 分布式应用故障排查：通过集中化日志，快速定位分布式应用在Nomad集群中运行时的问题。
• 合规性与审计需求：满足对任务运行日志的长期存储和审计要求，支持日志留存策略配置。

使用方法与配置说明

环境变量配置

镜像通过环境变量进行配置，常用环境变量如下：

Docker Run命令示例

docker run -d \
  --name nomad-journald-logs \
  --volume /var/log/journal:/var/log/journal:ro \
  --volume /run/systemd/journal/socket:/run/systemd/journal/socket \
  -e NOMAD_ADDR="[***]" \
  -e LOG_DESTINATIONS="elasticsearch" \
  -e ELASTICSEARCH_URL="[***]" \
  -e LOG_FORMAT="json" \
  roomsh/nomad-journald-logs

Docker Compose配置示例

version: '3'
services:
  nomad-journald-logs:
    image: roomsh/nomad-journald-logs
    volumes:
      - /var/log/journal:/var/log/journal:ro
      - /run/systemd/journal/socket:/run/systemd/journal/socket
    environment:
      - NOMAD_ADDR=[***]
      - LOG_DESTINATIONS=elasticsearch,logstash
      - ELASTICSEARCH_URL=[***]
      - LOGSTASH_URL=tcp://logstash:5000
      - LOG_FORMAT=json
    restart: always

注意事项

• 容器需挂载主机的/var/log/journal目录（只读）和/run/systemd/journal/socket套接字，以访问journald日志。
• 根据日志转发目标，需确保目标服务（如Elasticsearch、Logstash）可访问，并正确配置对应的环境变量。
• 对于大规模Nomad集群，建议在每个节点部署该镜像以提高日志收集效率。