@rio-cloud/cdk-v2-constructs 6.15.0 → 6.16.1

package/docs/API.md

@@ -6168,6 +6168,412 @@ public readonly runnerBaseRole: Role;
 ---
 
 
+### SesObservability <a name="SesObservability" id="@rio-cloud/cdk-v2-constructs.SesObservability"></a>
+
+RioSesObservability.
+
+This construct sets up observability for SES as defined by [ADR - SES domain reputation observability](https://confluence.collaboration-man.com/display/MAN/ADR+-+SES+domain+reputation+observability).
+
+# Warning
+This construct results in logging all sent emails including the recipient address into CloudWatch logs.
+As this is considered **PII**, this information MUST be handled accordingly.
+In particular, logs **MUST NOT** be sent to further third party services (e.g. Datadog) and the retention period for logs **MUST NOT** be extended.
+
+# Usage
+## Default Configuration Set for Identity
+
+```typescript
+const rioSesObservability = new RioSesObservability(this, 'ConfigurationSet', {})
+const identity = new EmailIdentity(this, 'EmailIdentity', {
+    identity: Identity.domain('example.com'),
+    configurationSet: rioSesObservability.configurationSet,
+});
+```
+
+## Specifically using the configuration set per request
+
+This is ideal if you want to try out the construct first one some specific emails (e.g. during initial migration).
+The configuration set name is exported as an SSM parameter `/rio/config/ses-observability/configuration-set-name`.
+Thus, you can easily make it available as environment variable in your code.
+
+```kotlin
+import com.amazonaws.services.simpleemail.model.SendEmailRequest
+
+val request = SendEmailRequest()
+                .withConfigurationSetName(SSM_CONFIGURATION_SSM_PARAMETER_VALUE)
+                ...
+```
+
+## Automated event processing
+
+If you have specific needs for which you'd like to process the SNS events directly
+(e.g. automatically creating a suppression list from bounces), you can subscribe to the SNS topic.
+To enable this the SNS topic ARN is exported via Cloudformation as `RioSesObservabilityTopicArn`.
+
+#### Initializers <a name="Initializers" id="@rio-cloud/cdk-v2-constructs.SesObservability.Initializer"></a>
+
+```typescript
+import { SesObservability } from '@rio-cloud/cdk-v2-constructs'
+
+new SesObservability(scope: Construct, id: string, props: SesObservabilityProps)
+```
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.Initializer.parameter.props">props</a></code> | <code>@rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps</code> | *No description.* |
+
+---
+
+##### `scope`<sup>Required</sup> <a name="scope" id="@rio-cloud/cdk-v2-constructs.SesObservability.Initializer.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+##### `id`<sup>Required</sup> <a name="id" id="@rio-cloud/cdk-v2-constructs.SesObservability.Initializer.parameter.id"></a>
+
+- *Type:* string
+
+---
+
+##### `props`<sup>Required</sup> <a name="props" id="@rio-cloud/cdk-v2-constructs.SesObservability.Initializer.parameter.props"></a>
+
+- *Type:* @rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps
+
+---
+
+#### Methods <a name="Methods" id="Methods"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.toString">toString</a></code> | Returns a string representation of this construct. |
+
+---
+
+##### `toString` <a name="toString" id="@rio-cloud/cdk-v2-constructs.SesObservability.toString"></a>
+
+```typescript
+public toString(): string
+```
+
+Returns a string representation of this construct.
+
+#### Static Functions <a name="Static Functions" id="Static Functions"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
+
+---
+
+##### `isConstruct` <a name="isConstruct" id="@rio-cloud/cdk-v2-constructs.SesObservability.isConstruct"></a>
+
+```typescript
+import { SesObservability } from '@rio-cloud/cdk-v2-constructs'
+
+SesObservability.isConstruct(x: any)
+```
+
+Checks if `x` is a construct.
+
+Use this method instead of `instanceof` to properly detect `Construct`
+instances, even when the construct library is symlinked.
+
+Explanation: in JavaScript, multiple copies of the `constructs` library on
+disk are seen as independent, completely different libraries. As a
+consequence, the class `Construct` in each copy of the `constructs` library
+is seen as a different class, and an instance of one class will not test as
+`instanceof` the other class. `npm install` will not create installations
+like this, but users may manually symlink construct libraries together or
+use a monorepo tool: in those cases, multiple copies of the `constructs`
+library can be accidentally installed, and `instanceof` will behave
+unpredictably. It is safest to avoid using `instanceof`, and using
+this type-testing method instead.
+
+###### `x`<sup>Required</sup> <a name="x" id="@rio-cloud/cdk-v2-constructs.SesObservability.isConstruct.parameter.x"></a>
+
+- *Type:* any
+
+Any object.
+
+---
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.property.configurationSet">configurationSet</a></code> | <code>aws-cdk-lib.aws_ses.ConfigurationSet</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.property.snsTopic">snsTopic</a></code> | <code>aws-cdk-lib.aws_sns.Topic</code> | *No description.* |
+
+---
+
+##### `node`<sup>Required</sup> <a name="node" id="@rio-cloud/cdk-v2-constructs.SesObservability.property.node"></a>
+
+```typescript
+public readonly node: Node;
+```
+
+- *Type:* constructs.Node
+
+The tree node.
+
+---
+
+##### `configurationSet`<sup>Required</sup> <a name="configurationSet" id="@rio-cloud/cdk-v2-constructs.SesObservability.property.configurationSet"></a>
+
+```typescript
+public readonly configurationSet: ConfigurationSet;
+```
+
+- *Type:* aws-cdk-lib.aws_ses.ConfigurationSet
+
+---
+
+##### `snsTopic`<sup>Required</sup> <a name="snsTopic" id="@rio-cloud/cdk-v2-constructs.SesObservability.property.snsTopic"></a>
+
+```typescript
+public readonly snsTopic: Topic;
+```
+
+- *Type:* aws-cdk-lib.aws_sns.Topic
+
+---
+
+#### Constants <a name="Constants" id="Constants"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.property.CONFIGURATION_SET_NAME_SSM_PARAMETER">CONFIGURATION_SET_NAME_SSM_PARAMETER</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservability.property.SNS_TOPIC_ARN_EXPORT_NAME">SNS_TOPIC_ARN_EXPORT_NAME</a></code> | <code>string</code> | *No description.* |
+
+---
+
+##### `CONFIGURATION_SET_NAME_SSM_PARAMETER`<sup>Required</sup> <a name="CONFIGURATION_SET_NAME_SSM_PARAMETER" id="@rio-cloud/cdk-v2-constructs.SesObservability.property.CONFIGURATION_SET_NAME_SSM_PARAMETER"></a>
+
+```typescript
+public readonly CONFIGURATION_SET_NAME_SSM_PARAMETER: string;
+```
+
+- *Type:* string
+
+---
+
+##### `SNS_TOPIC_ARN_EXPORT_NAME`<sup>Required</sup> <a name="SNS_TOPIC_ARN_EXPORT_NAME" id="@rio-cloud/cdk-v2-constructs.SesObservability.property.SNS_TOPIC_ARN_EXPORT_NAME"></a>
+
+```typescript
+public readonly SNS_TOPIC_ARN_EXPORT_NAME: string;
+```
+
+- *Type:* string
+
+---
+
+### SesObservability <a name="SesObservability" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability"></a>
+
+RioSesObservability.
+
+This construct sets up observability for SES as defined by [ADR - SES domain reputation observability](https://confluence.collaboration-man.com/display/MAN/ADR+-+SES+domain+reputation+observability).
+
+# Warning
+This construct results in logging all sent emails including the recipient address into CloudWatch logs.
+As this is considered **PII**, this information MUST be handled accordingly.
+In particular, logs **MUST NOT** be sent to further third party services (e.g. Datadog) and the retention period for logs **MUST NOT** be extended.
+
+# Usage
+## Default Configuration Set for Identity
+
+```typescript
+const rioSesObservability = new RioSesObservability(this, 'ConfigurationSet', {})
+const identity = new EmailIdentity(this, 'EmailIdentity', {
+    identity: Identity.domain('example.com'),
+    configurationSet: rioSesObservability.configurationSet,
+});
+```
+
+## Specifically using the configuration set per request
+
+This is ideal if you want to try out the construct first one some specific emails (e.g. during initial migration).
+The configuration set name is exported as an SSM parameter `/rio/config/ses-observability/configuration-set-name`.
+Thus, you can easily make it available as environment variable in your code.
+
+```kotlin
+import com.amazonaws.services.simpleemail.model.SendEmailRequest
+
+val request = SendEmailRequest()
+                .withConfigurationSetName(SSM_CONFIGURATION_SSM_PARAMETER_VALUE)
+                ...
+```
+
+## Automated event processing
+
+If you have specific needs for which you'd like to process the SNS events directly
+(e.g. automatically creating a suppression list from bounces), you can subscribe to the SNS topic.
+To enable this the SNS topic ARN is exported via Cloudformation as `RioSesObservabilityTopicArn`.
+
+#### Initializers <a name="Initializers" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.Initializer"></a>
+
+```typescript
+import { ses } from '@rio-cloud/cdk-v2-constructs'
+
+new ses.SesObservability(scope: Construct, id: string, props: SesObservabilityProps)
+```
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.Initializer.parameter.scope">scope</a></code> | <code>constructs.Construct</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.Initializer.parameter.id">id</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.Initializer.parameter.props">props</a></code> | <code>@rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps</code> | *No description.* |
+
+---
+
+##### `scope`<sup>Required</sup> <a name="scope" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.Initializer.parameter.scope"></a>
+
+- *Type:* constructs.Construct
+
+---
+
+##### `id`<sup>Required</sup> <a name="id" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.Initializer.parameter.id"></a>
+
+- *Type:* string
+
+---
+
+##### `props`<sup>Required</sup> <a name="props" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.Initializer.parameter.props"></a>
+
+- *Type:* @rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps
+
+---
+
+#### Methods <a name="Methods" id="Methods"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.toString">toString</a></code> | Returns a string representation of this construct. |
+
+---
+
+##### `toString` <a name="toString" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.toString"></a>
+
+```typescript
+public toString(): string
+```
+
+Returns a string representation of this construct.
+
+#### Static Functions <a name="Static Functions" id="Static Functions"></a>
+
+| **Name** | **Description** |
+| --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.isConstruct">isConstruct</a></code> | Checks if `x` is a construct. |
+
+---
+
+##### `isConstruct` <a name="isConstruct" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.isConstruct"></a>
+
+```typescript
+import { ses } from '@rio-cloud/cdk-v2-constructs'
+
+ses.SesObservability.isConstruct(x: any)
+```
+
+Checks if `x` is a construct.
+
+Use this method instead of `instanceof` to properly detect `Construct`
+instances, even when the construct library is symlinked.
+
+Explanation: in JavaScript, multiple copies of the `constructs` library on
+disk are seen as independent, completely different libraries. As a
+consequence, the class `Construct` in each copy of the `constructs` library
+is seen as a different class, and an instance of one class will not test as
+`instanceof` the other class. `npm install` will not create installations
+like this, but users may manually symlink construct libraries together or
+use a monorepo tool: in those cases, multiple copies of the `constructs`
+library can be accidentally installed, and `instanceof` will behave
+unpredictably. It is safest to avoid using `instanceof`, and using
+this type-testing method instead.
+
+###### `x`<sup>Required</sup> <a name="x" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.isConstruct.parameter.x"></a>
+
+- *Type:* any
+
+Any object.
+
+---
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.node">node</a></code> | <code>constructs.Node</code> | The tree node. |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.configurationSet">configurationSet</a></code> | <code>aws-cdk-lib.aws_ses.ConfigurationSet</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.snsTopic">snsTopic</a></code> | <code>aws-cdk-lib.aws_sns.Topic</code> | *No description.* |
+
+---
+
+##### `node`<sup>Required</sup> <a name="node" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.node"></a>
+
+```typescript
+public readonly node: Node;
+```
+
+- *Type:* constructs.Node
+
+The tree node.
+
+---
+
+##### `configurationSet`<sup>Required</sup> <a name="configurationSet" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.configurationSet"></a>
+
+```typescript
+public readonly configurationSet: ConfigurationSet;
+```
+
+- *Type:* aws-cdk-lib.aws_ses.ConfigurationSet
+
+---
+
+##### `snsTopic`<sup>Required</sup> <a name="snsTopic" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.snsTopic"></a>
+
+```typescript
+public readonly snsTopic: Topic;
+```
+
+- *Type:* aws-cdk-lib.aws_sns.Topic
+
+---
+
+#### Constants <a name="Constants" id="Constants"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.CONFIGURATION_SET_NAME_SSM_PARAMETER">CONFIGURATION_SET_NAME_SSM_PARAMETER</a></code> | <code>string</code> | *No description.* |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.SNS_TOPIC_ARN_EXPORT_NAME">SNS_TOPIC_ARN_EXPORT_NAME</a></code> | <code>string</code> | *No description.* |
+
+---
+
+##### `CONFIGURATION_SET_NAME_SSM_PARAMETER`<sup>Required</sup> <a name="CONFIGURATION_SET_NAME_SSM_PARAMETER" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.CONFIGURATION_SET_NAME_SSM_PARAMETER"></a>
+
+```typescript
+public readonly CONFIGURATION_SET_NAME_SSM_PARAMETER: string;
+```
+
+- *Type:* string
+
+---
+
+##### `SNS_TOPIC_ARN_EXPORT_NAME`<sup>Required</sup> <a name="SNS_TOPIC_ARN_EXPORT_NAME" id="@rio-cloud/cdk-v2-constructs.ses.SesObservability.property.SNS_TOPIC_ARN_EXPORT_NAME"></a>
+
+```typescript
+public readonly SNS_TOPIC_ARN_EXPORT_NAME: string;
+```
+
+- *Type:* string
+
+---
+
 ### SpotServiceLinkedRole <a name="SpotServiceLinkedRole" id="@rio-cloud/cdk-v2-constructs.SpotServiceLinkedRole"></a>
 
 The construct creates a service linked role required to run GitLab Runners using Spot EC2 instances.
@@ -9813,6 +10219,8 @@ const datadogIntegrationProps: DatadogIntegrationProps = { ... }
 | --- | --- | --- |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.additionalTags">additionalTags</a></code> | <code>{[ key: string ]: string}</code> | Configure additional tags, which are appended to the defaults, When you define custom tags we would be glad if you contact us. |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.apmGetEndpointsToIgnore">apmGetEndpointsToIgnore</a></code> | <code>string[]</code> | GET endpoints to ignore in Datadog's APM overview. |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.awsFireLensCpu">awsFireLensCpu</a></code> | <code>number</code> | The amount of virtual CPU units to be reserved for the firelens log-router container (i.e. aws-for-fluent-bit). |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.awsFireLensMemoryLimitMiB">awsFireLensMemoryLimitMiB</a></code> | <code>number</code> | The amount of memory (in MiB) reserved for the firelens log-router container (i.e. aws-for-fluent-bit). |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.cpu">cpu</a></code> | <code>number</code> | The minimum number of CPU units to reserve for the container. |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.datadogSidecarEssential">datadogSidecarEssential</a></code> | <code>boolean</code> | Configure if the Datadog agent sidecar is marked as essential. |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.datadogSidecarTag">datadogSidecarTag</a></code> | <code>string</code> | Configures the docker image tag for datadog sidecar. |
@@ -9865,6 +10273,38 @@ This is useful to filter out all health check calls.
 
 ---
 
+##### `awsFireLensCpu`<sup>Optional</sup> <a name="awsFireLensCpu" id="@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.awsFireLensCpu"></a>
+
+```typescript
+public readonly awsFireLensCpu: number;
+```
+
+- *Type:* number
+- *Default:* 64
+
+The amount of virtual CPU units to be reserved for the firelens log-router container (i.e. aws-for-fluent-bit).
+
+This only applies for the AWS_FIRE_LENS logging mode.
+Setting it for any other logging mode will cause an exception.
+
+---
+
+##### `awsFireLensMemoryLimitMiB`<sup>Optional</sup> <a name="awsFireLensMemoryLimitMiB" id="@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.awsFireLensMemoryLimitMiB"></a>
+
+```typescript
+public readonly awsFireLensMemoryLimitMiB: number;
+```
+
+- *Type:* number
+- *Default:* 64
+
+The amount of memory (in MiB) reserved for the firelens log-router container (i.e. aws-for-fluent-bit).
+
+This only applies for the AWS_FIRE_LENS logging mode.
+Setting it for any other logging mode will cause an exception.
+
+---
+
 ##### `cpu`<sup>Optional</sup> <a name="cpu" id="@rio-cloud/cdk-v2-constructs.DatadogIntegrationProps.property.cpu"></a>
 
 ```typescript
@@ -9990,6 +10430,8 @@ const datadogIntegrationProps: fargate.DatadogIntegrationProps = { ... }
 | --- | --- | --- |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.additionalTags">additionalTags</a></code> | <code>{[ key: string ]: string}</code> | Configure additional tags, which are appended to the defaults, When you define custom tags we would be glad if you contact us. |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.apmGetEndpointsToIgnore">apmGetEndpointsToIgnore</a></code> | <code>string[]</code> | GET endpoints to ignore in Datadog's APM overview. |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.awsFireLensCpu">awsFireLensCpu</a></code> | <code>number</code> | The amount of virtual CPU units to be reserved for the firelens log-router container (i.e. aws-for-fluent-bit). |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.awsFireLensMemoryLimitMiB">awsFireLensMemoryLimitMiB</a></code> | <code>number</code> | The amount of memory (in MiB) reserved for the firelens log-router container (i.e. aws-for-fluent-bit). |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.cpu">cpu</a></code> | <code>number</code> | The minimum number of CPU units to reserve for the container. |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.datadogSidecarEssential">datadogSidecarEssential</a></code> | <code>boolean</code> | Configure if the Datadog agent sidecar is marked as essential. |
 | <code><a href="#@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.datadogSidecarTag">datadogSidecarTag</a></code> | <code>string</code> | Configures the docker image tag for datadog sidecar. |
@@ -10042,6 +10484,38 @@ This is useful to filter out all health check calls.
 
 ---
 
+##### `awsFireLensCpu`<sup>Optional</sup> <a name="awsFireLensCpu" id="@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.awsFireLensCpu"></a>
+
+```typescript
+public readonly awsFireLensCpu: number;
+```
+
+- *Type:* number
+- *Default:* 64
+
+The amount of virtual CPU units to be reserved for the firelens log-router container (i.e. aws-for-fluent-bit).
+
+This only applies for the AWS_FIRE_LENS logging mode.
+Setting it for any other logging mode will cause an exception.
+
+---
+
+##### `awsFireLensMemoryLimitMiB`<sup>Optional</sup> <a name="awsFireLensMemoryLimitMiB" id="@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.awsFireLensMemoryLimitMiB"></a>
+
+```typescript
+public readonly awsFireLensMemoryLimitMiB: number;
+```
+
+- *Type:* number
+- *Default:* 64
+
+The amount of memory (in MiB) reserved for the firelens log-router container (i.e. aws-for-fluent-bit).
+
+This only applies for the AWS_FIRE_LENS logging mode.
+Setting it for any other logging mode will cause an exception.
+
+---
+
 ##### `cpu`<sup>Optional</sup> <a name="cpu" id="@rio-cloud/cdk-v2-constructs.fargate.DatadogIntegrationProps.property.cpu"></a>
 
 ```typescript
@@ -12768,7 +13242,7 @@ Indicates if the producer will restore the data in case of a disaster or not.
 
 The current service limits can be found in the topic limits configuration of the topic manager.
 
-> [https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
+> [https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
 
 #### Initializer <a name="Initializer" id="@rio-cloud/cdk-v2-constructs.KafkaTopicProps.Initializer"></a>
 
@@ -12923,7 +13397,7 @@ The soft limit is 3 to 30 days but can be increased upon requests.
 
 The current service limits can be found in the topic limits configuration of the topic manager.
 
-> [https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
+> [https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
 
 #### Initializer <a name="Initializer" id="@rio-cloud/cdk-v2-constructs.kafka.KafkaTopicProps.Initializer"></a>
 
@@ -13078,7 +13552,7 @@ The soft limit is 3 to 30 days but can be increased upon requests.
 
 The current service limits can be found in the topic limits configuration of the topic manager.
 
-> [https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
+> [https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
 
 #### Initializer <a name="Initializer" id="@rio-cloud/cdk-v2-constructs.KafkaTopicV4Props.Initializer"></a>
 
@@ -13249,7 +13723,7 @@ The soft limit is 3 to 30 days but can be increased upon requests.
 
 The current service limits can be found in the topic limits configuration of the topic manager.
 
-> [https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
+> [https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml](https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-manager/browse/config/topic-service-limits.yaml)
 
 #### Initializer <a name="Initializer" id="@rio-cloud/cdk-v2-constructs.kafka.KafkaTopicV4Props.Initializer"></a>
 
@@ -16165,6 +16639,68 @@ public readonly env: Environment;
 
 ---
 
+### SesObservabilityProps <a name="SesObservabilityProps" id="@rio-cloud/cdk-v2-constructs.SesObservabilityProps"></a>
+
+#### Initializer <a name="Initializer" id="@rio-cloud/cdk-v2-constructs.SesObservabilityProps.Initializer"></a>
+
+```typescript
+import { SesObservabilityProps } from '@rio-cloud/cdk-v2-constructs'
+
+const sesObservabilityProps: SesObservabilityProps = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.SesObservabilityProps.property.loggedSesEvents">loggedSesEvents</a></code> | <code>aws-cdk-lib.aws_ses.EmailSendingEvent[]</code> | The SES events to log. |
+
+---
+
+##### `loggedSesEvents`<sup>Optional</sup> <a name="loggedSesEvents" id="@rio-cloud/cdk-v2-constructs.SesObservabilityProps.property.loggedSesEvents"></a>
+
+```typescript
+public readonly loggedSesEvents: EmailSendingEvent[];
+```
+
+- *Type:* aws-cdk-lib.aws_ses.EmailSendingEvent[]
+- *Default:* [EmailSendingEvent.DELIVERY, EmailSendingEvent.BOUNCE, EmailSendingEvent.COMPLAINT, EmailSendingEvent.REJECT]
+
+The SES events to log.
+
+---
+
+### SesObservabilityProps <a name="SesObservabilityProps" id="@rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps"></a>
+
+#### Initializer <a name="Initializer" id="@rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps.Initializer"></a>
+
+```typescript
+import { ses } from '@rio-cloud/cdk-v2-constructs'
+
+const sesObservabilityProps: ses.SesObservabilityProps = { ... }
+```
+
+#### Properties <a name="Properties" id="Properties"></a>
+
+| **Name** | **Type** | **Description** |
+| --- | --- | --- |
+| <code><a href="#@rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps.property.loggedSesEvents">loggedSesEvents</a></code> | <code>aws-cdk-lib.aws_ses.EmailSendingEvent[]</code> | The SES events to log. |
+
+---
+
+##### `loggedSesEvents`<sup>Optional</sup> <a name="loggedSesEvents" id="@rio-cloud/cdk-v2-constructs.ses.SesObservabilityProps.property.loggedSesEvents"></a>
+
+```typescript
+public readonly loggedSesEvents: EmailSendingEvent[];
+```
+
+- *Type:* aws-cdk-lib.aws_ses.EmailSendingEvent[]
+- *Default:* [EmailSendingEvent.DELIVERY, EmailSendingEvent.BOUNCE, EmailSendingEvent.COMPLAINT, EmailSendingEvent.REJECT]
+
+The SES events to log.
+
+---
+
 ### ShouldOverrideThresholdProps <a name="ShouldOverrideThresholdProps" id="@rio-cloud/cdk-v2-constructs.ShouldOverrideThresholdProps"></a>
 
 #### Initializer <a name="Initializer" id="@rio-cloud/cdk-v2-constructs.ShouldOverrideThresholdProps.Initializer"></a>
@@ -18047,8 +18583,8 @@ ecr.DockerHubPullThroughCache.allowAccessTo(target: IGrantable)
 
 Wrapper class for the event spec itself to support providing it via file or inline string.
 
-> [https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-creation-example for
-further information about the yaml spec.](https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-creation-example for
+> [https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-creation-example for
+further information about the yaml spec.](https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-creation-example for
 further information about the yaml spec.)
 
 #### Methods <a name="Methods" id="Methods"></a>
@@ -18135,8 +18671,8 @@ public readonly eventName: string;
 
 Wrapper class for the event spec itself to support providing it via file or inline string.
 
-> [https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-creation-example for
-further information about the yaml spec.](https://collaboration.msi.audi.com/stash/projects/RSEVTBU/repos/topic-creation-example for
+> [https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-creation-example for
+further information about the yaml spec.](https://bitbucket.collaboration-man.com/projects/RSEVTBU/repos/topic-creation-example for
 further information about the yaml spec.)
 
 #### Methods <a name="Methods" id="Methods"></a>

package/docs/changelog.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [6.16.1](https://bitbucket.collaboration-man.com/projects/RIODEV/repos/cdk-v2-constructs/compare/commits?targetBranch=refs%2Ftags%2Fv6.16.0&sourceBranch=refs%2Ftags%2Fv6.16.1) (2024-12-02)
+
+
+### Bug Fixes
+
+* **pipeline:** provide LANG env variable for vulnerability pipeline in buildspec. See RIOTT-7056 ([358bde6](https://bitbucket.collaboration-man.com/projects/RIODEV/repos/cdk-v2-constructs/commits/358bde670533f75ac77bf0f9d6cc5698fe89e1c8))
+
+## [6.16.0](https://bitbucket.collaboration-man.com/projects/RIODEV/repos/cdk-v2-constructs/compare/commits?targetBranch=refs%2Ftags%2Fv6.15.0&sourceBranch=refs%2Ftags%2Fv6.16.0) (2024-11-29)
+
+
+### Features
+
+* allow override of firelens container cpu/memory limits ([f8e4f4e](https://bitbucket.collaboration-man.com/projects/RIODEV/repos/cdk-v2-constructs/commits/f8e4f4eef7830a21e822b2c2b0911b91178046e8))
+
+
+### Bug Fixes
+
+* fix jsii compilation ([087e501](https://bitbucket.collaboration-man.com/projects/RIODEV/repos/cdk-v2-constructs/commits/087e501d26062e3f1212a5c848ce3e8f353ac1a5))
+
 ## [6.15.0](https://bitbucket.collaboration-man.com/projects/RIODEV/repos/cdk-v2-constructs/compare/commits?targetBranch=refs%2Ftags%2Fv6.15.0-alpha.1&sourceBranch=refs%2Ftags%2Fv6.15.0) (2024-11-25)
 
 ## [6.15.0-alpha.1](https://bitbucket.collaboration-man.com/projects/RIODEV/repos/cdk-v2-constructs/compare/commits?targetBranch=refs%2Ftags%2Fv6.15.0-alpha.0&sourceBranch=refs%2Ftags%2Fv6.15.0-alpha.1) (2024-11-21)

package/esbuild.mjs

@@ -22,6 +22,10 @@ const entryPoints = [
         basePath: 'datadogv2/service-catalog-custom-resource',
         fileName: 'on-create.ts',
     },
+    {
+        basePath: 'ses/lambda',
+        fileName: 'ses-logger.ts',
+    },
 ]
 
 for (const handler of entryPoints) {