parsers

README

Parsers

Go log format parsers, generated by Ldetool producing performant & memory efficient parsers.

Formats

Currently it supports the following formats:

• AWS Lambda
• Syslog (rfc5424)
• Heroku platform messages

---

Sponsors

Sponsored by my GitHub sponsors:

Documentation

Index

• type AWSLambdaEnd
  • func (p *AWSLambdaEnd) Extract(line string) (bool, error)
• type AWSLambdaReport
  • func (p *AWSLambdaReport) Extract(line string) (bool, error)
• type AWSLambdaReportInit
  • func (p *AWSLambdaReportInit) Extract(line string) (bool, error)
• type AWSLambdaStart
  • func (p *AWSLambdaStart) Extract(line string) (bool, error)
• type AWSLambdaTimeout
  • func (p *AWSLambdaTimeout) Extract(line string) (bool, error)
• type Event
  • func Parse(line string) (Event, bool)
  • func ParseHeroku(line string) (Event, bool)
  • func ParseLambda(line string) (Event, bool)
• type HerokuBuild
  • func (p *HerokuBuild) Extract(line string) (bool, error)
• type HerokuConfigRemove
  • func (p *HerokuConfigRemove) Extract(line string) (bool, error)
• type HerokuConfigSet
  • func (p *HerokuConfigSet) Extract(line string) (bool, error)
• type HerokuDeploy
  • func (p *HerokuDeploy) Extract(line string) (bool, error)
• type HerokuProcessExit
  • func (p *HerokuProcessExit) Extract(line string) (bool, error)
• type HerokuProcessListening
  • func (p *HerokuProcessListening) Extract(line string) (bool, error)
• type HerokuProcessStart
  • func (p *HerokuProcessStart) Extract(line string) (bool, error)
• type HerokuRelease
  • func (p *HerokuRelease) Extract(line string) (bool, error)
• type HerokuRollback
  • func (p *HerokuRollback) Extract(line string) (bool, error)
• type HerokuScale
  • func (p *HerokuScale) Extract(line string) (bool, error)
• type HerokuStateChange
  • func (p *HerokuStateChange) Extract(line string) (bool, error)
• type Syslog
  • func (p *Syslog) Extract(line string) (bool, error)

Types

type AWSLambdaEnd

type AWSLambdaEnd struct {
	Rest      string
	RequestID string
}

AWSLambdaEnd event.

func (*AWSLambdaEnd) Extract

func (p *AWSLambdaEnd) Extract(line string) (bool, error)

Extract ...

type AWSLambdaReport

type AWSLambdaReport struct {
	Rest           string
	RequestID      string
	Duration       float64
	BilledDuration float64
	MemorySize     int
	MaxMemoryUsed  int
}

AWSLambdaReport event.

func (*AWSLambdaReport) Extract

func (p *AWSLambdaReport) Extract(line string) (bool, error)

Extract ...

type AWSLambdaReportInit

type AWSLambdaReportInit struct {
	Rest           string
	RequestID      string
	Duration       float64
	BilledDuration float64
	MemorySize     int
	MaxMemoryUsed  int
	InitDuration   float64
}

AWSLambdaReportInit event.

func (*AWSLambdaReportInit) Extract

func (p *AWSLambdaReportInit) Extract(line string) (bool, error)

Extract ...

type AWSLambdaStart

type AWSLambdaStart struct {
	Rest      string
	RequestID string
	Version   string
}

AWSLambdaStart event.

func (*AWSLambdaStart) Extract

func (p *AWSLambdaStart) Extract(line string) (bool, error)

Extract ...

type AWSLambdaTimeout

type AWSLambdaTimeout struct {
	Rest      string
	Timestamp string
	RequestID string
	Duration  float64
}

AWSLambdaTimeout event.

func (*AWSLambdaTimeout) Extract

func (p *AWSLambdaTimeout) Extract(line string) (bool, error)

