RFC3164 - Documentation

Constructor

new RFC3164(optionsopt)

Source:

index.js, line 472

Version:

0.0.0

Since:

0.0.0

Construct a new RFC3164 formatted Syslog object with user options

Parameters:

Name Type Attributes Description

options

object

Options object

Properties

Name Type Attributes Default Description

applicationName string <optional> 'NodeJSLogger' Application

hostname string <optional> os.hostname The name of this server

facility number <optional> 23 Facility code to use sending this message

color boolean <optional> false Apply color coding encoding tag with syslog message text

extendedColor boolean <optional> false Use the extended ANSI color set encoding tag with syslog message text

colors

object

User defended colors for severities

Properties

Name	Type	Attributes	Description
`emergencyColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`alertColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`criticalColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`errorColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`warningColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`noticeColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`informationalColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`debugColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)

server Syslog <optional> false A Syslog server connection that should be used to send messages directly from this class. @see SyslogPro~Syslog

Requires:

module:moment

Requires

module:moment

Members

(private) alertColor

Source:

index.js, line 547

color :boolean

Source:

index.js, line 525

Type:

boolean

(private) constructor__

Source:

index.js, line 518

(private) criticalColor

Source:

index.js, line 549

(private) debugColor

Source:

index.js, line 559

(private) emergencyColor

Source:

index.js, line 545

(private) errorColor

Source:

index.js, line 551

extendedColor :boolean

Source:

index.js, line 531

Type:

boolean

(private) informationalColor

Source:

index.js, line 557

(private) noticeColor

Source:

index.js, line 555

(private) server

Source:

index.js, line 538

(private) warningColor

Source:

index.js, line 553

Methods

alert(msg) → {Promise}

Source:

index.js, line 869

Send a syslog message with a severity level of 1 (Alert)

Parameters:

Name	Type	Description
`msg`	string	The alert message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

buildMessage(msg, optionsopt) → {Promise}

Source:

index.js, line 754

Building a formatted message. Returns a promise with a formatted message

Parameters:

Name Type Attributes Description

msg string The Syslog Message

options

object

Options object

Properties

Name	Type	Attributes	Default	Description
`severity`	number	<optional>	`7`	An array of structure
`colorCode`	number	<optional>	`36`	The ANSI color code to use if message coloration is selected

Throws:

A standard error object
Type Error

Returns:

A Syslog formatted string according to the selected RFC

Type: Promise

crit(msg) → {Promise}

Source:

index.js, line 895

Send a syslog message with a severity level of 2 (Critical)

Parameters:

Name	Type	Description
`msg`	string	The critical message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

critical(msg) → {Promise}

Source:

index.js, line 882

Send a syslog message with a severity level of 2 (Critical)

Parameters:

Name	Type	Description
`msg`	string	The critical message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

debug(msg) → {Promise}

Source:

index.js, line 1010

Send a syslog message with a severity level of 7 (Debug)

Parameters:

Name	Type	Description
`msg`	string	The debug message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

emer(msg) → {Promise}

Source:

index.js, line 859

Send a syslog message with a security level of 0 (Emergency)

Parameters:

Name	Type	Description
`msg`	string	The emergency message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

emergency(msg) → {Promise}

Source:

index.js, line 846

Send a syslog message with a security level of 0 (Emergency)

Parameters:

Name	Type	Description
`msg`	string	The emergency message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

err(msg) → {Promise}

Source:

index.js, line 918

Send a syslog message with a severity level of 3 (Error)

Parameters:

Name	Type	Description
`msg`	string	The error message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

error(msg) → {Promise}

Source:

index.js, line 905

Send a syslog message with a severity level of 3 (Error)

Parameters:

Name	Type	Description
`msg`	string	The error message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

info(msg) → {Promise}

Source:

index.js, line 989

Send a syslog message with a severity level of 6 (Informational)

Parameters:

Name	Type	Description
`msg`	string	The informational message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

informational(msg) → {Promise}

Source:

index.js, line 975

Send a syslog message with a severity level of 6 (Informational)

Parameters:

Name	Type	Description
`msg`	string	The informational message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

log(msg) → {Promise}

Source:

index.js, line 1000

Send a syslog message with a severity level of 6 (Informational)

Parameters:

Name	Type	Description
`msg`	string	The informational message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

note(msg) → {Promise}

Source:

index.js, line 964

Send a syslog message with a severity level of 5 (Notice)

Parameters:

Name	Type	Description
`msg`	string	The notice message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

notice(msg) → {Promise}

Source:

index.js, line 951

Send a syslog message with a severity level of 5 (Notice)

Parameters:

Name	Type	Description
`msg`	string	The notice message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

send(msg, optionsopt) → {Promise}

Source:

index.js, line 819

See:

SyslogPro~Syslog

send a RFC5424 formatted message. Returns a promise with the formatted message that was sent. If no server connection was defined when the class was created a default Syslog connector will be used.

Parameters:

Name Type Attributes Description

msg string The unformatted Syslog message to send

options

object

Options object

Properties

Name	Type	Attributes	Default	Description
`severity`	number	<optional>	`7`	An array of structure
`colorCode`	number	<optional>	`36`	The ANSI color code to use if

Throws:

A standard error object
Type Error

Returns:

A Syslog formatted string according to the selected RFC

Type: Promise

setColor()

Source:

index.js, line 603

Sets the color to be used for messages at a set priority

Parameters:

Name	Type	Attributes	Description
`colors.emergencyColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`colors.alertColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`colors.criticalColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`colors.errorColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`colors.warningColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`colors.noticeColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`colors.informationalColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)
`colors.debugColor`	string	<optional>	A RGB Hex coded color in the form of #FFFFFF or as or the ANSI color code number (30-37 Standard & 0-255 Extended)

Throws:

A standard error object
Type Error

warn(msg) → {Promise}

Source:

index.js, line 941

Send a syslog message with a severity level of 4 (Warning)

Parameters:

Name	Type	Description
`msg`	string	The warning message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise

warning(msg) → {Promise}

Source:

index.js, line 928

Send a syslog message with a severity level of 4 (Warning)

Parameters:

Name	Type	Description
`msg`	string	The warning message to send to the Syslog server

Throws:

- Any bubbled-up error
Type Error

Returns:

- The formatted syslog message sent to the Syslog server

Type: Promise