CloudWatchLogger

@webda/aws • Readme | API

---

Class: CloudWatchLogger<T>

Output log to a CloudWatch Stream

Webda Modda

Extends

• Service<T>

Type parameters

• T extends CloudWatchLoggerParameters = CloudWatchLoggerParameters

Implements

• CloudFormationContributor

Constructors

new CloudWatchLogger(webda, name, params)

new CloudWatchLogger<T>(webda, name, params?): CloudWatchLogger<T>

Service

Parameters

• webda: Core<CoreEvents>

The main instance of Webda

• name: string

The name of the service

• params?: DeepPartial<T>

The parameters block define in the configuration file

Returns

CloudWatchLogger<T>

Inherited from

Service<T>.constructor

Source

core/lib/services/service.d.ts:167

Properties

_bufferedLogs

_bufferedLogs: any[] = []

Source

aws/src/services/cloudwatchlogger.ts:39

---

_cloudwatch

_cloudwatch: any

Source

aws/src/services/cloudwatchlogger.ts:38

---

_createException

_createException: string

Inherited from

Service._createException

Source

core/lib/services/service.d.ts:148

---

_initException

_initException: any

Inherited from

Service._initException

Source

core/lib/services/service.d.ts:150

---

_initTime

_initTime: number

Inherited from

Service._initTime

Source

core/lib/services/service.d.ts:149

---

_logGroupName

_logGroupName: string

Source

aws/src/services/cloudwatchlogger.ts:34

---

_logStream

_logStream: any

Source

aws/src/services/cloudwatchlogger.ts:37

---

_logStreamName

_logStreamName: string

Source

aws/src/services/cloudwatchlogger.ts:35

---

_name

protected _name: string

Service name

Inherited from

Service._name

Source

core/lib/services/service.d.ts:141

---

_seqToken

_seqToken: string

Source

aws/src/services/cloudwatchlogger.ts:36

---

_webda

protected _webda: Core<CoreEvents>

Webda Core object

Inherited from

Service._webda

Source

core/lib/services/service.d.ts:137

---

logger

protected logger: Logger

Logger with class context

Inherited from

Service.logger

Source

core/lib/services/service.d.ts:154

---

metrics?

protected metrics?: any

Get metrics

Inherited from

Service.metrics

Source

core/lib/services/service.d.ts:158

---

parameters

protected parameters: T

Hold the parameters for your service

It will be bring from the webda.config.json

Inherited from

Service.parameters

Source

core/lib/services/service.d.ts:147

---

captureRejectionSymbol

static readonly captureRejectionSymbol: typeof captureRejectionSymbol

Inherited from

Service.captureRejectionSymbol

Source

aws/node_modules/@types/node/events.d.ts:38

---

captureRejections

static captureRejections: boolean

Sets or gets the default captureRejection value for all emitters.

Inherited from

Service.captureRejections

Source

aws/node_modules/@types/node/events.d.ts:44

---

defaultMaxListeners

static defaultMaxListeners: number

Inherited from

Service.defaultMaxListeners

Source

aws/node_modules/@types/node/events.d.ts:45

---

errorMonitor

static readonly errorMonitor: typeof errorMonitor

This symbol shall be used to install a listener for only monitoring 'error' events. Listeners installed using this symbol are called before the regular 'error' listeners are called.

Installing a listener using this symbol does not change the behavior once an 'error' event is emitted, therefore the process will still crash if no regular 'error' listener is installed.

Inherited from

Service.errorMonitor

Source

aws/node_modules/@types/node/events.d.ts:37

Methods

__clean()

__clean(): Promise<void>

Clean the service data, can only be used in test mode

Returns

Promise<void>

Inherited from

Service.__clean

Abstract

Source

core/lib/services/service.d.ts:318

---

_log()

_log(level, ...args): void

Parameters

• level: any

• ...args: any[]

Returns

void

Inherit Doc

Source

aws/src/services/cloudwatchlogger.ts:120

---

addListener()

addListener(event, listener): this

Parameters

• event: string | symbol

• listener: (...args) => void

Returns

this

Inherited from

Service.addListener

Source

aws/node_modules/@types/node/events.d.ts:57

---

addRoute()

protected addRoute(url, methods, executer, openapi?, override?): void

Add a route dynamicaly

Parameters

• url: string

of the route can contains dynamic part like {uuid}

• methods: HttpMethodType[]

• executer: Function

Method to execute for this route

• openapi?: OpenAPIWebdaDefinition

• override?: boolean

Returns

void

Inherited from

Service.addRoute

Source

core/lib/services/service.d.ts:241

---

authorizeClientEvent()

authorizeClientEvent(_event, _context): boolean

Authorize a public event subscription

Parameters

• _event: string

• _context: OperationContext<any, any>

Returns

boolean

Inherited from

Service.authorizeClientEvent

Source

core/lib/services/service.d.ts:219

---

computeParameters()

computeParameters(): void

Used to compute or derivate input parameter to attribute

Returns

void

Inherited from

Service.computeParameters

Source

core/lib/services/service.d.ts:175

---

emit()

