le_go

README

le_go

Golang client library for logentries.com

It is compatible with http://golang.org/pkg/log/#Logger and also implements http://golang.org/pkg/io/#Writer

Usage

Add a new manual TCP token log at logentries.com and copy the token.

Installation: go get github.com/bsphere/le_go

Note: The Logger is blocking, it can be easily run in a goroutine by calling go le.Println(...)

package main

import "github.com/bsphere/le_go"

func main() {
	le, err := le_go.Connect("XXXX-XXXX-XXXX-XXXX") // replace with token
	if err != nil {
		panic(err)
	}

	defer le.Close()

	le.Println("another test message")
}

Documentation

Overview

Package le_go provides a Golang client library for logging to logentries.com over a TCP connection.

it uses an access token for sending log events.

Index

• type Logger
  • func Connect(token string) (*Logger, error)
  • func (logger *Logger) Close() error
  • func (logger *Logger) Fatal(v ...interface{})
  • func (logger *Logger) Fatalf(format string, v ...interface{})
  • func (logger *Logger) Fatalln(v ...interface{})
  • func (logger *Logger) Flags() int
  • func (logger *Logger) Output(calldepth int, s string) error
  • func (logger *Logger) Panic(v ...interface{})
  • func (logger *Logger) Panicf(format string, v ...interface{})
  • func (logger *Logger) Panicln(v ...interface{})
  • func (logger *Logger) Prefix() string
  • func (logger *Logger) Print(v ...interface{}) error
  • func (logger *Logger) Printf(format string, v ...interface{}) error
  • func (logger *Logger) Println(v ...interface{}) error
  • func (logger *Logger) SetFlags(flag int)
  • func (logger *Logger) SetPrefix(prefix string)
  • func (logger *Logger) Write(p []byte) (n int, err error)

Examples

• Logger
• Logger (Write)

Types

type Logger

type Logger struct {
	// contains filtered or unexported fields
}

Logger represents a Logentries logger, it holds the open TCP connection, access token, prefix and flags.

all Logger operations are thread safe and blocking, log operations can be invoked in a non-blocking way by calling them from a goroutine.

Example

le, err := Connect("XXXX-XXXX-XXXX-XXXX") // replace with token
if err != nil {
	panic(err)
}

defer le.Close()

le.Println("another test message")

Example (Write)

le, err := Connect("XXXX-XXXX-XXXX-XXXX") // replace with token
if err != nil {
	panic(err)
}

defer le.Close()

fmt.Fprintln(le, "another test message")

func Connect

func Connect(token string) (*Logger, error)

Connect creates a new Logger instance and opens a TCP connection to logentries.com, The token can be generated at logentries.com by adding a new log, choosing manual configuration and token based TCP connection.

func (*Logger) Close

func (logger *Logger) Close() error

Close closes the TCP connection to logentries.com

func (*Logger) Fatal

func (logger *Logger) Fatal(v ...interface{})

Fatal is same as Print() but calls to os.Exit(1)

func (*Logger) Fatalf

func (logger *Logger) Fatalf(format string, v ...interface{})

Fatalf is same as Printf() but calls to os.Exit(1)

func (*Logger) Fatalln

func (logger *Logger) Fatalln(v ...interface{})

Fatalln is same as Println() but calls to os.Exit(1)

func (*Logger) Flags

func (logger *Logger) Flags() int

Flags returns the logger flags

func (*Logger) Output

func (logger *Logger) Output(calldepth int, s string) error

Output does the actual writing to the TCP connection

func (*Logger) Panic

func (logger *Logger) Panic(v ...interface{})

Panic is same as Print() but calls to panic

func (*Logger) Panicf

func (logger *Logger) Panicf(format string, v ...interface{})

Panicf is same as Printf() but calls to panic

func (*Logger) Panicln

func (logger *Logger) Panicln(v ...interface{})

Panicln is same as Println() but calls to panic

func (*Logger) Prefix

func (logger *Logger) Prefix() string

Prefix returns the logger prefix

func (*Logger) Print

func (logger *Logger) Print(v ...interface{}) error

Print logs a message

func (*Logger) Printf

func (logger *Logger) Printf(format string, v ...interface{}) error

Printf logs a formatted message

func (*Logger) Println

func (logger *Logger) Println(v ...interface{}) error

Println logs a message with a linebreak

func (*Logger) SetFlags

func (logger *Logger) SetFlags(flag int)

SetFlags sets the logger flags

func (*Logger) SetPrefix

func (logger *Logger) SetPrefix(prefix string)

SetPrefix sets the logger prefix

func (*Logger) Write

func (logger *Logger) Write(p []byte) (n int, err error)

Write writes a bytes array to the Logentries TCP connection, it adds the access token and prefix and also replaces line breaks with the unicode \u2028 character