aws-cdk-lib 2.167.2__py3-none-any.whl → 2.168.0__py3-none-any.whl

aws_cdk/aws_lambda_destinations/__init__.py

@@ -12,6 +12,7 @@ The following destinations are supported
 * SQS queue - Only standard SQS queues are supported for failure destinations, FIFO queues are not supported.
 * SNS topic
 * EventBridge event bus
+* S3 bucket
 
 Example with a SNS topic for successful invocations:
 
@@ -118,6 +119,8 @@ In case of failure, the record contains the reason and error object:
   depending on whether the lambda function invocation succeeded or failed. The event field `resource`
   contains the function and destination ARNs. See [AWS Events](https://docs.aws.amazon.com/eventbridge/latest/userguide/aws-events.html)
   for the different event fields.
+* For S3 (`S3Destination`), the invocation record json is stored as a `File` in the destination bucket. The path of a destination
+  payload file in the configured bucket is `aws/lambda/async/<function-name>/YYYY/MM/DD/YYYY-MM-DDTHH.MM.SS-<Random UUID>`.
 
 ### Auto-extract response payload with lambda destination
 
@@ -190,6 +193,7 @@ from ..aws_lambda import (
     IDestination as _IDestination_40f19de4,
     IFunction as _IFunction_6adb0ab8,
 )
+from ..aws_s3 import IBucket as _IBucket_42e086fd
 from ..aws_sns import ITopic as _ITopic_9eca4852
 from ..aws_sqs import IQueue as _IQueue_7ed6f679
 
@@ -382,6 +386,59 @@ class LambdaDestinationOptions:
         )
 
 
