Version: v0.1.29 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Nov 10, 2021 License: CC0-1.0, CC0-1.0, CC0-1.0 Imports: 22 Imported by: 4




View Source
const (
	DefaultTCPPort = 12354
	DefaultWSPort  = 80

The default ports that logd listens on.


View Source
var ErrNilConfiguration = errors.New("illegal nil configuration data")

ErrNilConfiguration indicates a failure to validate.


This section is empty.


type Client

type Client struct {
	// contains filtered or unexported fields

Client is the client-view of the server.

func NewClient

func NewClient(ctx context.Context, cfg *ClientConfig) (*Client, error)

NewClient returns a new client-view of the server specified by the configuration cfg.

func (*Client) LogMessage

func (c *Client) LogMessage(ctx context.Context, m logger.Message) error

LogMessage submits the given log message.

type ClientConfig

type ClientConfig struct {
	Address *address.Address // The address to connect to
	SSLCert []byte           // The SSL certificate (if any)

ClientConfig describes the configuration options we allow a user to set on a client connection.

func DefaultConfig

func DefaultConfig() *ClientConfig

DefaultConfig returns a new client configuration initialised with the default values.

The initial default value for the host and port will be read from the environment variable

PCAS_LOG_ADDRESS = "hostname[:port]" or "ws://host/path"

on package init.

func SetDefaultConfig

func SetDefaultConfig(c *ClientConfig) *ClientConfig

SetDefaultConfig sets the default client configuration to c and returns the old default configuration. This change will be reflected in future calls to DefaultConfig.

func (*ClientConfig) Copy

func (c *ClientConfig) Copy() *ClientConfig

Copy returns a copy of the configuration.

func (*ClientConfig) URI

func (c *ClientConfig) URI() string

URI returns the URI connection string.

Note that the returned string may differ slightly from the value returned c.Address.URI(). For example, if c.Address omits a port number, an appropriate default port number is used here.

func (*ClientConfig) Validate

func (c *ClientConfig) Validate() error

Validate validates the client configuration, returning an error if there's a problem.

type Option

type Option interface {
	// contains filtered or unexported methods

Option sets options on a server.

func MessageFunc

func MessageFunc(f logger.MessageFunc) Option

MessageFunc sets the message function to which log messages from the client will be forwarded.

func SSLCertAndKey

func SSLCertAndKey(crt []byte, key []byte) Option

SSLCertAndKey adds the given SSL public certificate and private key to the server.

type Server

type Server struct {

Server handles client communication.

func NewServer

func NewServer(options ...Option) (*Server, error)

NewServer returns a new log server.


Path Synopsis
Package logdflag provides a standard flag set for configuring the logger package and starting logging.
Package logdflag provides a standard flag set for configuring the logger package and starting logging.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL