当前位置：首页 > news >正文

Docker：安装 Syslog-ng 的技术指南

news 2025/11/1 16:07:50

1、简述

Syslog-ng 是一种流行的日志管理工具，能够集中处理和分析日志。通过 Docker 安装 Syslog-ng 可以简化部署和管理过程。本文将介绍如何使用 Docker 安装 Syslog-ng，并提供一个 Java 示例来展示如何将日志发送到 Syslog-ng。
在这里插入图片描述

2、安装

2.1 创建 Docker Compose 文件

先创建Syslog-ng 容器外的映射目录：

mkdir -p /data/syslog/conf
mkdir -p /data/syslog/logs

在项目目录下创建一个 docker-compose.yml 文件：

version: '3'services:syslog-ng:image: balabit/syslog-ngports:- "514:514/udp"volumes:- /data/syslog/conf:/etc/syslog-ng/- /data/syslog/logs:/var/log/syslog-ng

2.2 创建 Syslog-ng 配置文件

在项目目录下创建 /data/syslog/conf 目录，并在该目录下创建一个配置文件 syslog-ng.conf：

@version: 3.30
@include "scl.conf"source s_network {syslog(transport(udp) port(514));
};destination d_local {file("/var/log/syslog-ng/messages.log");
};log {source(s_network);destination(d_local);
};

2.3 启动 Syslog-ng 容器

在项目目录下运行以下命令启动 Syslog-ng 容器：

docker-compose up -d

3、样例

3.1 引入依赖

在 Spring Boot 项目的 pom.xml 文件中引入 logback 相关依赖：

<dependencies><!-- Spring Boot Starter --><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId></dependency><!-- Logback Classic --><dependency><groupId>ch.qos.logback</groupId><artifactId>logback-classic</artifactId></dependency><!-- Logback Syslog Appender --><dependency><groupId>net.logstash.logback</groupId><artifactId>logstash-logback-encoder</artifactId><version>6.6</version></dependency>
</dependencies>

3.2 配置 Logback

在 src/main/resources 目录下创建或编辑log4j.properties 文件：

log4j.appender.SYSLOG=org.apache.log4j.net.SyslogAppender
log4j.appender.SYSLOG.syslogHost=192.168.157.129
log4j.appender.SYSLOG.facility=local0
log4j.appender.SYSLOG.facilityPrinting=false
log4j.appender.SYSLOG.layout=org.apache.log4j.PatternLayout
log4j.appender.SYSLOG.layout.ConversionPattern=%d{dd-MM-yyyy HH:mm:ss}  %-5p (%C:%M:%L) - %m%nlog4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{dd-MM-yyyy HH:mm:ss}  %-5p (%C:%M:%L) - %m%nlog4j.rootLogger=info, CONSOLE, SYSLOG

3.3 示例代码

创建一个简单的 Spring Boot 应用程序，包含一个控制器来生成一些日志：

package com.example.demo;import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class LogController {private static final Logger logger = LoggerFactory.getLogger(LogController.class);@GetMapping("/log")public String log() {logger.info("This is an info log message");logger.debug("This is a debug log message");logger.error("This is an error log message");return "Logs have been sent to Syslog-ng";}
}

4、验证

启动 Spring Boot 应用程序并访问 http://localhost:8080/log。然后查看 syslog-ng/logs/messages.log 文件，以确保日志已经成功发送到 Syslog-ng：

docker exec -it <container_id> cat /var/log/syslog-ng/messages.log

你应该会看到类似如下的日志内容：

Jul 30 12:34:56 localhost LogController: [main] LogController - This is an info log message
Jul 30 12:34:56 localhost LogController: [main] LogController - This is a debug log message
Jul 30 12:34:56 localhost LogController: [main] LogController - This is an error log message

5、结论

通过上述步骤，我们成功地使用 Docker 安装了 Syslog-ng，并在 Spring Boot 应用程序中集成了日志发送功能。这种方法不仅简化了 Syslog-ng 的部署，还提高了日志管理的灵活性和效率。如果有任何问题或改进建议，欢迎在评论区留言。

希望这篇博客对你有所帮助！