Extract ...

type Event

type Event interface {
	Extract(line string) (bool, error)
}

Event is the interface used to extract an event from a log line.

func Parse

func Parse(line string) (Event, bool)

Parse a log line from any source. Typically it's best to use a targeted parser such as ParseLambda() or ParseHeroku(). Returns true if an event was successfully parsed.

func ParseHeroku

func ParseHeroku(line string) (Event, bool)

ParseHeroku parses a log line from Heroku. You should first parse the syslog line from Heroku using Syslog, and then ParseHeroku() for the platform specific message. Returns true if an event was successfully parsed.

func ParseLambda

func ParseLambda(line string) (Event, bool)

ParseLambda parses a log line from AWS Lambda. Returns true if an event was successfully parsed.

type HerokuBuild

type HerokuBuild struct {
	Rest string
	User string
}

HerokuBuild event.

func (*HerokuBuild) Extract

func (p *HerokuBuild) Extract(line string) (bool, error)

Extract ...

type HerokuConfigRemove

type HerokuConfigRemove struct {
	Rest      string
	Variables string
	User      string
}

HerokuConfigRemove event.

func (*HerokuConfigRemove) Extract

func (p *HerokuConfigRemove) Extract(line string) (bool, error)

Extract ...

type HerokuConfigSet

type HerokuConfigSet struct {
	Rest      string
	Variables string
	User      string
}

HerokuConfigSet event.

func (*HerokuConfigSet) Extract

func (p *HerokuConfigSet) Extract(line string) (bool, error)

Extract ...

type HerokuDeploy

type HerokuDeploy struct {
	Rest   string
	Commit string
	User   string
}

HerokuDeploy event.

func (*HerokuDeploy) Extract

func (p *HerokuDeploy) Extract(line string) (bool, error)

Extract ...

type HerokuProcessExit

type HerokuProcessExit struct {
	Rest   string
	Status int
}

HerokuProcessExit event.

func (*HerokuProcessExit) Extract

func (p *HerokuProcessExit) Extract(line string) (bool, error)

Extract ...

type HerokuProcessListening

type HerokuProcessListening struct {
	Rest string
	Port int
}

HerokuProcessListening event.

func (*HerokuProcessListening) Extract

func (p *HerokuProcessListening) Extract(line string) (bool, error)

Extract ...

type HerokuProcessStart

type HerokuProcessStart struct {
	Rest    string
	Command string
}

HerokuProcessStart event.

func (*HerokuProcessStart) Extract

func (p *HerokuProcessStart) Extract(line string) (bool, error)

Extract ...

type HerokuRelease

type HerokuRelease struct {
	Rest    string
	Version string
	User    string
}

HerokuRelease event.

func (*HerokuRelease) Extract

func (p *HerokuRelease) Extract(line string) (bool, error)

Extract ...

type HerokuRollback

type HerokuRollback struct {
	Rest    string
	Version string
	User    string
}

HerokuRollback event.

func (*HerokuRollback) Extract

func (p *HerokuRollback) Extract(line string) (bool, error)

Extract ...

type HerokuScale

type HerokuScale struct {
	Rest  string
	Dynos string
	User  string
}

HerokuScale event.

func (*HerokuScale) Extract

func (p *HerokuScale) Extract(line string) (bool, error)

Extract ...

type HerokuStateChange

type HerokuStateChange struct {
	Rest string
	From string
	To   string
}

HerokuStateChange event.

func (*HerokuStateChange) Extract

func (p *HerokuStateChange) Extract(line string) (bool, error)

Extract ...

type Syslog

type Syslog struct {
	Rest          string
	Priority      int
	SyslogVersion int
	Timestamp     string
	Hostname      string
	Appname       string
	ProcID        string
	MsgID         string
	Message       string
}

Syslog event.

func (*Syslog) Extract

func (p *Syslog) Extract(line string) (bool, error)

Extract ...