emit<Key>(event, data): boolean

Override to allow capturing long listeners

Type parameters

• Key extends string | number

Parameters

• event: symbol | Key

• data: Events[Key]

Returns

boolean

Inherited from

Service.emit

Source

core/lib/services/service.d.ts:288

---

emitSync()

emitSync<Key>(event, data): Promise<any[]>

Emit the event with data and wait for Promise to finish if listener returned a Promise

Type parameters

• Key extends string | number

Parameters

• event: Key

• data: Events[Key]

Returns

Promise<any[]>

Inherited from

Service.emitSync

Source

core/lib/services/service.d.ts:283

---

eventNames()

eventNames(): (string | symbol)[]

Returns

(string | symbol)[]

Inherited from

Service.eventNames

Source

aws/node_modules/@types/node/events.d.ts:72

---

getARNPolicy()

getARNPolicy(accountId): Object

Parameters

• accountId: string

Returns

Object

Action

Action: string[]

Effect

Effect: string = "Allow"

Resource

Resource: string[]

Sid

Sid: string

Inherit Doc

Source

aws/src/services/cloudwatchlogger.ts:133

---

getClientEvents()

getClientEvents(): string[]

Return the events that an external system can subscribe to

Returns

string[]

Inherited from

Service.getClientEvents

Source

core/lib/services/service.d.ts:213

---

getCloudFormation()

getCloudFormation(): Object

Returns

Object

Implementation of

CloudFormationContributor.getCloudFormation

Inherit Doc

Source

aws/src/services/cloudwatchlogger.ts:149

---

getMaxListeners()

getMaxListeners(): number

Returns

number

Inherited from

Service.getMaxListeners

Source

aws/node_modules/@types/node/events.d.ts:64

---

getMetric()

getMetric<T>(type, configuration): T

Add service name label

Type parameters

• T = Counter<string> | Histogram<string> | Gauge<string>

Parameters

• type: Constructor<T, [MetricConfiguration<T>]>

• configuration: MetricConfiguration<T>

Returns

T

Inherited from

Service.getMetric

Source

core/lib/services/service.d.ts:207

---

getName()

getName(): string

Get service name

Returns

string

Inherited from

Service.getName

Source

core/lib/services/service.d.ts:312

---

getOpenApiReplacements()

getOpenApiReplacements(): any

Return variables for replacement in openapi

Returns

any

Inherited from

Service.getOpenApiReplacements

Source

core/lib/services/service.d.ts:246

---

getOperationId()

getOperationId(id): string

If undefined is returned it cancel the operation registration

Parameters

• id: string

Returns

string

Inherited from

Service.getOperationId

Source

core/lib/services/service.d.ts:233

---

getParameters()

getParameters(): T

Get the service parameters

Returns

T

Inherited from

Service.getParameters

Source

core/lib/services/service.d.ts:179

---

getService()

getService<K>(service): K

Return a webda service

Type parameters

• K extends Service<ServiceParameters, Events>

Parameters

• service: string

name to retrieve

Returns

K

Inherited from

Service.getService

Source

core/lib/services/service.d.ts:308

---

getUrl()

getUrl(url, _methods): string

Return the full path url based on parameters

Parameters

• url: string

relative url to service

• _methods: HttpMethodType[]

in case we need filtering (like Store)

Returns

string

absolute url or undefined if need to skip the Route

Inherited from

Service.getUrl

Source

core/lib/services/service.d.ts:227

---

getWebda()

getWebda(): Core<CoreEvents>

Return WebdaCore

Returns

Core<CoreEvents>

Inherited from

Service.getWebda

Source

core/lib/services/service.d.ts:183

---

init()

init(): Promise<CloudWatchLogger<T>>

Returns

Promise<CloudWatchLogger<T>>

Overrides

Service.init

Inherit Doc

Source

aws/src/services/cloudwatchlogger.ts:53

---

initMetrics()

initMetrics(): void

Init the metrics

Returns

void

Inherited from

Service.initMetrics

Source

core/lib/services/service.d.ts:200

---

initOperations()

initOperations(): void

Init the operations

Returns

void

Inherited from

Service.initOperations

Source

core/lib/services/service.d.ts:254

---

initRoutes()

initRoutes(): void

Init the routes

Returns

void

Inherited from

Service.initRoutes

Source

core/lib/services/service.d.ts:250

---

listenerCount()

listenerCount(event): number

Parameters

• event: string | symbol

Returns

number

Inherited from

Service.listenerCount

Source

aws/node_modules/@types/node/events.d.ts:68

---

listeners()

listeners(event): Function[]

Parameters

• event: string | symbol

Returns

Function[]

Inherited from

Service.listeners

Source

aws/node_modules/@types/node/events.d.ts:65

---

loadParameters()

loadParameters(params): CloudWatchLoggerParameters

Load the parameters

Parameters

• params: any

Returns

CloudWatchLoggerParameters

Overrides

Service.loadParameters

Source

aws/src/services/cloudwatchlogger.ts:46

---

log()

log(level, ...args): void

Parameters

• level: WorkerLogLevel

to log

• ...args: any[]

