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

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

article 2024/10/23 23:22:01

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-ng
    ports:
      - "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%n

log4j.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%n

log4j.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