logs

Documentation

Overview

Package logs provides a simple API for sending app logs from STDOUT and STDERR through the dropsonde system.

Use

See the documentation for package dropsonde for configuration details.

Importing package dropsonde and initializing will initial this package. To send logs use

logs.SendAppLog(appID, message, sourceType, sourceInstance)

for sending errors,

logs.SendAppErrorLog(appID, message, sourceType, sourceInstance)

Index

• func Initialize(ls LogSender)
• func LogMessage(msg []byte, msgType events.LogMessage_MessageType) log_sender.LogChainer
• func ScanErrorLogStream(appID, sourceType, sourceInstance string, reader io.Reader)
• func ScanLogStream(appID, sourceType, sourceInstance string, reader io.Reader)
• func SendAppErrorLog(appID, message, sourceType, sourceInstance string) error
• func SendAppLog(appID, message, sourceType, sourceInstance string) error
• type LogSender

Functions

func Initialize

func Initialize(ls LogSender)

Initialize prepares the logs package for use with the automatic Emitter from dropsonde.

func LogMessage

func LogMessage(msg []byte, msgType events.LogMessage_MessageType) log_sender.LogChainer

LogMessage creates a log message that can be manipulated via cascading calls and then sent.

func ScanErrorLogStream

func ScanErrorLogStream(appID, sourceType, sourceInstance string, reader io.Reader)

ScanErrorLogStream sends a log error message with the given meta-data for each line from reader. Restarts on read errors and continues until EOF.

func ScanLogStream

func ScanLogStream(appID, sourceType, sourceInstance string, reader io.Reader)

ScanLogStream sends a log message with the given meta-data for each line from reader. Restarts on read errors and continues until EOF.

func SendAppErrorLog

func SendAppErrorLog(appID, message, sourceType, sourceInstance string) error

SendAppErrorLog sends a log error message with the given appid, log message, source type and source instance, with a message type of std err. Returns an error if one occurs while sending the event.

func SendAppLog

func SendAppLog(appID, message, sourceType, sourceInstance string) error

SendAppLog sends a log message with the given appid, log message, source type and source instance, with a message type of std out. Returns an error if one occurs while sending the event.

Types

type LogSender

type LogSender interface {
	SendAppLog(appID, message, sourceType, sourceInstance string) error
	SendAppErrorLog(appID, message, sourceType, sourceInstance string) error
	ScanLogStream(appID, sourceType, sourceInstance string, reader io.Reader)
	ScanErrorLogStream(appID, sourceType, sourceInstance string, reader io.Reader)
	LogMessage(msg []byte, msgType events.LogMessage_MessageType) log_sender.LogChainer
}