Skip to content
v2.278.0

Distribution Enum ​

The method used to distribute log data to the destination.

Example ​

ts
import * as destinations from 'aws-cdk-lib/aws-logs-destinations';
import * as kinesis from 'aws-cdk-lib/aws-kinesis';

declare const stream: kinesis.Stream;
declare const logGroup: logs.LogGroup;

new logs.SubscriptionFilter(this, 'Subscription', {
  logGroup,
  destination: new destinations.KinesisDestination(stream),
  filterPattern: logs.FilterPattern.allTerms("ERROR", "MainThread"),
  filterName: 'ErrorInMainThread',
  distribution: logs.Distribution.RANDOM,
});
python
import aws_cdk.aws_logs_destinations as destinations
import aws_cdk.aws_kinesis as kinesis

# stream: kinesis.Stream
# log_group: logs.LogGroup


logs.SubscriptionFilter(self, "Subscription",
    log_group=log_group,
    destination=destinations.KinesisDestination(stream),
    filter_pattern=logs.FilterPattern.all_terms("ERROR", "MainThread"),
    filter_name="ErrorInMainThread",
    distribution=logs.Distribution.RANDOM
)
java
import software.amazon.awscdk.services.logs.destinations.*;
import software.amazon.awscdk.services.kinesis.*;

Stream stream;
LogGroup logGroup;


SubscriptionFilter.Builder.create(this, "Subscription")
        .logGroup(logGroup)
        .destination(new KinesisDestination(stream))
        .filterPattern(FilterPattern.allTerms("ERROR", "MainThread"))
        .filterName("ErrorInMainThread")
        .distribution(Distribution.RANDOM)
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
using Amazon.CDK.AWS.Logs.Destinations;
using Amazon.CDK.AWS.Kinesis;

Stream stream;
LogGroup logGroup;


new SubscriptionFilter(this, "Subscription", new SubscriptionFilterProps {
    LogGroup = logGroup,
    Destination = new KinesisDestination(stream),
    FilterPattern = FilterPattern.AllTerms("ERROR", "MainThread"),
    FilterName = "ErrorInMainThread",
    Distribution = Distribution.RANDOM
});
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
import destinations "github.com/aws/aws-cdk-go/awscdk"
import kinesis "github.com/aws/aws-cdk-go/awscdk"

var stream Stream
var logGroup LogGroup


logs.NewSubscriptionFilter(this, jsii.String("Subscription"), &SubscriptionFilterProps{
	LogGroup: LogGroup,
	Destination: destinations.NewKinesisDestination(stream),
	FilterPattern: logs.FilterPattern_AllTerms(jsii.String("ERROR"), jsii.String("MainThread")),
	FilterName: jsii.String("ErrorInMainThread"),
	Distribution: logs.Distribution_RANDOM,
})

Members ​

MemberDescription
BY_LOG_STREAMLog events from the same log stream are kept together and sent to the same destination.
RANDOMLog events are distributed across the log destinations randomly.

Referenced by ​