Returns

void

Inherited from

Service.log

Source

core/lib/services/service.d.ts:328

---

off()

off(event, listener): this

Parameters

• event: string | symbol

• listener: (...args) => void

Returns

this

Inherited from

Service.off

Source

aws/node_modules/@types/node/events.d.ts:61

---

on()

on<Key>(event, listener): this

Type the listener part

Type parameters

• Key extends string | number

Parameters

• event: symbol | Key

• listener: (evt) => void

Returns

this

Inherited from

Service.on

Source

core/lib/services/service.d.ts:296

---

onAsync()

onAsync<Key>(event, listener, queue?): void

Listen to an event as on(...) would do except that it will be asynchronous

Type parameters

• Key extends string | number

Parameters

• event: Key

• listener: (evt) => void

• queue?: string

Name of queue to use, can be undefined, queue name are used to define differents priorities

Returns

void

Inherited from

Service.onAsync

Source

core/lib/services/service.d.ts:303

---

once()

once(event, listener): this

Parameters

• event: string | symbol

• listener: (...args) => void

Returns

this

Inherited from

Service.once

Source

aws/node_modules/@types/node/events.d.ts:59

---

prependListener()

prependListener(event, listener): this

Parameters

• event: string | symbol

• listener: (...args) => void

Returns

this

Inherited from

Service.prependListener

Source

aws/node_modules/@types/node/events.d.ts:70

---

prependOnceListener()

prependOnceListener(event, listener): this

Parameters

• event: string | symbol

• listener: (...args) => void

Returns

this

Inherited from

Service.prependOnceListener

Source

aws/node_modules/@types/node/events.d.ts:71

---

rawListeners()

rawListeners(event): Function[]

Parameters

• event: string | symbol

Returns

Function[]

Inherited from

Service.rawListeners

Source

aws/node_modules/@types/node/events.d.ts:66

---

reinit()

reinit(config): Promise<CloudWatchLogger<T>>

Parameters

• config: DeepPartial<T>

new parameters for the service

Returns

Promise<CloudWatchLogger<T>>

Inherited from

Service.reinit

Source

core/lib/services/service.d.ts:279

---

removeAllListeners()

removeAllListeners(event?): this

Parameters

• event?: string | symbol

Returns

this

Inherited from

Service.removeAllListeners

Source

aws/node_modules/@types/node/events.d.ts:62

---

removeListener()

removeListener(event, listener): this

Parameters

• event: string | symbol

• listener: (...args) => void

Returns

this

Inherited from

Service.removeListener

Source

aws/node_modules/@types/node/events.d.ts:60

---

resolve()

resolve(): this

Resolve parameters Call initRoutes and initBeanRoutes

Returns

this

Inherited from

Service.resolve

Source

core/lib/services/service.d.ts:196

---

sendLogs()

sendLogs(copy): Promise<void>

Send logs to CloudWatch

Parameters

• copy: boolean= false

Returns

Promise<void>

Source

aws/src/services/cloudwatchlogger.ts:93

---

setMaxListeners()

setMaxListeners(n): this

Parameters

• n: number

Returns

this

Inherited from

Service.setMaxListeners

Source

aws/node_modules/@types/node/events.d.ts:63

---

stop()

stop(): Promise<void>

Shutdown the current service if action need to be taken

Returns

Promise<void>

Inherited from

Service.stop

Source

core/lib/services/service.d.ts:187

---

toJSON()

toJSON(): string

Prevent service to be serialized

Returns

string

Inherited from

Service.toJSON

Source

core/lib/services/service.d.ts:267

---

toPublicJSON()

toPublicJSON(object): string

Convert an object to JSON using the Webda json filter

Service

Parameters

• object: unknown

The object to export

Returns

string

The export of the strip object ( removed all attribute with _ )

Inherited from

Service.toPublicJSON

Source

core/lib/services/service.d.ts:262

---

toString()

toString(): string

Return service representation

Returns

string

Inherited from

Service.toString

Source

core/lib/services/service.d.ts:191

---

listenerCount()

static listenerCount(emitter, event): number

Parameters

• emitter: EventEmitter

• event: string | symbol

Returns

number

Inherited from

Service.listenerCount

Deprecated

since v4.0.0

Source

aws/node_modules/@types/node/events.d.ts:26

---

on()

static on(emitter, event): AsyncIterableIterator<any, any, any>

Parameters

• emitter: EventEmitter

• event: string

Returns

AsyncIterableIterator<any, any, any>

Inherited from

Service.on

Source

aws/node_modules/@types/node/events.d.ts:23

---

once()

once(emitter, event)

static once(emitter, event): Promise<any[]>

Parameters

• emitter: NodeEventTarget

• event: string | symbol

Returns

Promise<any[]>

Inherited from

Service.once

Source

aws/node_modules/@types/node/events.d.ts:21

once(emitter, event)

static once(emitter, event): Promise<any[]>

Parameters

• emitter: DOMEventTarget

• event: string

Returns

Promise<any[]>

Inherited from

Service.once

Source

aws/node_modules/@types/node/events.d.ts:22