Graylog Extended Log Format (GELF) Go 库安装与配置指南

1. 项目基础介绍

本项目是一个用 Go 语言编写的开源库，旨在为 Go 应用程序提供发送日志到 Graylog 服务器的能力。GELF（Graylog Extended Log Format）是一种应用层日志协议，它克服了传统 syslogging 的许多限制。本项目支持将日志通过 UDP 协议发送到 Graylog 服务器，并且提供了一个 io.Writer 接口，可以将标准库的日志输出重定向到 Graylog。

主要编程语言：Go

2. 关键技术和框架

本项目使用的主要技术是 GELF 协议，它允许日志消息在网络上传输，尤其是支持将较长的日志消息拆分到多个数据包中。此外，该项目使用了 GoPkg.in 作为版本控制工具，以便于 Go 项目的版本管理。

3. 安装和配置准备工作及步骤

准备工作

• 安装 Go 开发环境（Go 1.10 或以上版本）
• 配置 Graylog 服务器（确保服务器运行正常并开放了接收日志的端口，默认为 12201）
• 确保你的防火墙设置允许从你的 Go 应用程序到 Graylog 服务器的出站连接

安装步骤

步骤 1：获取 go-gelf 库

打开终端，使用 go get 命令来安装 go-gelf 库。

go get gopkg.in/Graylog2/go-gelf.v1/gelf

这条命令会下载并安装 go-gelf 的最新 v1 版本的库文件到你的 Go 代码工作空间。

步骤 2：创建 Go 应用程序

在你的工作空间中创建一个新的 Go 文件，例如 main.go，并在文件中编写如下代码：

package main

import (
    "flag"
    "gopkg.in/Graylog2/go-gelf.v1/gelf"
    "io"
    "log"
    "os"
)

func main() {
    var graylogAddr string
    flag.StringVar(&graylogAddr, "graylog", "", "graylog server addr")
    flag.Parse()

    if graylogAddr != "" {
        gelfWriter, err := gelf.NewWriter(graylogAddr)
        if err != nil {
            log.Fatalf("gelf.NewWriter: %s", err)
        }

        // 将日志输出到 stderr 和 graylog
        log.SetOutput(io.MultiWriter(os.Stderr, gelfWriter))
        log.Printf("logging to stderr & graylog2@'%s'", graylogAddr)
    }

    // 之后的日志调用将同时输出到 stdout 和 Graylog 服务器
    log.Printf("Hello gray World")
}

步骤 3：编译和运行程序

使用 go build 命令编译你的程序，然后运行它，同时指定 Graylog 服务器的地址：

go build main.go
./main -graylog=localhost:12201

替换 localhost:12201 为你的 Graylog 服务器的实际地址和端口。

完成以上步骤后，你的 Go 应用程序应该就能够将日志发送到配置好的 Graylog 服务器了。