software.amazon.awscdk.services.logs

Interface LogGroupProps

All Known Implementing Classes:

LogGroupProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.73.0 (build 6faeda3)",
           date="2023-01-25T18:29:02.511Z")
public interface LogGroupProps

Properties for a LogGroup.

Example:

 Vpc vpc;
 Key kmsKey = new Key(this, "KmsKey");
 // Pass the KMS key in the `encryptionKey` field to associate the key to the log group
 LogGroup logGroup = LogGroup.Builder.create(this, "LogGroup")
         .encryptionKey(kmsKey)
         .build();
 // Pass the KMS key in the `encryptionKey` field to associate the key to the S3 bucket
 Bucket execBucket = Bucket.Builder.create(this, "EcsExecBucket")
         .encryptionKey(kmsKey)
         .build();
 Cluster cluster = Cluster.Builder.create(this, "Cluster")
         .vpc(vpc)
         .executeCommandConfiguration(ExecuteCommandConfiguration.builder()
                 .kmsKey(kmsKey)
                 .logConfiguration(ExecuteCommandLogConfiguration.builder()
                         .cloudWatchLogGroup(logGroup)
                         .cloudWatchEncryptionEnabled(true)
                         .s3Bucket(execBucket)
                         .s3EncryptionEnabled(true)
                         .s3KeyPrefix("exec-command-output")
                         .build())
                 .logging(ExecuteCommandLogging.OVERRIDE)
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	LogGroupProps.Builder A builder for LogGroupProps
static class	LogGroupProps.Jsii$Proxy An implementation for LogGroupProps

Method Summary

Modifier and Type	Method and Description
static LogGroupProps.Builder	builder()
default IKey	getEncryptionKey() The KMS Key to encrypt the log group with.
default java.lang.String	getLogGroupName() Name of the log group.
default RemovalPolicy	getRemovalPolicy() Determine the removal policy of this log group.
default RetentionDays	getRetention() How long, in days, the log contents will be retained.

Method Detail

getEncryptionKey

default IKey getEncryptionKey()

The KMS Key to encrypt the log group with.

Default: - log group is encrypted with the default master key

getLogGroupName

default java.lang.String getLogGroupName()

Name of the log group.

Default: Automatically generated

getRemovalPolicy

default RemovalPolicy getRemovalPolicy()

Determine the removal policy of this log group.

Normally you want to retain the log group so you can diagnose issues from logs even after a deployment that no longer includes the log group. In that case, use the normal date-based retention policy to age out your logs.

Default: RemovalPolicy.Retain

getRetention

default RetentionDays getRetention()

How long, in days, the log contents will be retained.

To retain all logs, set this value to RetentionDays.INFINITE.

Default: RetentionDays.TWO_YEARS

builder

static LogGroupProps.Builder builder()

Returns:

a LogGroupProps.Builder of LogGroupProps