SubscriptionFilter

Source: src/AWS/Logs/SubscriptionFilter.ts

A CloudWatch Logs subscription filter — fans matching log events out of a log group to a Lambda function, Kinesis stream, Firehose delivery stream, or cross-account logs destination. A log group supports at most two subscription filters.

For the Lambda-consumer DX (subscribe a Lambda to a log group with automatic permission wiring and payload decoding), prefer consumeLogEvents.

Subscribing a Lambda Function

const filter = yield* SubscriptionFilter("ErrorFanout", {
  logGroupName: logGroup.logGroupName,
  filterPattern: "?ERROR ?Error",
  destinationArn: fn.functionArn,
});

Subscribing a Kinesis Stream

const filter = yield* SubscriptionFilter("StreamFanout", {
  logGroupName: logGroup.logGroupName,
  filterPattern: "",
  destinationArn: stream.streamArn,
  roleArn: role.roleArn,
  distribution: "ByLogStream",
});