graylog

README

Go Graylog package

This package implement Graylog GELF interface to send message using UDP or TCP transport, in Golang.

Example

package main

import (
	"github.com/thomasdseao/go-graylog"
)

func main() {
	// Create Gelf instance
	gelf := graylog.NewGelf(graylog.Config{
		"graylog1.example.com",
		2202,
		graylog.UDP,
		true,
	})
    
	// Create message and JSON encode it
	message := graylog.Message{
		Version:      "1.1",
		Host:         "example.com",
		ShortMessage: "This is the short message",
	}
	jsonMessage, _ := json.Marshal(message)
	
	// Send message
	sent, err := gelf.Send(jsonMessage)

}

Tests

go test

Contribute

Feel free to submit PR with another implementations of Graylog or improvements.

Documentation

Index

• type Config
• type Gelf
  • func NewGelf(config Config) *Gelf
  • func (gelf *Gelf) Send(message []byte) (bool, error)
• type Message
• type Transport

Types

type Config

type Config struct {
	Hostname  string
	Port      int
	Transport Transport
	ErrorLog  bool
}

type Gelf

type Gelf struct {
	Config Config
}

func NewGelf

func NewGelf(config Config) *Gelf

func (*Gelf) Send

func (gelf *Gelf) Send(message []byte) (bool, error)

type Message

type Message struct {
	Version      string                 `json:"version"`
	Host         string                 `json:"host"`
	ShortMessage string                 `json:"short_message"`
	FullMessage  string                 `json:"full_message,omitempty"`
	Timestamp    int64                  `json:"timestamp,omitempty"`
	Level        uint                   `json:"level,omitempty"`
	Extra        map[string]interface{} `json:"-,"`
}

type Transport

type Transport string

const (
	UDP Transport = "udp"
	TCP Transport = "tcp"
)