+@jsii.implements(_IDestination_40f19de4)
+class S3Destination(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_lambda_destinations.S3Destination",
+):
+    '''Use a S3 bucket as a Lambda destination.
+
+    :exampleMetadata: fixture=_generated
+
+    Example::
+
+        # The code below shows an example of how to instantiate this type.
+        # The values are placeholders you should change.
+        from aws_cdk import aws_lambda_destinations as lambda_destinations
+        from aws_cdk import aws_s3 as s3
+        
+        # bucket: s3.Bucket
+        
+        s3_destination = lambda_destinations.S3Destination(bucket)
+    '''
+
+    def __init__(self, bucket: _IBucket_42e086fd) -> None:
+        '''
+        :param bucket: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__19ce994678bf430d4bf8c27699213b91b48000db20e031ef641903ad7cba32bb)
+            check_type(argname="argument bucket", value=bucket, expected_type=type_hints["bucket"])
+        jsii.create(self.__class__, self, [bucket])
+
+    @jsii.member(jsii_name="bind")
+    def bind(
+        self,
+        _scope: _constructs_77d1e7e8.Construct,
+        fn: _IFunction_6adb0ab8,
+        *,
+        type: _DestinationType_2872235c,
+    ) -> _DestinationConfig_6f7459c3:
+        '''Returns a destination configuration.
+
+        :param _scope: -
+        :param fn: -
+        :param type: The destination type.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__8041d5190555a336db2fde21ca0f75545969f47e7841f3664219b3ace0fbf4bd)
+            check_type(argname="argument _scope", value=_scope, expected_type=type_hints["_scope"])
+            check_type(argname="argument fn", value=fn, expected_type=type_hints["fn"])
+        _options = _DestinationOptions_3f2abf0e(type=type)
+
+        return typing.cast(_DestinationConfig_6f7459c3, jsii.invoke(self, "bind", [_scope, fn, _options]))
+
+
 @jsii.implements(_IDestination_40f19de4)
 class SnsDestination(
     metaclass=jsii.JSIIMeta,
@@ -502,6 +559,7 @@ __all__ = [
     "EventBridgeDestination",
     "LambdaDestination",
     "LambdaDestinationOptions",
+    "S3Destination",
     "SnsDestination",
     "SqsDestination",
 ]
@@ -547,6 +605,21 @@ def _typecheckingstub__a7c99f6a6bf8bcf694e2e5c9f5c69825b83541adab1d1d27cd08f36f7
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__19ce994678bf430d4bf8c27699213b91b48000db20e031ef641903ad7cba32bb(
+    bucket: _IBucket_42e086fd,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__8041d5190555a336db2fde21ca0f75545969f47e7841f3664219b3ace0fbf4bd(
+    _scope: _constructs_77d1e7e8.Construct,
+    fn: _IFunction_6adb0ab8,
+    *,
+    type: _DestinationType_2872235c,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__0474b18a4b0c020ae5b8822345f59885f437a1137749c013b61839b711396931(
     topic: _ITopic_9eca4852,
 ) -> None:

aws_cdk/aws_lambda_event_sources/__init__.py

@@ -471,6 +471,7 @@ from ..aws_lambda import (
     IEventSourceDlq as _IEventSourceDlq_5e2c6ad9,
     IEventSourceMapping as _IEventSourceMapping_e216064e,
     IFunction as _IFunction_6adb0ab8,
+    MetricsConfig as _MetricsConfig_48ab59c4,
     SourceAccessConfiguration as _SourceAccessConfiguration_1926ff89,
     StartingPosition as _StartingPosition_c0a4852c,
 )
@@ -2091,6 +2092,7 @@ class SqsEventSource(
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_batching_window: typing.Optional[_Duration_4839e8c3] = None,
         max_concurrency: typing.Optional[jsii.Number] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''
@@ -2101,6 +2103,7 @@ class SqsEventSource(
         :param filters: Add filter criteria option. Default: - None
         :param max_batching_window: The maximum amount of time to gather records before invoking the function. Valid Range: Minimum value of 0 minutes. Maximum value of 5 minutes. Default: - no batching window. The lambda function will be invoked immediately with the records that are available.
         :param max_concurrency: The maximum concurrency setting limits the number of concurrent instances of the function that an Amazon SQS event source can invoke. Default: - No specific limit.
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
         '''
         if __debug__:
@@ -2113,6 +2116,7 @@ class SqsEventSource(
             filters=filters,
             max_batching_window=max_batching_window,
             max_concurrency=max_concurrency,
+            metrics_config=metrics_config,
             report_batch_item_failures=report_batch_item_failures,
         )
 
@@ -2157,6 +2161,7 @@ class SqsEventSource(
         "filters": "filters",
         "max_batching_window": "maxBatchingWindow",
         "max_concurrency": "maxConcurrency",
+        "metrics_config": "metricsConfig",
         "report_batch_item_failures": "reportBatchItemFailures",
     },
 )
@@ -2170,6 +2175,7 @@ class SqsEventSourceProps:
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_batching_window: typing.Optional[_Duration_4839e8c3] = None,
         max_concurrency: typing.Optional[jsii.Number] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''
@@ -2179,6 +2185,7 @@ class SqsEventSourceProps:
         :param filters: Add filter criteria option. Default: - None
         :param max_batching_window: The maximum amount of time to gather records before invoking the function. Valid Range: Minimum value of 0 minutes. Maximum value of 5 minutes. Default: - no batching window. The lambda function will be invoked immediately with the records that are available.
         :param max_concurrency: The maximum concurrency setting limits the number of concurrent instances of the function that an Amazon SQS event source can invoke. Default: - No specific limit.
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
 
         :exampleMetadata: infused
@@ -2199,6 +2206,8 @@ class SqsEventSourceProps:
                 report_batch_item_failures=True
             ))
         '''
+        if isinstance(metrics_config, dict):
+            metrics_config = _MetricsConfig_48ab59c4(**metrics_config)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__15f8ac7c8dd3ede272e50988fdcd091f07e9c5d7ef95ab596dc66b4c940652b4)
             check_type(argname="argument batch_size", value=batch_size, expected_type=type_hints["batch_size"])
@@ -2207,6 +2216,7 @@ class SqsEventSourceProps:
             check_type(argname="argument filters", value=filters, expected_type=type_hints["filters"])
             check_type(argname="argument max_batching_window", value=max_batching_window, expected_type=type_hints["max_batching_window"])
             check_type(argname="argument max_concurrency", value=max_concurrency, expected_type=type_hints["max_concurrency"])
+            check_type(argname="argument metrics_config", value=metrics_config, expected_type=type_hints["metrics_config"])
             check_type(argname="argument report_batch_item_failures", value=report_batch_item_failures, expected_type=type_hints["report_batch_item_failures"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if batch_size is not None:
@@ -2221,6 +2231,8 @@ class SqsEventSourceProps:
             self._values["max_batching_window"] = max_batching_window
         if max_concurrency is not None:
             self._values["max_concurrency"] = max_concurrency
+        if metrics_config is not None:
+            self._values["metrics_config"] = metrics_config
         if report_batch_item_failures is not None:
             self._values["report_batch_item_failures"] = report_batch_item_failures
 
@@ -2296,6 +2308,15 @@ class SqsEventSourceProps:
         result = self._values.get("max_concurrency")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def metrics_config(self) -> typing.Optional[_MetricsConfig_48ab59c4]:
+        '''Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source.
+
+        :default: - Enhanced monitoring is disabled
+        '''
+        result = self._values.get("metrics_config")
+        return typing.cast(typing.Optional[_MetricsConfig_48ab59c4], result)
+
     @builtins.property
     def report_batch_item_failures(self) -> typing.Optional[builtins.bool]:
         '''Allow functions to return partially successful responses for a batch of records.
@@ -2333,6 +2354,7 @@ class StreamEventSource(
         filter_encryption: typing.Optional[_IKey_5f11635f] = None,
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
         parallelization_factor: typing.Optional[jsii.Number] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -2348,6 +2370,7 @@ class StreamEventSource(
         :param filter_encryption: Add Customer managed KMS key to encrypt Filter Criteria. Default: - none
         :param filters: Add filter criteria option. Default: - None
         :param max_record_age: The maximum age of a record that Lambda sends to a function for processing. Valid Range: - Minimum value of 60 seconds - Maximum value of 7 days The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. Record are valid until it expires in the event source. Default: -1
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param on_failure: An Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
@@ -2363,6 +2386,7 @@ class StreamEventSource(
             filter_encryption=filter_encryption,
             filters=filters,
             max_record_age=max_record_age,
+            metrics_config=metrics_config,
             on_failure=on_failure,
             parallelization_factor=parallelization_factor,
             report_batch_item_failures=report_batch_item_failures,
@@ -2401,6 +2425,7 @@ class StreamEventSource(
         max_batching_window: typing.Optional[_Duration_4839e8c3] = None,
         max_concurrency: typing.Optional[jsii.Number] = None,
         max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
         parallelization_factor: typing.Optional[jsii.Number] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -2424,6 +2449,7 @@ class StreamEventSource(
         :param max_batching_window: The maximum amount of time to gather records before invoking the function. Maximum of Duration.minutes(5) Default: Duration.seconds(0)
         :param max_concurrency: The maximum concurrency setting limits the number of concurrent instances of the function that an Amazon SQS event source can invoke. Default: - No specific limit.
         :param max_record_age: The maximum age of a record that Lambda sends to a function for processing. Valid Range: - Minimum value of 60 seconds - Maximum value of 7 days Default: - infinite or until the record expires.
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param on_failure: An Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
@@ -2447,6 +2473,7 @@ class StreamEventSource(
             max_batching_window=max_batching_window,
             max_concurrency=max_concurrency,
             max_record_age=max_record_age,
+            metrics_config=metrics_config,
             on_failure=on_failure,
             parallelization_factor=parallelization_factor,
             report_batch_item_failures=report_batch_item_failures,
@@ -2494,6 +2521,7 @@ typing.cast(typing.Any, StreamEventSource).__jsii_proxy_class__ = lambda : _Stre
         "filter_encryption": "filterEncryption",
         "filters": "filters",
         "max_record_age": "maxRecordAge",
+        "metrics_config": "metricsConfig",
         "on_failure": "onFailure",
         "parallelization_factor": "parallelizationFactor",
         "report_batch_item_failures": "reportBatchItemFailures",
@@ -2513,6 +2541,7 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
         filter_encryption: typing.Optional[_IKey_5f11635f] = None,
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
         parallelization_factor: typing.Optional[jsii.Number] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -2529,6 +2558,7 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
         :param filter_encryption: Add Customer managed KMS key to encrypt Filter Criteria. Default: - none
         :param filters: Add filter criteria option. Default: - None
         :param max_record_age: The maximum age of a record that Lambda sends to a function for processing. Valid Range: - Minimum value of 60 seconds - Maximum value of 7 days The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. Record are valid until it expires in the event source. Default: -1
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param on_failure: An Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
@@ -2563,6 +2593,9 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
                 }],
                 max_batching_window=cdk.Duration.minutes(30),
                 max_record_age=cdk.Duration.minutes(30),
+                metrics_config=lambda.MetricsConfig(
+                    metrics=[lambda_.MetricType.EVENT_COUNT]
+                ),
                 on_failure=event_source_dlq,
                 parallelization_factor=123,
                 report_batch_item_failures=False,
@@ -2570,6 +2603,8 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
                 tumbling_window=cdk.Duration.minutes(30)
             )
         '''
+        if isinstance(metrics_config, dict):
+            metrics_config = _MetricsConfig_48ab59c4(**metrics_config)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__f846cf48a1cd8d8120ed4973fabeee827928eff2de72d372506124b7d1eedd59)
             check_type(argname="argument starting_position", value=starting_position, expected_type=type_hints["starting_position"])
@@ -2580,6 +2615,7 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
             check_type(argname="argument filter_encryption", value=filter_encryption, expected_type=type_hints["filter_encryption"])
             check_type(argname="argument filters", value=filters, expected_type=type_hints["filters"])
             check_type(argname="argument max_record_age", value=max_record_age, expected_type=type_hints["max_record_age"])
+            check_type(argname="argument metrics_config", value=metrics_config, expected_type=type_hints["metrics_config"])
             check_type(argname="argument on_failure", value=on_failure, expected_type=type_hints["on_failure"])
             check_type(argname="argument parallelization_factor", value=parallelization_factor, expected_type=type_hints["parallelization_factor"])
             check_type(argname="argument report_batch_item_failures", value=report_batch_item_failures, expected_type=type_hints["report_batch_item_failures"])
@@ -2602,6 +2638,8 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
             self._values["filters"] = filters
         if max_record_age is not None:
             self._values["max_record_age"] = max_record_age
+        if metrics_config is not None:
+            self._values["metrics_config"] = metrics_config
         if on_failure is not None:
             self._values["on_failure"] = on_failure
         if parallelization_factor is not None:
@@ -2711,6 +2749,15 @@ class StreamEventSourceProps(BaseStreamEventSourceProps):
         result = self._values.get("max_record_age")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def metrics_config(self) -> typing.Optional[_MetricsConfig_48ab59c4]:
+        '''Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source.
+
+        :default: - Enhanced monitoring is disabled
+        '''
+        result = self._values.get("metrics_config")
+        return typing.cast(typing.Optional[_MetricsConfig_48ab59c4], result)
+
     @builtins.property
     def on_failure(self) -> typing.Optional[_IEventSourceDlq_5e2c6ad9]:
         '''An Amazon SQS queue or Amazon SNS topic destination for discarded records.
@@ -2802,9 +2849,12 @@ class DynamoEventSource(
             ),
             stream=dynamodb.StreamViewType.NEW_IMAGE
         )
+        
         fn.add_event_source(eventsources.DynamoEventSource(table,
             starting_position=lambda_.StartingPosition.LATEST,
-            filters=[lambda_.FilterCriteria.filter({"event_name": lambda_.FilterRule.is_equal("INSERT")})]
+            metrics_config=lambda.MetricsConfig(
+                metrics=[lambda_.MetricType.EVENT_COUNT]
+            )
         ))
     '''
 
@@ -2816,6 +2866,7 @@ class DynamoEventSource(
         filter_encryption: typing.Optional[_IKey_5f11635f] = None,
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
         parallelization_factor: typing.Optional[jsii.Number] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -2832,6 +2883,7 @@ class DynamoEventSource(
         :param filter_encryption: Add Customer managed KMS key to encrypt Filter Criteria. Default: - none
         :param filters: Add filter criteria option. Default: - None
         :param max_record_age: The maximum age of a record that Lambda sends to a function for processing. Valid Range: - Minimum value of 60 seconds - Maximum value of 7 days The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. Record are valid until it expires in the event source. Default: -1
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param on_failure: An Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
@@ -2850,6 +2902,7 @@ class DynamoEventSource(
             filter_encryption=filter_encryption,
             filters=filters,
             max_record_age=max_record_age,
+            metrics_config=metrics_config,
             on_failure=on_failure,
             parallelization_factor=parallelization_factor,
             report_batch_item_failures=report_batch_item_failures,
@@ -2899,6 +2952,7 @@ class DynamoEventSource(
         "filter_encryption": "filterEncryption",
         "filters": "filters",
         "max_record_age": "maxRecordAge",
+        "metrics_config": "metricsConfig",
         "on_failure": "onFailure",
         "parallelization_factor": "parallelizationFactor",
         "report_batch_item_failures": "reportBatchItemFailures",
@@ -2918,6 +2972,7 @@ class DynamoEventSourceProps(StreamEventSourceProps):
         filter_encryption: typing.Optional[_IKey_5f11635f] = None,
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
         parallelization_factor: typing.Optional[jsii.Number] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -2933,6 +2988,7 @@ class DynamoEventSourceProps(StreamEventSourceProps):
         :param filter_encryption: Add Customer managed KMS key to encrypt Filter Criteria. Default: - none
         :param filters: Add filter criteria option. Default: - None
         :param max_record_age: The maximum age of a record that Lambda sends to a function for processing. Valid Range: - Minimum value of 60 seconds - Maximum value of 7 days The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. Record are valid until it expires in the event source. Default: -1
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param on_failure: An Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
@@ -2955,11 +3011,16 @@ class DynamoEventSourceProps(StreamEventSourceProps):
                 ),
                 stream=dynamodb.StreamViewType.NEW_IMAGE
             )
+            
             fn.add_event_source(eventsources.DynamoEventSource(table,
                 starting_position=lambda_.StartingPosition.LATEST,
-                filters=[lambda_.FilterCriteria.filter({"event_name": lambda_.FilterRule.is_equal("INSERT")})]
+                metrics_config=lambda.MetricsConfig(
+                    metrics=[lambda_.MetricType.EVENT_COUNT]
+                )
             ))
         '''
+        if isinstance(metrics_config, dict):
+            metrics_config = _MetricsConfig_48ab59c4(**metrics_config)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__ec371d5e4612e8923bbdcc024d90e26915d64be2dc40151f22fc41139c2d48b3)
             check_type(argname="argument starting_position", value=starting_position, expected_type=type_hints["starting_position"])
@@ -2970,6 +3031,7 @@ class DynamoEventSourceProps(StreamEventSourceProps):
             check_type(argname="argument filter_encryption", value=filter_encryption, expected_type=type_hints["filter_encryption"])
             check_type(argname="argument filters", value=filters, expected_type=type_hints["filters"])
             check_type(argname="argument max_record_age", value=max_record_age, expected_type=type_hints["max_record_age"])
+            check_type(argname="argument metrics_config", value=metrics_config, expected_type=type_hints["metrics_config"])
             check_type(argname="argument on_failure", value=on_failure, expected_type=type_hints["on_failure"])
             check_type(argname="argument parallelization_factor", value=parallelization_factor, expected_type=type_hints["parallelization_factor"])
             check_type(argname="argument report_batch_item_failures", value=report_batch_item_failures, expected_type=type_hints["report_batch_item_failures"])
@@ -2992,6 +3054,8 @@ class DynamoEventSourceProps(StreamEventSourceProps):
             self._values["filters"] = filters
         if max_record_age is not None:
             self._values["max_record_age"] = max_record_age
+        if metrics_config is not None:
+            self._values["metrics_config"] = metrics_config
         if on_failure is not None:
             self._values["on_failure"] = on_failure
         if parallelization_factor is not None:
@@ -3101,6 +3165,15 @@ class DynamoEventSourceProps(StreamEventSourceProps):
         result = self._values.get("max_record_age")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def metrics_config(self) -> typing.Optional[_MetricsConfig_48ab59c4]:
+        '''Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source.
+
+        :default: - Enhanced monitoring is disabled
+        '''
+        result = self._values.get("metrics_config")
+        return typing.cast(typing.Optional[_MetricsConfig_48ab59c4], result)
+
     @builtins.property
     def on_failure(self) -> typing.Optional[_IEventSourceDlq_5e2c6ad9]:
         '''An Amazon SQS queue or Amazon SNS topic destination for discarded records.
@@ -3202,6 +3275,7 @@ class KinesisEventSource(
         filter_encryption: typing.Optional[_IKey_5f11635f] = None,
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
         parallelization_factor: typing.Optional[jsii.Number] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -3219,6 +3293,7 @@ class KinesisEventSource(
         :param filter_encryption: Add Customer managed KMS key to encrypt Filter Criteria. Default: - none
         :param filters: Add filter criteria option. Default: - None
         :param max_record_age: The maximum age of a record that Lambda sends to a function for processing. Valid Range: - Minimum value of 60 seconds - Maximum value of 7 days The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. Record are valid until it expires in the event source. Default: -1
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param on_failure: An Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
@@ -3238,6 +3313,7 @@ class KinesisEventSource(
             filter_encryption=filter_encryption,
             filters=filters,
             max_record_age=max_record_age,
+            metrics_config=metrics_config,
             on_failure=on_failure,
             parallelization_factor=parallelization_factor,
             report_batch_item_failures=report_batch_item_failures,
@@ -3292,6 +3368,7 @@ class KinesisEventSource(
         "filter_encryption": "filterEncryption",
         "filters": "filters",
         "max_record_age": "maxRecordAge",
+        "metrics_config": "metricsConfig",
         "on_failure": "onFailure",
         "parallelization_factor": "parallelizationFactor",
         "report_batch_item_failures": "reportBatchItemFailures",
@@ -3312,6 +3389,7 @@ class KinesisEventSourceProps(StreamEventSourceProps):
         filter_encryption: typing.Optional[_IKey_5f11635f] = None,
         filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
         max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+        metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
         on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
         parallelization_factor: typing.Optional[jsii.Number] = None,
         report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -3328,6 +3406,7 @@ class KinesisEventSourceProps(StreamEventSourceProps):
         :param filter_encryption: Add Customer managed KMS key to encrypt Filter Criteria. Default: - none
         :param filters: Add filter criteria option. Default: - None
         :param max_record_age: The maximum age of a record that Lambda sends to a function for processing. Valid Range: - Minimum value of 60 seconds - Maximum value of 7 days The default value is -1, which sets the maximum age to infinite. When the value is set to infinite, Lambda never discards old records. Record are valid until it expires in the event source. Default: -1
+        :param metrics_config: Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source. Default: - Enhanced monitoring is disabled
         :param on_failure: An Amazon SQS queue or Amazon SNS topic destination for discarded records. Default: - discarded records are ignored
         :param parallelization_factor: The number of batches to process from each shard concurrently. Valid Range: - Minimum value of 1 - Maximum value of 10 Default: 1
         :param report_batch_item_failures: Allow functions to return partially successful responses for a batch of records. Default: false
@@ -3351,6 +3430,8 @@ class KinesisEventSourceProps(StreamEventSourceProps):
                 starting_position=lambda_.StartingPosition.TRIM_HORIZON
             ))
         '''
+        if isinstance(metrics_config, dict):
+            metrics_config = _MetricsConfig_48ab59c4(**metrics_config)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a0e5c31953f1ef382a7863484f36982000428c40cc94325c4f41de1e3d040903)
             check_type(argname="argument starting_position", value=starting_position, expected_type=type_hints["starting_position"])
@@ -3361,6 +3442,7 @@ class KinesisEventSourceProps(StreamEventSourceProps):
             check_type(argname="argument filter_encryption", value=filter_encryption, expected_type=type_hints["filter_encryption"])
             check_type(argname="argument filters", value=filters, expected_type=type_hints["filters"])
             check_type(argname="argument max_record_age", value=max_record_age, expected_type=type_hints["max_record_age"])
+            check_type(argname="argument metrics_config", value=metrics_config, expected_type=type_hints["metrics_config"])
             check_type(argname="argument on_failure", value=on_failure, expected_type=type_hints["on_failure"])
             check_type(argname="argument parallelization_factor", value=parallelization_factor, expected_type=type_hints["parallelization_factor"])
             check_type(argname="argument report_batch_item_failures", value=report_batch_item_failures, expected_type=type_hints["report_batch_item_failures"])
@@ -3384,6 +3466,8 @@ class KinesisEventSourceProps(StreamEventSourceProps):
             self._values["filters"] = filters
         if max_record_age is not None:
             self._values["max_record_age"] = max_record_age
+        if metrics_config is not None:
+            self._values["metrics_config"] = metrics_config
         if on_failure is not None:
             self._values["on_failure"] = on_failure
         if parallelization_factor is not None:
@@ -3495,6 +3579,15 @@ class KinesisEventSourceProps(StreamEventSourceProps):
         result = self._values.get("max_record_age")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def metrics_config(self) -> typing.Optional[_MetricsConfig_48ab59c4]:
+        '''Configuration for enhanced monitoring metrics collection When specified, enables collection of additional metrics for the stream event source.
+
+        :default: - Enhanced monitoring is disabled
+        '''
+        result = self._values.get("metrics_config")
+        return typing.cast(typing.Optional[_MetricsConfig_48ab59c4], result)
+
     @builtins.property
     def on_failure(self) -> typing.Optional[_IEventSourceDlq_5e2c6ad9]:
         '''An Amazon SQS queue or Amazon SNS topic destination for discarded records.
@@ -4013,6 +4106,7 @@ def _typecheckingstub__bf54c2a4adfa05b385a456a89f23dd0699f8e61461cae79f7a40b0a82
     filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
     max_batching_window: typing.Optional[_Duration_4839e8c3] = None,
     max_concurrency: typing.Optional[jsii.Number] = None,
+    metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
@@ -4032,6 +4126,7 @@ def _typecheckingstub__15f8ac7c8dd3ede272e50988fdcd091f07e9c5d7ef95ab596dc66b4c9
     filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
     max_batching_window: typing.Optional[_Duration_4839e8c3] = None,
     max_concurrency: typing.Optional[jsii.Number] = None,
+    metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
@@ -4053,6 +4148,7 @@ def _typecheckingstub__f846cf48a1cd8d8120ed4973fabeee827928eff2de72d372506124b7d
     filter_encryption: typing.Optional[_IKey_5f11635f] = None,
     filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
     max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+    metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
     on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
     parallelization_factor: typing.Optional[jsii.Number] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -4069,6 +4165,7 @@ def _typecheckingstub__826ee32f5239c7c242a7200ffc24778bee01c1101c3cc939fed4a8615
     filter_encryption: typing.Optional[_IKey_5f11635f] = None,
     filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
     max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+    metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
     on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
     parallelization_factor: typing.Optional[jsii.Number] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -4098,6 +4195,7 @@ def _typecheckingstub__ec371d5e4612e8923bbdcc024d90e26915d64be2dc40151f22fc41139
     filter_encryption: typing.Optional[_IKey_5f11635f] = None,
     filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
     max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+    metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
     on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
     parallelization_factor: typing.Optional[jsii.Number] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -4115,6 +4213,7 @@ def _typecheckingstub__9f81acc98c12b4967363bdd43130a7e674a566679a7b200f5ccd6a0ae
     filter_encryption: typing.Optional[_IKey_5f11635f] = None,
     filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
     max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+    metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
     on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
     parallelization_factor: typing.Optional[jsii.Number] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,
@@ -4144,6 +4243,7 @@ def _typecheckingstub__a0e5c31953f1ef382a7863484f36982000428c40cc94325c4f41de1e3
     filter_encryption: typing.Optional[_IKey_5f11635f] = None,
     filters: typing.Optional[typing.Sequence[typing.Mapping[builtins.str, typing.Any]]] = None,
     max_record_age: typing.Optional[_Duration_4839e8c3] = None,
+    metrics_config: typing.Optional[typing.Union[_MetricsConfig_48ab59c4, typing.Dict[builtins.str, typing.Any]]] = None,
     on_failure: typing.Optional[_IEventSourceDlq_5e2c6ad9] = None,
     parallelization_factor: typing.Optional[jsii.Number] = None,
     report_batch_item_failures: typing.Optional[builtins.bool] = None,