aws-cdk-lib 2.200.2__py3-none-any.whl → 2.224.0__py3-none-any.whl

aws_cdk/aws_cloudwatch/__init__.py

@@ -54,6 +54,41 @@ metric = cloudwatch.Metric(
 )
 ```
 
+### Metric ID
+
+Metrics can be assigned a unique identifier using the `id` property. This is
+useful when referencing metrics in math expressions:
+
+```python
+metric = cloudwatch.Metric(
+    namespace="AWS/Lambda",
+    metric_name="Invocations",
+    dimensions_map={
+        "FunctionName": "MyFunction"
+    },
+    id="invocations"
+)
+```
+
+The `id` must start with a lowercase letter and can only contain letters, numbers, and underscores.
+
+### Metric Visible
+
+Metrics can be hidden from dashboard graphs using the `visible` property:
+
+```python
+# fn: lambda.Function
+
+
+metric = fn.metric_errors(
+    visible=False
+)
+```
+
+By default, all metrics are visible (`visible: true`). Setting `visible: false`
+hides the metric from dashboard visualizations while still allowing it to be
+used in math expressions given that it has an `id` set to it.
+
 ### Metric Math
 
 Math expressions are supported by instantiating the `MathExpression` class.
@@ -89,21 +124,45 @@ problem_percentage = cloudwatch.MathExpression(
 )
 ```
 
+### Metric ID Usage in Math Expressions
+
+When metrics have custom IDs, you can reference them directly in math expressions.
+
+```python
+# fn: lambda.Function
+
+
+invocations = fn.metric_invocations(
+    id="lambda_invocations"
+)
+
+errors = fn.metric_errors(
+    id="lambda_errors"
+)
+```
+
+When metrics have predefined IDs, they can be referenced directly in math expressions by their ID without requiring the `usingMetrics` property.
+
+```python
+error_rate = cloudwatch.MathExpression(
+    expression="lambda_errors / lambda_invocations * 100",
+    label="Error Rate (%)"
+)
+```
+
 ### Search Expressions
 
-Math expressions also support search expressions. For example, the following
-search expression returns all CPUUtilization metrics that it finds, with the
-graph showing the Average statistic with an aggregation period of 5 minutes:
+Search expressions allow you to dynamically discover and display metrics that match specific criteria, making them ideal for monitoring dynamic infrastructure where the exact metrics aren't known in advance. A single search expression can return up to 500 time series.
+
+#### Using SearchExpression Class
+
+Following is an example of a search expression that returns all CPUUtilization metrics with the graph showing the Average statistic with an aggregation period of 5 minutes:
 
 ```python
-cpu_utilization = cloudwatch.MathExpression(
-    expression="SEARCH('{AWS/EC2,InstanceId} MetricName=\"CPUUtilization\"', 'Average', 300)",
-
-    # Specifying '' as the label suppresses the default behavior
-    # of using the expression as metric label. This is especially appropriate
-    # when using expressions that return multiple time series (like SEARCH()
-    # or METRICS()), to show the labels of the retrieved metrics only.
-    label=""
+cpu_utilization = cloudwatch.SearchExpression(
+    expression="SEARCH('{AWS/EC2,InstanceId} MetricName=\"CPUUtilization\"', 'Average', 900)",
+    label="EC2 CPU Utilization",
+    color="#ff7f0e"
 )
 ```
 
@@ -111,6 +170,15 @@ Cross-account and cross-region search expressions are also supported. Use
 the `searchAccount` and `searchRegion` properties to specify the account
 and/or region to evaluate the search expression against.
 
+```python
+cross_account_search = cloudwatch.SearchExpression(
+    expression="SEARCH('{AWS/Lambda,FunctionName} MetricName=\"Invocations\"', 'Sum', 300)",
+    search_account="123456789012",
+    search_region="us-west-2",
+    label="Production Lambda Invocations"
+)
+```
+
 ### Aggregation
 
 To graph or alarm on metrics you must aggregate them first, using a function
@@ -418,7 +486,7 @@ metric = cloudwatch.Metric(
     namespace="AWS/EC2",
     metric_name="CPUUtilization",
     statistic="Average",
-    period=Duration.minutes(5)
+    period=Duration.hours(1)
 )
 
 # Create an anomaly detection alarm
@@ -541,6 +609,20 @@ dashboard.add_widgets(cloudwatch.GraphWidget(
 ))
 ```
 
+The `displayLabelsOnChart` property can be set to `true` to show labels on the chart. Note that this only has an effect when the `view` property is set to `cloudwatch.GraphWidgetView.PIE`.
+
+```python
+# dashboard: cloudwatch.Dashboard
+
+
+dashboard.add_widgets(cloudwatch.GraphWidget(
+    # ...
+
+    view=cloudwatch.GraphWidgetView.PIE,
+    display_labels_on_chart=True
+))
+```
+
 The `start` and `end` properties can be used to specify the time range for each graph widget independently from those of the dashboard.
 The parameters can be specified at `GraphWidget`, `GaugeWidget`, and `SingleValueWidget`.
 
@@ -811,6 +893,20 @@ dashboard.add_widgets(cloudwatch.LogQueryWidget(
 ))
 ```
 
+Log Insights QL is the default query language. You may specify an [alternate query language: OpenSearch PPL or SQL](https://aws.amazon.com/blogs/aws/new-amazon-cloudwatch-and-amazon-opensearch-service-launch-an-integrated-analytics-experience/), if desired:
+
+```python
+# dashboard: cloudwatch.Dashboard
+
+
+dashboard.add_widgets(cloudwatch.LogQueryWidget(
+    log_group_names=["my-log-group"],
+    view=cloudwatch.LogQueryVisualizationType.TABLE,
+    query_string="SELECT count(*) as count FROM 'my-log-group'",
+    query_language=cloudwatch.LogQueryLanguage.SQL
+))
+```
+
 ### Custom widget
 
 A `CustomWidget` shows the result of an AWS Lambda function:
@@ -984,6 +1080,38 @@ dashboard = cw.Dashboard(self, "Dash",
 ```
 
 You can add a variable after object instantiation with the method `dashboard.addVariable()`.
+
+### Cross-Account Visibility
+
+Both Log and Metric Widget objects support cross-account visibility by allowing you to specify the AWS Account ID that the data (logs or metrics) originates from.
+
+**Prerequisites:**
+
+1. The monitoring account must be set up as a monitoring account
+2. The source account must grant permissions to the monitoring account
+3. Appropriate IAM roles and policies must be configured
+
+For detailed setup instructions, see [Cross-Account Cross-Region CloudWatch Console](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Cross-Account-Cross-Region.html).
+
+To use this feature, you can set the `accountId` property on `LogQueryWidget`, `GraphWidget`, `AlarmWidget`, `SingleValueWidget`, and `GaugeWidget` constructs:
+
+```python
+# dashboard: cloudwatch.Dashboard
+
+
+dashboard.add_widgets(cloudwatch.GraphWidget(
+    # ...
+    account_id="123456789012"
+))
+
+dashboard.add_widgets(cloudwatch.LogQueryWidget(
+    log_group_names=["my-log-group"],
+    # ...
+    account_id="123456789012",
+    query_lines=["fields @message"
+    ]
+))
+```
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -1033,6 +1161,20 @@ from .. import (
     TreeInspector as _TreeInspector_488e0dd5,
 )
 from ..aws_iam import Grant as _Grant_a7ae64f8, IGrantable as _IGrantable_71c4f5de
+from ..interfaces.aws_cloudwatch import (
+    AlarmReference as _AlarmReference_76b2c14f,
+    AnomalyDetectorReference as _AnomalyDetectorReference_11b9b19b,
+    CompositeAlarmReference as _CompositeAlarmReference_bca78bf2,
+    DashboardReference as _DashboardReference_71933abf,
+    IAlarmRef as _IAlarmRef_2bb0e5de,
+    IAnomalyDetectorRef as _IAnomalyDetectorRef_824aa9dc,
+    ICompositeAlarmRef as _ICompositeAlarmRef_fa51824d,
+    IDashboardRef as _IDashboardRef_3c35946b,
+    IInsightRuleRef as _IInsightRuleRef_436d0d73,
+    IMetricStreamRef as _IMetricStreamRef_2c784fc6,
+    InsightRuleReference as _InsightRuleReference_d30ddeea,
+    MetricStreamReference as _MetricStreamReference_e417a88f,
+)
 
 
 @jsii.data_type(
@@ -1447,7 +1589,7 @@ class AnomalyDetectionAlarmProps:
                 namespace="AWS/EC2",
                 metric_name="CPUUtilization",
                 statistic="Average",
-                period=Duration.minutes(5)
+                period=Duration.hours(1)
             )
             
             # Create an anomaly detection alarm
@@ -1661,7 +1803,7 @@ class AnomalyDetectionAlarmProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
+@jsii.implements(_IInspectable_c2943556, _IAlarmRef_2bb0e5de, _ITaggableV2_4e6798f8)
 class CfnAlarm(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -1769,7 +1911,8 @@ class CfnAlarm(
         treat_missing_data: typing.Optional[builtins.str] = None,
         unit: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::CloudWatch::Alarm``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param comparison_operator: The arithmetic operation to use when comparing the specified statistic and threshold. The specified statistic value is used as the first operand.
@@ -1826,6 +1969,48 @@ class CfnAlarm(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromAlarmArn")
+    @builtins.classmethod
+    def from_alarm_arn(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        arn: builtins.str,
+    ) -> _IAlarmRef_2bb0e5de:
+        '''Creates a new IAlarmRef from an ARN.
+
+        :param scope: -
+        :param id: -
+        :param arn: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__544b0968def3d9b72962fb1bbce7dec4b2d60b4c2518711cc9df447306ed6c4c)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument arn", value=arn, expected_type=type_hints["arn"])
+        return typing.cast(_IAlarmRef_2bb0e5de, jsii.sinvoke(cls, "fromAlarmArn", [scope, id, arn]))
+
+    @jsii.member(jsii_name="fromAlarmName")
+    @builtins.classmethod
+    def from_alarm_name(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        alarm_name: builtins.str,
+    ) -> _IAlarmRef_2bb0e5de:
+        '''Creates a new IAlarmRef from a alarmName.
+
+        :param scope: -
+        :param id: -
+        :param alarm_name: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__191b683ee20d5f420eb03eb2e0b1a6e0e7cfed31f66a3afa94d14da0767a90f4)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument alarm_name", value=alarm_name, expected_type=type_hints["alarm_name"])
+        return typing.cast(_IAlarmRef_2bb0e5de, jsii.sinvoke(cls, "fromAlarmName", [scope, id, alarm_name]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -1856,6 +2041,12 @@ class CfnAlarm(
         '''The CloudFormation resource type name for this resource class.'''
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
+    @builtins.property
+    @jsii.member(jsii_name="alarmRef")
+    def alarm_ref(self) -> _AlarmReference_76b2c14f:
+        '''A reference to a Alarm resource.'''
+        return typing.cast(_AlarmReference_76b2c14f, jsii.get(self, "alarmRef"))
+
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
@@ -3181,7 +3372,7 @@ class CfnAlarmProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IAnomalyDetectorRef_824aa9dc)
 class CfnAnomalyDetector(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -3277,7 +3468,8 @@ class CfnAnomalyDetector(
         single_metric_anomaly_detector: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnAnomalyDetector.SingleMetricAnomalyDetectorProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         stat: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::CloudWatch::AnomalyDetector``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param configuration: Specifies details about how the anomaly detection model is to be trained, including time ranges to exclude when training and updating the model. The configuration can also include the time zone to use for the metric.
@@ -3336,6 +3528,12 @@ class CfnAnomalyDetector(
         '''The CloudFormation resource type name for this resource class.'''
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
+    @builtins.property
+    @jsii.member(jsii_name="anomalyDetectorRef")
+    def anomaly_detector_ref(self) -> _AnomalyDetectorReference_11b9b19b:
+        '''A reference to a AnomalyDetector resource.'''
+        return typing.cast(_AnomalyDetectorReference_11b9b19b, jsii.get(self, "anomalyDetectorRef"))
+
     @builtins.property
     @jsii.member(jsii_name="attrId")
     def attr_id(self) -> builtins.str:
@@ -4657,7 +4855,7 @@ class CfnAnomalyDetectorProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
+@jsii.implements(_IInspectable_c2943556, _ICompositeAlarmRef_fa51824d, _ITaggableV2_4e6798f8)
 class CfnCompositeAlarm(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -4722,7 +4920,8 @@ class CfnCompositeAlarm(
         ok_actions: typing.Optional[typing.Sequence[builtins.str]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::CloudWatch::CompositeAlarm``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param alarm_rule: An expression that specifies which other alarms are to be evaluated to determine this composite alarm's state. For each alarm that you reference, you designate a function that specifies whether that alarm needs to be in ALARM state, OK state, or INSUFFICIENT_DATA state. You can use operators (AND, OR and NOT) to combine multiple functions in a single expression. You can use parenthesis to logically group the functions in your expression. You can use either alarm names or ARNs to reference the other alarms that are to be evaluated. Functions can include the following: - ALARM("alarm-name or alarm-ARN") is TRUE if the named alarm is in ALARM state. - OK("alarm-name or alarm-ARN") is TRUE if the named alarm is in OK state. - INSUFFICIENT_DATA("alarm-name or alarm-ARN") is TRUE if the named alarm is in INSUFFICIENT_DATA state. - TRUE always evaluates to TRUE. - FALSE always evaluates to FALSE. TRUE and FALSE are useful for testing a complex AlarmRule structure, and for testing your alarm actions. For more information about ``AlarmRule`` syntax, see `PutCompositeAlarm <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutCompositeAlarm.html>`_ in the *Amazon CloudWatch API Reference* .
@@ -4807,6 +5006,12 @@ class CfnCompositeAlarm(
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
         return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.get(self, "cfnProperties"))
 
+    @builtins.property
+    @jsii.member(jsii_name="compositeAlarmRef")
+    def composite_alarm_ref(self) -> _CompositeAlarmReference_bca78bf2:
+        '''A reference to a CompositeAlarm resource.'''
+        return typing.cast(_CompositeAlarmReference_bca78bf2, jsii.get(self, "compositeAlarmRef"))
+
     @builtins.property
     @jsii.member(jsii_name="alarmRule")
     def alarm_rule(self) -> builtins.str:
@@ -5233,7 +5438,7 @@ class CfnCompositeAlarmProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IDashboardRef_3c35946b)
 class CfnDashboard(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -5271,7 +5476,8 @@ class CfnDashboard(
         dashboard_body: builtins.str,
         dashboard_name: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::CloudWatch::Dashboard``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param dashboard_body: The detailed information about the dashboard in JSON format, including the widgets to include and their location on the dashboard. This parameter is required. For more information about the syntax, see `Dashboard Body Structure and Syntax <https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/CloudWatch-Dashboard-Body-Structure.html>`_ .
@@ -5287,6 +5493,27 @@ class CfnDashboard(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromDashboardName")
+    @builtins.classmethod
+    def from_dashboard_name(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        dashboard_name: builtins.str,
+    ) -> _IDashboardRef_3c35946b:
+        '''Creates a new IDashboardRef from a dashboardName.
+
+        :param scope: -
+        :param id: -
+        :param dashboard_name: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__f2a65575230b6782811b6cc1c4a4d1c6cc87f971ef5aa437442cc859d489ff82)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument dashboard_name", value=dashboard_name, expected_type=type_hints["dashboard_name"])
+        return typing.cast(_IDashboardRef_3c35946b, jsii.sinvoke(cls, "fromDashboardName", [scope, id, dashboard_name]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -5322,6 +5549,12 @@ class CfnDashboard(
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
         return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.get(self, "cfnProperties"))
 
+    @builtins.property
+    @jsii.member(jsii_name="dashboardRef")
+    def dashboard_ref(self) -> _DashboardReference_71933abf:
+        '''A reference to a Dashboard resource.'''
+        return typing.cast(_DashboardReference_71933abf, jsii.get(self, "dashboardRef"))
+
     @builtins.property
     @jsii.member(jsii_name="dashboardBody")
     def dashboard_body(self) -> builtins.str:
@@ -5432,7 +5665,7 @@ class CfnDashboardProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _IInsightRuleRef_436d0d73, _ITaggable_36806126)
 class CfnInsightRule(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -5477,13 +5710,14 @@ class CfnInsightRule(
         apply_on_transformed_logs: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::CloudWatch::InsightRule``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param rule_body: The definition of the rule, as a JSON object. For details about the syntax, see `Contributor Insights Rule Syntax <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-RuleSyntax.html>`_ in the *Amazon CloudWatch User Guide* .
         :param rule_name: The name of the rule.
         :param rule_state: The current state of the rule. Valid values are ``ENABLED`` and ``DISABLED`` .
-        :param apply_on_transformed_logs: 
+        :param apply_on_transformed_logs: Determines whether the rules is evaluated on transformed versions of logs. Valid values are ``TRUE`` and ``FALSE`` .
         :param tags: A list of key-value pairs to associate with the Contributor Insights rule. You can associate as many as 50 tags with a rule. Tags can help you organize and categorize your resources. For more information, see `Tagging Your Amazon CloudWatch Resources <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html>`_ . To be able to associate tags with a rule, you must have the ``cloudwatch:TagResource`` permission in addition to the ``cloudwatch:PutInsightRule`` permission.
         '''
         if __debug__:
@@ -5561,6 +5795,12 @@ class CfnInsightRule(
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
         return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.get(self, "cfnProperties"))
 
+    @builtins.property
+    @jsii.member(jsii_name="insightRuleRef")
+    def insight_rule_ref(self) -> _InsightRuleReference_d30ddeea:
+        '''A reference to a InsightRule resource.'''
+        return typing.cast(_InsightRuleReference_d30ddeea, jsii.get(self, "insightRuleRef"))
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> _TagManager_0a598cb3:
@@ -5611,6 +5851,7 @@ class CfnInsightRule(
     def apply_on_transformed_logs(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+        '''Determines whether the rules is evaluated on transformed versions of logs.'''
         return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "applyOnTransformedLogs"))
 
     @apply_on_transformed_logs.setter
@@ -5663,7 +5904,7 @@ class CfnInsightRuleProps:
         :param rule_body: The definition of the rule, as a JSON object. For details about the syntax, see `Contributor Insights Rule Syntax <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-RuleSyntax.html>`_ in the *Amazon CloudWatch User Guide* .
         :param rule_name: The name of the rule.
         :param rule_state: The current state of the rule. Valid values are ``ENABLED`` and ``DISABLED`` .
-        :param apply_on_transformed_logs: 
+        :param apply_on_transformed_logs: Determines whether the rules is evaluated on transformed versions of logs. Valid values are ``TRUE`` and ``FALSE`` .
         :param tags: A list of key-value pairs to associate with the Contributor Insights rule. You can associate as many as 50 tags with a rule. Tags can help you organize and categorize your resources. For more information, see `Tagging Your Amazon CloudWatch Resources <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html>`_ . To be able to associate tags with a rule, you must have the ``cloudwatch:TagResource`` permission in addition to the ``cloudwatch:PutInsightRule`` permission.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-insightrule.html
@@ -5743,7 +5984,10 @@ class CfnInsightRuleProps:
     def apply_on_transformed_logs(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-        '''
+        '''Determines whether the rules is evaluated on transformed versions of logs.
+
+        Valid values are ``TRUE`` and ``FALSE`` .
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudwatch-insightrule.html#cfn-cloudwatch-insightrule-applyontransformedlogs
         '''
         result = self._values.get("apply_on_transformed_logs")
@@ -5776,7 +6020,7 @@ class CfnInsightRuleProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _IMetricStreamRef_2c784fc6, _ITaggable_36806126)
 class CfnMetricStream(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -5857,7 +6101,8 @@ class CfnMetricStream(
         statistics_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnMetricStream.MetricStreamStatisticsConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::CloudWatch::MetricStream``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param firehose_arn: The ARN of the Amazon Kinesis Firehose delivery stream to use for this metric stream. This Amazon Kinesis Firehose delivery stream must already exist and must be in the same account as the metric stream.
@@ -5888,6 +6133,48 @@ class CfnMetricStream(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromMetricStreamArn")
+    @builtins.classmethod
+    def from_metric_stream_arn(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        arn: builtins.str,
+    ) -> _IMetricStreamRef_2c784fc6:
+        '''Creates a new IMetricStreamRef from an ARN.
+
+        :param scope: -
+        :param id: -
+        :param arn: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__50e36a4aae3592a141f72295c65ce2cf6f01c0153925f610e589758abcc065e2)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument arn", value=arn, expected_type=type_hints["arn"])
+        return typing.cast(_IMetricStreamRef_2c784fc6, jsii.sinvoke(cls, "fromMetricStreamArn", [scope, id, arn]))
+
+    @jsii.member(jsii_name="fromMetricStreamName")
+    @builtins.classmethod
+    def from_metric_stream_name(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        metric_stream_name: builtins.str,
+    ) -> _IMetricStreamRef_2c784fc6:
+        '''Creates a new IMetricStreamRef from a metricStreamName.
+
+        :param scope: -
+        :param id: -
+        :param metric_stream_name: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__635a32b621fbf5f4f1c0d44f6749043dfa44bfb3ec257d8fe8a02439751244c1)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument metric_stream_name", value=metric_stream_name, expected_type=type_hints["metric_stream_name"])
+        return typing.cast(_IMetricStreamRef_2c784fc6, jsii.sinvoke(cls, "fromMetricStreamName", [scope, id, metric_stream_name]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -5959,6 +6246,12 @@ class CfnMetricStream(
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
         return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.get(self, "cfnProperties"))
 
+    @builtins.property
+    @jsii.member(jsii_name="metricStreamRef")
+    def metric_stream_ref(self) -> _MetricStreamReference_e417a88f:
+        '''A reference to a MetricStream resource.'''
+        return typing.cast(_MetricStreamReference_e417a88f, jsii.get(self, "metricStreamRef"))
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> _TagManager_0a598cb3:
@@ -6658,6 +6951,7 @@ class Color(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Color
         "account": "account",
         "color": "color",
         "dimensions_map": "dimensionsMap",
+        "id": "id",
         "label": "label",
         "period": "period",
         "region": "region",
@@ -6665,6 +6959,7 @@ class Color(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Color
         "stack_region": "stackRegion",
         "statistic": "statistic",
         "unit": "unit",
+        "visible": "visible",
     },
 )
 class CommonMetricOptions:
@@ -6674,6 +6969,7 @@ class CommonMetricOptions:
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -6681,12 +6977,14 @@ class CommonMetricOptions:
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional["Unit"] = None,
+        visible: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''Options shared by most methods accepting metric options.
 
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -6694,6 +6992,7 @@ class CommonMetricOptions:
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
         :exampleMetadata: fixture=_generated
 
@@ -6710,13 +7009,15 @@ class CommonMetricOptions:
                 dimensions_map={
                     "dimensions_map_key": "dimensionsMap"
                 },
+                id="id",
                 label="label",
                 period=cdk.Duration.minutes(30),
                 region="region",
                 stack_account="stackAccount",
                 stack_region="stackRegion",
                 statistic="statistic",
-                unit=cloudwatch.Unit.SECONDS
+                unit=cloudwatch.Unit.SECONDS,
+                visible=False
             )
         '''
         if __debug__:
@@ -6724,6 +7025,7 @@ class CommonMetricOptions:
             check_type(argname="argument account", value=account, expected_type=type_hints["account"])
             check_type(argname="argument color", value=color, expected_type=type_hints["color"])
             check_type(argname="argument dimensions_map", value=dimensions_map, expected_type=type_hints["dimensions_map"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
             check_type(argname="argument label", value=label, expected_type=type_hints["label"])
             check_type(argname="argument period", value=period, expected_type=type_hints["period"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
@@ -6731,6 +7033,7 @@ class CommonMetricOptions:
             check_type(argname="argument stack_region", value=stack_region, expected_type=type_hints["stack_region"])
             check_type(argname="argument statistic", value=statistic, expected_type=type_hints["statistic"])
             check_type(argname="argument unit", value=unit, expected_type=type_hints["unit"])
+            check_type(argname="argument visible", value=visible, expected_type=type_hints["visible"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if account is not None:
             self._values["account"] = account
@@ -6738,6 +7041,8 @@ class CommonMetricOptions:
             self._values["color"] = color
         if dimensions_map is not None:
             self._values["dimensions_map"] = dimensions_map
+        if id is not None:
+            self._values["id"] = id
         if label is not None:
             self._values["label"] = label
         if period is not None:
@@ -6752,6 +7057,8 @@ class CommonMetricOptions:
             self._values["statistic"] = statistic
         if unit is not None:
             self._values["unit"] = unit
+        if visible is not None:
+            self._values["visible"] = visible
 
     @builtins.property
     def account(self) -> typing.Optional[builtins.str]:
@@ -6782,6 +7089,19 @@ class CommonMetricOptions:
         result = self._values.get("dimensions_map")
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], result)
 
+    @builtins.property
+    def id(self) -> typing.Optional[builtins.str]:
+        '''Unique identifier for this metric when used in dashboard widgets.
+
+        The id can be used as a variable to represent this metric in math expressions.
+        Valid characters are letters, numbers, and underscore. The first character
+        must be a lowercase letter.
+
+        :default: - No ID
+        '''
+        result = self._values.get("id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def label(self) -> typing.Optional[builtins.str]:
         '''Label for this metric when added to a Graph in a Dashboard.
@@ -6879,6 +7199,18 @@ class CommonMetricOptions:
         result = self._values.get("unit")
         return typing.cast(typing.Optional["Unit"], result)
 
+    @builtins.property
+    def visible(self) -> typing.Optional[builtins.bool]:
+        '''Whether this metric should be visible in dashboard graphs.
+
+        Setting this to false is useful when you want to hide raw metrics
+        that are used in math expressions, and show only the expression results.
+
+        :default: true
+        '''
+        result = self._values.get("visible")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -8488,6 +8820,33 @@ class LegendPosition(enum.Enum):
     '''Add shading below the annotation.'''
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_cloudwatch.LogQueryLanguage")
+class LogQueryLanguage(enum.Enum):
+    '''Logs Query Language.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # dashboard: cloudwatch.Dashboard
+        
+        
+        dashboard.add_widgets(cloudwatch.LogQueryWidget(
+            log_group_names=["my-log-group"],
+            view=cloudwatch.LogQueryVisualizationType.TABLE,
+            query_string="SELECT count(*) as count FROM 'my-log-group'",
+            query_language=cloudwatch.LogQueryLanguage.SQL
+        ))
+    '''
+
+    LOGS_INSIGHTS = "LOGS_INSIGHTS"
+    '''Logs Insights QL.'''
+    SQL = "SQL"
+    '''OpenSearch SQL.'''
+    PPL = "PPL"
+    '''OpenSearch PPL.'''
+
+
 @jsii.enum(jsii_type="aws-cdk-lib.aws_cloudwatch.LogQueryVisualizationType")
 class LogQueryVisualizationType(enum.Enum):
     '''Types of view.
@@ -8525,7 +8884,9 @@ class LogQueryVisualizationType(enum.Enum):
     jsii_struct_bases=[],
     name_mapping={
         "log_group_names": "logGroupNames",
+        "account_id": "accountId",
         "height": "height",
+        "query_language": "queryLanguage",
         "query_lines": "queryLines",
         "query_string": "queryString",
         "region": "region",
@@ -8539,7 +8900,9 @@ class LogQueryWidgetProps:
         self,
         *,
         log_group_names: typing.Sequence[builtins.str],
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
+        query_language: typing.Optional[LogQueryLanguage] = None,
         query_lines: typing.Optional[typing.Sequence[builtins.str]] = None,
         query_string: typing.Optional[builtins.str] = None,
         region: typing.Optional[builtins.str] = None,
@@ -8550,7 +8913,9 @@ class LogQueryWidgetProps:
         '''Properties for a Query widget.
 
         :param log_group_names: Names of log groups to query.
+        :param account_id: The AWS account ID where the log groups are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: 6
+        :param query_language: The query language to use for the query. Default: LogQueryLanguage.LOGS_INSIGHTS
         :param query_lines: A sequence of lines to use to build the query. The query will be built by joining the lines together using ``\\n|``. Default: - Exactly one of ``queryString``, ``queryLines`` is required.
         :param query_string: Full query string for log insights. Be sure to prepend every new line with a newline and pipe character (``\\n|``). Default: - Exactly one of ``queryString``, ``queryLines`` is required.
         :param region: The region the metrics of this widget should be taken from. Default: Current region
@@ -8576,7 +8941,9 @@ class LogQueryWidgetProps:
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b7d4a308b1274696259a35b14b5ae833f34881f95eaba521bb47a74b3a80e8c0)
             check_type(argname="argument log_group_names", value=log_group_names, expected_type=type_hints["log_group_names"])
+            check_type(argname="argument account_id", value=account_id, expected_type=type_hints["account_id"])
             check_type(argname="argument height", value=height, expected_type=type_hints["height"])
+            check_type(argname="argument query_language", value=query_language, expected_type=type_hints["query_language"])
             check_type(argname="argument query_lines", value=query_lines, expected_type=type_hints["query_lines"])
             check_type(argname="argument query_string", value=query_string, expected_type=type_hints["query_string"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
@@ -8586,8 +8953,12 @@ class LogQueryWidgetProps:
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "log_group_names": log_group_names,
         }
+        if account_id is not None:
+            self._values["account_id"] = account_id
         if height is not None:
             self._values["height"] = height
+        if query_language is not None:
+            self._values["query_language"] = query_language
         if query_lines is not None:
             self._values["query_lines"] = query_lines
         if query_string is not None:
@@ -8608,6 +8979,22 @@ class LogQueryWidgetProps:
         assert result is not None, "Required property 'log_group_names' is missing"
         return typing.cast(typing.List[builtins.str], result)
 
+    @builtins.property
+    def account_id(self) -> typing.Optional[builtins.str]:
+        '''The AWS account ID where the log groups are located.
+
+        This enables cross-account functionality for CloudWatch dashboards.
+        Before using this feature, ensure that proper cross-account sharing is configured
+        between the monitoring account and source account.
+
+        For more information, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+
+        :default: - Current account
+        '''
+        result = self._values.get("account_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
         '''Height of the widget.
@@ -8617,6 +9004,15 @@ class LogQueryWidgetProps:
         result = self._values.get("height")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def query_language(self) -> typing.Optional[LogQueryLanguage]:
+        '''The query language to use for the query.
+
+        :default: LogQueryLanguage.LOGS_INSIGHTS
+        '''
+        result = self._values.get("query_language")
+        return typing.cast(typing.Optional[LogQueryLanguage], result)
+
     @builtins.property
     def query_lines(self) -> typing.Optional[typing.List[builtins.str]]:
         '''A sequence of lines to use to build the query.
@@ -8745,7 +9141,7 @@ class MathExpression(
         :param using_metrics: The metrics used in the expression, in a map. The key is the identifier that represents the given metric in the expression, and the value is the actual Metric object. The ``period`` of each metric in ``usingMetrics`` is ignored and instead overridden by the ``period`` specified for the ``MathExpression`` construct. Even if no ``period`` is specified for the ``MathExpression``, it will be overridden by the default value (``Duration.minutes(5)``). Example:: declare const metrics: elbv2.IApplicationLoadBalancerMetrics; new cloudwatch.MathExpression({ expression: 'm1+m2', label: 'AlbErrors', usingMetrics: { m1: metrics.custom('HTTPCode_ELB_500_Count', { period: Duration.minutes(1), // <- This period will be ignored statistic: 'Sum', label: 'HTTPCode_ELB_500_Count', }), m2: metrics.custom('HTTPCode_ELB_502_Count', { period: Duration.minutes(1), // <- This period will be ignored statistic: 'Sum', label: 'HTTPCode_ELB_502_Count', }), }, period: Duration.minutes(3), // <- This overrides the period of each metric in `usingMetrics` // (Even if not specified, it is overridden by the default value) }); Default: - Empty map.
         :param color: Color for this metric when added to a Graph in a Dashboard. Default: - Automatic color
         :param label: Label for this expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series (for example, through the use of ``METRICS()`` or ``SEARCH()`` expressions), each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the math expression produces more than one time series, the maximum will be shown for each individual time series produce by this math expression. Default: - Expression value is used as label
-        :param period: The period over which the expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
+        :param period: The period over which the math expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
         :param search_account: Account to evaluate search expressions within. Specifying a searchAccount has no effect to the account used for metrics within the expression (passed via usingMetrics). Default: - Deployment account.
         :param search_region: Region to evaluate search expressions within. Specifying a searchRegion has no effect to the region used for metrics within the expression (passed via usingMetrics). Default: - Deployment region.
         '''
@@ -8838,7 +9234,7 @@ class MathExpression(
 
         :param color: Color for this metric when added to a Graph in a Dashboard. Default: - Automatic color
         :param label: Label for this expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series (for example, through the use of ``METRICS()`` or ``SEARCH()`` expressions), each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the math expression produces more than one time series, the maximum will be shown for each individual time series produce by this math expression. Default: - Expression value is used as label
-        :param period: The period over which the expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
+        :param period: The period over which the math expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
         :param search_account: Account to evaluate search expressions within. Specifying a searchAccount has no effect to the account used for metrics within the expression (passed via usingMetrics). Default: - Deployment account.
         :param search_region: Region to evaluate search expressions within. Specifying a searchRegion has no effect to the region used for metrics within the expression (passed via usingMetrics). Default: - Deployment region.
         '''
@@ -8939,7 +9335,7 @@ class MathExpressionOptions:
 
         :param color: Color for this metric when added to a Graph in a Dashboard. Default: - Automatic color
         :param label: Label for this expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series (for example, through the use of ``METRICS()`` or ``SEARCH()`` expressions), each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the math expression produces more than one time series, the maximum will be shown for each individual time series produce by this math expression. Default: - Expression value is used as label
-        :param period: The period over which the expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
+        :param period: The period over which the math expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
         :param search_account: Account to evaluate search expressions within. Specifying a searchAccount has no effect to the account used for metrics within the expression (passed via usingMetrics). Default: - Deployment account.
         :param search_region: Region to evaluate search expressions within. Specifying a searchRegion has no effect to the region used for metrics within the expression (passed via usingMetrics). Default: - Deployment region.
 
@@ -9018,7 +9414,7 @@ class MathExpressionOptions:
 
     @builtins.property
     def period(self) -> typing.Optional[_Duration_4839e8c3]:
-        '''The period over which the expression's statistics are applied.
+        '''The period over which the math expression's statistics are applied.
 
         This period overrides all periods in the metrics used in this
         math expression.
@@ -9093,7 +9489,7 @@ class MathExpressionProps(MathExpressionOptions):
 
         :param color: Color for this metric when added to a Graph in a Dashboard. Default: - Automatic color
         :param label: Label for this expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series (for example, through the use of ``METRICS()`` or ``SEARCH()`` expressions), each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the math expression produces more than one time series, the maximum will be shown for each individual time series produce by this math expression. Default: - Expression value is used as label
-        :param period: The period over which the expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
+        :param period: The period over which the math expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
         :param search_account: Account to evaluate search expressions within. Specifying a searchAccount has no effect to the account used for metrics within the expression (passed via usingMetrics). Default: - Deployment account.
         :param search_region: Region to evaluate search expressions within. Specifying a searchRegion has no effect to the region used for metrics within the expression (passed via usingMetrics). Default: - Deployment region.
         :param expression: The expression defining the metric. When an expression contains a SEARCH function, it cannot be used within an Alarm.
@@ -9183,7 +9579,7 @@ class MathExpressionProps(MathExpressionOptions):
 
     @builtins.property
     def period(self) -> typing.Optional[_Duration_4839e8c3]:
-        '''The period over which the expression's statistics are applied.
+        '''The period over which the math expression's statistics are applied.
 
         This period overrides all periods in the metrics used in this
         math expression.
@@ -9303,7 +9699,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
             namespace="AWS/EC2",
             metric_name="CPUUtilization",
             statistic="Average",
-            period=Duration.minutes(5)
+            period=Duration.hours(1)
         )
         
         # Create an anomaly detection alarm
@@ -9327,6 +9723,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -9334,6 +9731,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional["Unit"] = None,
+        visible: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''
         :param metric_name: Name of the metric.
@@ -9341,6 +9739,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -9348,6 +9747,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
         '''
         props = MetricProps(
             metric_name=metric_name,
@@ -9355,6 +9755,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
             account=account,
             color=color,
             dimensions_map=dimensions_map,
+            id=id,
             label=label,
             period=period,
             region=region,
@@ -9362,6 +9763,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
             stack_region=stack_region,
             statistic=statistic,
             unit=unit,
+            visible=visible,
         )
 
         jsii.create(self.__class__, self, [props])
@@ -9385,7 +9787,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         :param std_devs: The number of standard deviations to use for the anomaly detection band. The higher the value, the wider the band. - Must be greater than 0. A value of 0 or negative values would not make sense in the context of calculating standard deviations. - There is no strict maximum value defined, as standard deviations can theoretically extend infinitely. However, in practice, values beyond 5 or 6 standard deviations are rarely used, as they would result in an extremely wide anomaly detection band, potentially missing significant anomalies. Default: 2
         :param color: Color for this metric when added to a Graph in a Dashboard. Default: - Automatic color
         :param label: Label for this expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series (for example, through the use of ``METRICS()`` or ``SEARCH()`` expressions), each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the math expression produces more than one time series, the maximum will be shown for each individual time series produce by this math expression. Default: - Expression value is used as label
-        :param period: The period over which the expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
+        :param period: The period over which the math expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
         :param search_account: Account to evaluate search expressions within. Specifying a searchAccount has no effect to the account used for metrics within the expression (passed via usingMetrics). Default: - Deployment account.
         :param search_region: Region to evaluate search expressions within. Specifying a searchRegion has no effect to the region used for metrics within the expression (passed via usingMetrics). Default: - Deployment region.
 
@@ -9503,6 +9905,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -9510,6 +9913,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional["Unit"] = None,
+        visible: typing.Optional[builtins.bool] = None,
     ) -> "Metric":
         '''Return a copy of Metric ``with`` properties changed.
 
@@ -9518,6 +9922,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -9525,11 +9930,13 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
         '''
         props = MetricOptions(
             account=account,
             color=color,
             dimensions_map=dimensions_map,
+            id=id,
             label=label,
             period=period,
             region=region,
@@ -9537,6 +9944,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
             stack_region=stack_region,
             statistic=statistic,
             unit=unit,
+            visible=visible,
         )
 
         return typing.cast("Metric", jsii.invoke(self, "with", [props]))
@@ -9583,6 +9991,12 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         '''Dimensions of this metric.'''
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, typing.Any]], jsii.get(self, "dimensions"))
 
+    @builtins.property
+    @jsii.member(jsii_name="id")
+    def id(self) -> typing.Optional[builtins.str]:
+        '''Unique identifier for this metric when used in dashboard widgets.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "id"))
+
     @builtins.property
     @jsii.member(jsii_name="label")
     def label(self) -> typing.Optional[builtins.str]:
@@ -9601,6 +10015,12 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         '''Unit of the metric.'''
         return typing.cast(typing.Optional["Unit"], jsii.get(self, "unit"))
 
+    @builtins.property
+    @jsii.member(jsii_name="visible")
+    def visible(self) -> typing.Optional[builtins.bool]:
+        '''Whether this metric should be visible in dashboard graphs.'''
+        return typing.cast(typing.Optional[builtins.bool], jsii.get(self, "visible"))
+
     @builtins.property
     @jsii.member(jsii_name="warnings")
     def warnings(self) -> typing.Optional[typing.List[builtins.str]]:
@@ -9628,6 +10048,7 @@ class Metric(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_cloudwatch.Metr
         "math_expression": "mathExpression",
         "metric_stat": "metricStat",
         "rendering_properties": "renderingProperties",
+        "search_expression": "searchExpression",
     },
 )
 class MetricConfig:
@@ -9637,12 +10058,14 @@ class MetricConfig:
         math_expression: typing.Optional[typing.Union["MetricExpressionConfig", typing.Dict[builtins.str, typing.Any]]] = None,
         metric_stat: typing.Optional[typing.Union["MetricStatConfig", typing.Dict[builtins.str, typing.Any]]] = None,
         rendering_properties: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
+        search_expression: typing.Optional[typing.Union["MetricExpressionConfig", typing.Dict[builtins.str, typing.Any]]] = None,
     ) -> None:
         '''Properties of a rendered metric.
 
         :param math_expression: In case the metric is a math expression, the details of the math expression. Default: - None
         :param metric_stat: In case the metric represents a query, the details of the query. Default: - None
         :param rendering_properties: Additional properties which will be rendered if the metric is used in a dashboard. Examples are 'label' and 'color', but any key in here will be added to dashboard graphs. Default: - None
+        :param search_expression: In case the metric is a search expression, the details of the search expression. Default: - None
 
         :exampleMetadata: fixture=_generated
 
@@ -9688,18 +10111,32 @@ class MetricConfig:
                 ),
                 rendering_properties={
                     "rendering_properties_key": rendering_properties
-                }
+                },
+                search_expression=cloudwatch.MetricExpressionConfig(
+                    expression="expression",
+                    period=123,
+                    using_metrics={
+                        "using_metrics_key": metric
+                    },
+            
+                    # the properties below are optional
+                    search_account="searchAccount",
+                    search_region="searchRegion"
+                )
             )
         '''
         if isinstance(math_expression, dict):
             math_expression = MetricExpressionConfig(**math_expression)
         if isinstance(metric_stat, dict):
             metric_stat = MetricStatConfig(**metric_stat)
+        if isinstance(search_expression, dict):
+            search_expression = MetricExpressionConfig(**search_expression)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__2ddb584abe8421d7f77520aa621133794d500e179ff044f43970dac3fd018cca)
             check_type(argname="argument math_expression", value=math_expression, expected_type=type_hints["math_expression"])
             check_type(argname="argument metric_stat", value=metric_stat, expected_type=type_hints["metric_stat"])
             check_type(argname="argument rendering_properties", value=rendering_properties, expected_type=type_hints["rendering_properties"])
+            check_type(argname="argument search_expression", value=search_expression, expected_type=type_hints["search_expression"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if math_expression is not None:
             self._values["math_expression"] = math_expression
@@ -9707,6 +10144,8 @@ class MetricConfig:
             self._values["metric_stat"] = metric_stat
         if rendering_properties is not None:
             self._values["rendering_properties"] = rendering_properties
+        if search_expression is not None:
+            self._values["search_expression"] = search_expression
 
     @builtins.property
     def math_expression(self) -> typing.Optional["MetricExpressionConfig"]:
@@ -9740,6 +10179,15 @@ class MetricConfig:
         result = self._values.get("rendering_properties")
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, typing.Any]], result)
 
+    @builtins.property
+    def search_expression(self) -> typing.Optional["MetricExpressionConfig"]:
+        '''In case the metric is a search expression, the details of the search expression.
+
+        :default: - None
+        '''
+        result = self._values.get("search_expression")
+        return typing.cast(typing.Optional["MetricExpressionConfig"], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -9878,6 +10326,7 @@ class MetricExpressionConfig:
         "account": "account",
         "color": "color",
         "dimensions_map": "dimensionsMap",
+        "id": "id",
         "label": "label",
         "period": "period",
         "region": "region",
@@ -9885,6 +10334,7 @@ class MetricExpressionConfig:
         "stack_region": "stackRegion",
         "statistic": "statistic",
         "unit": "unit",
+        "visible": "visible",
     },
 )
 class MetricOptions(CommonMetricOptions):
@@ -9894,6 +10344,7 @@ class MetricOptions(CommonMetricOptions):
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -9901,12 +10352,14 @@ class MetricOptions(CommonMetricOptions):
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional["Unit"] = None,
+        visible: typing.Optional[builtins.bool] = None,
     ) -> None:
         '''Properties of a metric that can be changed.
 
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -9914,6 +10367,7 @@ class MetricOptions(CommonMetricOptions):
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
         :exampleMetadata: infused
 
@@ -9944,6 +10398,7 @@ class MetricOptions(CommonMetricOptions):
             check_type(argname="argument account", value=account, expected_type=type_hints["account"])
             check_type(argname="argument color", value=color, expected_type=type_hints["color"])
             check_type(argname="argument dimensions_map", value=dimensions_map, expected_type=type_hints["dimensions_map"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
             check_type(argname="argument label", value=label, expected_type=type_hints["label"])
             check_type(argname="argument period", value=period, expected_type=type_hints["period"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
@@ -9951,6 +10406,7 @@ class MetricOptions(CommonMetricOptions):
             check_type(argname="argument stack_region", value=stack_region, expected_type=type_hints["stack_region"])
             check_type(argname="argument statistic", value=statistic, expected_type=type_hints["statistic"])
             check_type(argname="argument unit", value=unit, expected_type=type_hints["unit"])
+            check_type(argname="argument visible", value=visible, expected_type=type_hints["visible"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if account is not None:
             self._values["account"] = account
@@ -9958,6 +10414,8 @@ class MetricOptions(CommonMetricOptions):
             self._values["color"] = color
         if dimensions_map is not None:
             self._values["dimensions_map"] = dimensions_map
+        if id is not None:
+            self._values["id"] = id
         if label is not None:
             self._values["label"] = label
         if period is not None:
@@ -9972,6 +10430,8 @@ class MetricOptions(CommonMetricOptions):
             self._values["statistic"] = statistic
         if unit is not None:
             self._values["unit"] = unit
+        if visible is not None:
+            self._values["visible"] = visible
 
     @builtins.property
     def account(self) -> typing.Optional[builtins.str]:
@@ -10002,6 +10462,19 @@ class MetricOptions(CommonMetricOptions):
         result = self._values.get("dimensions_map")
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], result)
 
+    @builtins.property
+    def id(self) -> typing.Optional[builtins.str]:
+        '''Unique identifier for this metric when used in dashboard widgets.
+
+        The id can be used as a variable to represent this metric in math expressions.
+        Valid characters are letters, numbers, and underscore. The first character
+        must be a lowercase letter.
+
+        :default: - No ID
+        '''
+        result = self._values.get("id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def label(self) -> typing.Optional[builtins.str]:
         '''Label for this metric when added to a Graph in a Dashboard.
@@ -10099,6 +10572,18 @@ class MetricOptions(CommonMetricOptions):
         result = self._values.get("unit")
         return typing.cast(typing.Optional["Unit"], result)
 
+    @builtins.property
+    def visible(self) -> typing.Optional[builtins.bool]:
+        '''Whether this metric should be visible in dashboard graphs.
+
+        Setting this to false is useful when you want to hide raw metrics
+        that are used in math expressions, and show only the expression results.
+
+        :default: true
+        '''
+        result = self._values.get("visible")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -10118,6 +10603,7 @@ class MetricOptions(CommonMetricOptions):
         "account": "account",
         "color": "color",
         "dimensions_map": "dimensionsMap",
+        "id": "id",
         "label": "label",
         "period": "period",
         "region": "region",
@@ -10125,6 +10611,7 @@ class MetricOptions(CommonMetricOptions):
         "stack_region": "stackRegion",
         "statistic": "statistic",
         "unit": "unit",
+        "visible": "visible",
         "metric_name": "metricName",
         "namespace": "namespace",
     },
@@ -10136,6 +10623,7 @@ class MetricProps(CommonMetricOptions):
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -10143,6 +10631,7 @@ class MetricProps(CommonMetricOptions):
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional["Unit"] = None,
+        visible: typing.Optional[builtins.bool] = None,
         metric_name: builtins.str,
         namespace: builtins.str,
     ) -> None:
@@ -10151,6 +10640,7 @@ class MetricProps(CommonMetricOptions):
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -10158,6 +10648,7 @@ class MetricProps(CommonMetricOptions):
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
         :param metric_name: Name of the metric.
         :param namespace: Namespace of the metric.
 
@@ -10170,7 +10661,7 @@ class MetricProps(CommonMetricOptions):
                 namespace="AWS/EC2",
                 metric_name="CPUUtilization",
                 statistic="Average",
-                period=Duration.minutes(5)
+                period=Duration.hours(1)
             )
             
             # Create an anomaly detection alarm
@@ -10190,6 +10681,7 @@ class MetricProps(CommonMetricOptions):
             check_type(argname="argument account", value=account, expected_type=type_hints["account"])
             check_type(argname="argument color", value=color, expected_type=type_hints["color"])
             check_type(argname="argument dimensions_map", value=dimensions_map, expected_type=type_hints["dimensions_map"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
             check_type(argname="argument label", value=label, expected_type=type_hints["label"])
             check_type(argname="argument period", value=period, expected_type=type_hints["period"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
@@ -10197,6 +10689,7 @@ class MetricProps(CommonMetricOptions):
             check_type(argname="argument stack_region", value=stack_region, expected_type=type_hints["stack_region"])
             check_type(argname="argument statistic", value=statistic, expected_type=type_hints["statistic"])
             check_type(argname="argument unit", value=unit, expected_type=type_hints["unit"])
+            check_type(argname="argument visible", value=visible, expected_type=type_hints["visible"])
             check_type(argname="argument metric_name", value=metric_name, expected_type=type_hints["metric_name"])
             check_type(argname="argument namespace", value=namespace, expected_type=type_hints["namespace"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
@@ -10209,6 +10702,8 @@ class MetricProps(CommonMetricOptions):
             self._values["color"] = color
         if dimensions_map is not None:
             self._values["dimensions_map"] = dimensions_map
+        if id is not None:
+            self._values["id"] = id
         if label is not None:
             self._values["label"] = label
         if period is not None:
@@ -10223,6 +10718,8 @@ class MetricProps(CommonMetricOptions):
             self._values["statistic"] = statistic
         if unit is not None:
             self._values["unit"] = unit
+        if visible is not None:
+            self._values["visible"] = visible
 
     @builtins.property
     def account(self) -> typing.Optional[builtins.str]:
@@ -10253,6 +10750,19 @@ class MetricProps(CommonMetricOptions):
         result = self._values.get("dimensions_map")
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], result)
 
+    @builtins.property
+    def id(self) -> typing.Optional[builtins.str]:
+        '''Unique identifier for this metric when used in dashboard widgets.
+
+        The id can be used as a variable to represent this metric in math expressions.
+        Valid characters are letters, numbers, and underscore. The first character
+        must be a lowercase letter.
+
+        :default: - No ID
+        '''
+        result = self._values.get("id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def label(self) -> typing.Optional[builtins.str]:
         '''Label for this metric when added to a Graph in a Dashboard.
@@ -10350,6 +10860,18 @@ class MetricProps(CommonMetricOptions):
         result = self._values.get("unit")
         return typing.cast(typing.Optional["Unit"], result)
 
+    @builtins.property
+    def visible(self) -> typing.Optional[builtins.bool]:
+        '''Whether this metric should be visible in dashboard graphs.
+
+        Setting this to false is useful when you want to hide raw metrics
+        that are used in math expressions, and show only the expression results.
+
+        :default: true
+        '''
+        result = self._values.get("visible")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def metric_name(self) -> builtins.str:
         '''Name of the metric.'''
@@ -10588,6 +11110,7 @@ class MetricStatConfig:
     jsii_type="aws-cdk-lib.aws_cloudwatch.MetricWidgetProps",
     jsii_struct_bases=[],
     name_mapping={
+        "account_id": "accountId",
         "height": "height",
         "region": "region",
         "title": "title",
@@ -10598,6 +11121,7 @@ class MetricWidgetProps:
     def __init__(
         self,
         *,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -10605,6 +11129,7 @@ class MetricWidgetProps:
     ) -> None:
         '''Basic properties for widgets that display metrics.
 
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -10619,6 +11144,7 @@ class MetricWidgetProps:
             from aws_cdk import aws_cloudwatch as cloudwatch
             
             metric_widget_props = cloudwatch.MetricWidgetProps(
+                account_id="accountId",
                 height=123,
                 region="region",
                 title="title",
@@ -10627,11 +11153,14 @@ class MetricWidgetProps:
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__028d2c6eccbbf06b74566403b038cac0cdc1c8588c939f4352cc861885b12c38)
+            check_type(argname="argument account_id", value=account_id, expected_type=type_hints["account_id"])
             check_type(argname="argument height", value=height, expected_type=type_hints["height"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
             check_type(argname="argument width", value=width, expected_type=type_hints["width"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if account_id is not None:
+            self._values["account_id"] = account_id
         if height is not None:
             self._values["height"] = height
         if region is not None:
@@ -10641,6 +11170,22 @@ class MetricWidgetProps:
         if width is not None:
             self._values["width"] = width
 
+    @builtins.property
+    def account_id(self) -> typing.Optional[builtins.str]:
+        '''The AWS account ID where the metrics are located.
+
+        This enables cross-account functionality for CloudWatch dashboards.
+        Before using this feature, ensure that proper cross-account sharing is configured
+        between the monitoring account and source account.
+
+        For more information, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+
+        :default: - Current account
+        '''
+        result = self._values.get("account_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
         '''Height of the widget.
@@ -10797,77 +11342,546 @@ class SearchComponents:
     ) -> None:
         '''Search components for use with {@link Values.fromSearchComponents}.
 
-        :param dimensions: The list of dimensions to be used in the search expression.
-        :param metric_name: The metric name to be used in the search expression.
-        :param namespace: The namespace to be used in the search expression.
-        :param populate_from: The dimension name, that the search expression retrieves, whose values will be used to populate the values to choose from.
+        :param dimensions: The list of dimensions to be used in the search expression.
+        :param metric_name: The metric name to be used in the search expression.
+        :param namespace: The namespace to be used in the search expression.
+        :param populate_from: The dimension name, that the search expression retrieves, whose values will be used to populate the values to choose from.
+
+        :exampleMetadata: infused
+
+        Example::
+
+            import aws_cdk.aws_cloudwatch as cw
+            
+            
+            dashboard = cw.Dashboard(self, "Dash",
+                default_interval=Duration.days(7),
+                variables=[cw.DashboardVariable(
+                    id="functionName",
+                    type=cw.VariableType.PATTERN,
+                    label="Function",
+                    input_type=cw.VariableInputType.RADIO,
+                    value="originalFuncNameInDashboard",
+                    # equivalent to cw.Values.fromSearch('{AWS/Lambda,FunctionName} MetricName=\"Duration\"', 'FunctionName')
+                    values=cw.Values.from_search_components(
+                        namespace="AWS/Lambda",
+                        dimensions=["FunctionName"],
+                        metric_name="Duration",
+                        populate_from="FunctionName"
+                    ),
+                    default_value=cw.DefaultValue.FIRST,
+                    visible=True
+                )]
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__834c69a269555056b1b73146ff2784af68174eb591f39133c585607049d7afe7)
+            check_type(argname="argument dimensions", value=dimensions, expected_type=type_hints["dimensions"])
+            check_type(argname="argument metric_name", value=metric_name, expected_type=type_hints["metric_name"])
+            check_type(argname="argument namespace", value=namespace, expected_type=type_hints["namespace"])
+            check_type(argname="argument populate_from", value=populate_from, expected_type=type_hints["populate_from"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "dimensions": dimensions,
+            "metric_name": metric_name,
+            "namespace": namespace,
+            "populate_from": populate_from,
+        }
+
+    @builtins.property
+    def dimensions(self) -> typing.List[builtins.str]:
+        '''The list of dimensions to be used in the search expression.'''
+        result = self._values.get("dimensions")
+        assert result is not None, "Required property 'dimensions' is missing"
+        return typing.cast(typing.List[builtins.str], result)
+
+    @builtins.property
+    def metric_name(self) -> builtins.str:
+        '''The metric name to be used in the search expression.'''
+        result = self._values.get("metric_name")
+        assert result is not None, "Required property 'metric_name' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def namespace(self) -> builtins.str:
+        '''The namespace to be used in the search expression.'''
+        result = self._values.get("namespace")
+        assert result is not None, "Required property 'namespace' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def populate_from(self) -> builtins.str:
+        '''The dimension name, that the search expression retrieves, whose values will be used to populate the values to choose from.'''
+        result = self._values.get("populate_from")
+        assert result is not None, "Required property 'populate_from' is missing"
+        return typing.cast(builtins.str, result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "SearchComponents(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.implements(IMetric)
+class SearchExpression(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_cloudwatch.SearchExpression",
+):
+    '''A CloudWatch search expression for dynamically finding and graphing multiple related metrics.
+
+    Search expressions allow you to search for and graph multiple related metrics from a single expression.
+    This is particularly useful in dynamic environments where the exact metric names or dimensions
+    may not be known at deployment time.
+
+    Example::
+
+       search_expression = cloudwatch.SearchExpression(
+           expression="SEARCH('{AWS/EC2,InstanceId} CPUUtilization', 'Average', 300)",
+           label="EC2 CPU Utilization",
+           period=Duration.minutes(5)
+       )
+
+    This class does not represent a resource, so hence is not a construct. Instead,
+    SearchExpression is an abstraction that makes it easy to specify metrics for use in graphs.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        cpu_utilization = cloudwatch.SearchExpression(
+            expression="SEARCH('{AWS/EC2,InstanceId} MetricName=\"CPUUtilization\"', 'Average', 900)",
+            label="EC2 CPU Utilization",
+            color="#ff7f0e"
+        )
+    '''
+
+    def __init__(
+        self,
+        *,
+        expression: builtins.str,
+        color: typing.Optional[builtins.str] = None,
+        label: typing.Optional[builtins.str] = None,
+        period: typing.Optional[_Duration_4839e8c3] = None,
+        search_account: typing.Optional[builtins.str] = None,
+        search_region: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''
+        :param expression: The search expression defining the metrics to be retrieved. A search expression cannot be used within an Alarm. A search expression allows you to retrieve and graph multiple related metrics in a single statement. It can return up to 500 time series. Examples: - ``SEARCH('{AWS/EC2,InstanceId} CPUUtilization', 'Average', 300)`` - ``SEARCH('{AWS/ApplicationELB,LoadBalancer} RequestCount', 'Sum', 60)`` - ``SEARCH('{MyNamespace,ServiceName} Errors', 'Sum')`` For more information about search expression syntax, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html
+        :param color: Color for the metric produced by the search expression. If the search expression produces more than one time series, the color is assigned to the first one. Other metrics are assigned colors automatically. Default: - Automatically assigned.
+        :param label: Label for this search expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series, each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the search expression produces more than one time series, the maximum will be shown for each individual time series produce by this search expression. Default: - No label.
+        :param period: The period over which the search expression's statistics are applied. This period overrides the period defined within the search expression. Default: Duration.minutes(5)
+        :param search_account: Account to evaluate search expressions within. Default: - Deployment account.
+        :param search_region: Region to evaluate search expressions within. Default: - Deployment region.
+        '''
+        props = SearchExpressionProps(
+            expression=expression,
+            color=color,
+            label=label,
+            period=period,
+            search_account=search_account,
+            search_region=search_region,
+        )
+
+        jsii.create(self.__class__, self, [props])
+
+    @jsii.member(jsii_name="toMetricConfig")
+    def to_metric_config(self) -> MetricConfig:
+        '''Inspect the details of the metric object.'''
+        return typing.cast(MetricConfig, jsii.invoke(self, "toMetricConfig", []))
+
+    @jsii.member(jsii_name="toString")
+    def to_string(self) -> builtins.str:
+        '''Returns a string representation of an object.'''
+        return typing.cast(builtins.str, jsii.invoke(self, "toString", []))
+
+    @jsii.member(jsii_name="with")
+    def with_(
+        self,
+        *,
+        color: typing.Optional[builtins.str] = None,
+        label: typing.Optional[builtins.str] = None,
+        period: typing.Optional[_Duration_4839e8c3] = None,
+        search_account: typing.Optional[builtins.str] = None,
+        search_region: typing.Optional[builtins.str] = None,
+    ) -> "SearchExpression":
+        '''Return a copy of SearchExpression with properties changed.
+
+        All properties except expression can be changed.
+
+        :param color: Color for the metric produced by the search expression. If the search expression produces more than one time series, the color is assigned to the first one. Other metrics are assigned colors automatically. Default: - Automatically assigned.
+        :param label: Label for this search expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series, each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the search expression produces more than one time series, the maximum will be shown for each individual time series produce by this search expression. Default: - No label.
+        :param period: The period over which the search expression's statistics are applied. This period overrides the period defined within the search expression. Default: Duration.minutes(5)
+        :param search_account: Account to evaluate search expressions within. Default: - Deployment account.
+        :param search_region: Region to evaluate search expressions within. Default: - Deployment region.
+        '''
+        props = SearchExpressionOptions(
+            color=color,
+            label=label,
+            period=period,
+            search_account=search_account,
+            search_region=search_region,
+        )
+
+        return typing.cast("SearchExpression", jsii.invoke(self, "with", [props]))
+
+    @builtins.property
+    @jsii.member(jsii_name="expression")
+    def expression(self) -> builtins.str:
+        '''The search expression defining the metrics to be retrieved.'''
+        return typing.cast(builtins.str, jsii.get(self, "expression"))
+
+    @builtins.property
+    @jsii.member(jsii_name="period")
+    def period(self) -> _Duration_4839e8c3:
+        '''The aggregation period for the metrics produced by the Search Expression.'''
+        return typing.cast(_Duration_4839e8c3, jsii.get(self, "period"))
+
+    @builtins.property
+    @jsii.member(jsii_name="color")
+    def color(self) -> typing.Optional[builtins.str]:
+        '''Hex color code (e.g. '#00ff00'), to use when rendering the resulting metrics in a graph. If multiple time series are returned, color is assigned to the first metric, color for the other metrics is automatically assigned.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "color"))
+
+    @builtins.property
+    @jsii.member(jsii_name="label")
+    def label(self) -> typing.Optional[builtins.str]:
+        '''The label is used as a prefix for the title of each metric returned by the search expression.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "label"))
+
+    @builtins.property
+    @jsii.member(jsii_name="searchAccount")
+    def search_account(self) -> typing.Optional[builtins.str]:
+        '''Account to evaluate search expressions within.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "searchAccount"))
+
+    @builtins.property
+    @jsii.member(jsii_name="searchRegion")
+    def search_region(self) -> typing.Optional[builtins.str]:
+        '''Region to evaluate search expressions within.'''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "searchRegion"))
+
+    @builtins.property
+    @jsii.member(jsii_name="warnings")
+    def warnings(self) -> typing.Optional[typing.List[builtins.str]]:
+        '''(deprecated) Warnings generated by this search expression.
+
+        :deprecated: - use warningsV2
+
+        :stability: deprecated
+        '''
+        return typing.cast(typing.Optional[typing.List[builtins.str]], jsii.get(self, "warnings"))
+
+    @builtins.property
+    @jsii.member(jsii_name="warningsV2")
+    def warnings_v2(
+        self,
+    ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
+        '''Warnings generated by this search expression.'''
+        return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "warningsV2"))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_cloudwatch.SearchExpressionOptions",
+    jsii_struct_bases=[],
+    name_mapping={
+        "color": "color",
+        "label": "label",
+        "period": "period",
+        "search_account": "searchAccount",
+        "search_region": "searchRegion",
+    },
+)
+class SearchExpressionOptions:
+    def __init__(
+        self,
+        *,
+        color: typing.Optional[builtins.str] = None,
+        label: typing.Optional[builtins.str] = None,
+        period: typing.Optional[_Duration_4839e8c3] = None,
+        search_account: typing.Optional[builtins.str] = None,
+        search_region: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Configurable options for SearchExpressions.
+
+        :param color: Color for the metric produced by the search expression. If the search expression produces more than one time series, the color is assigned to the first one. Other metrics are assigned colors automatically. Default: - Automatically assigned.
+        :param label: Label for this search expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series, each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the search expression produces more than one time series, the maximum will be shown for each individual time series produce by this search expression. Default: - No label.
+        :param period: The period over which the search expression's statistics are applied. This period overrides the period defined within the search expression. Default: Duration.minutes(5)
+        :param search_account: Account to evaluate search expressions within. Default: - Deployment account.
+        :param search_region: Region to evaluate search expressions within. Default: - Deployment region.
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            import aws_cdk as cdk
+            from aws_cdk import aws_cloudwatch as cloudwatch
+            
+            search_expression_options = cloudwatch.SearchExpressionOptions(
+                color="color",
+                label="label",
+                period=cdk.Duration.minutes(30),
+                search_account="searchAccount",
+                search_region="searchRegion"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9f60f6548f685a7de97fff8e4e2d7ad81a4a32dbef7d990d9298e04900ccf74c)
+            check_type(argname="argument color", value=color, expected_type=type_hints["color"])
+            check_type(argname="argument label", value=label, expected_type=type_hints["label"])
+            check_type(argname="argument period", value=period, expected_type=type_hints["period"])
+            check_type(argname="argument search_account", value=search_account, expected_type=type_hints["search_account"])
+            check_type(argname="argument search_region", value=search_region, expected_type=type_hints["search_region"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if color is not None:
+            self._values["color"] = color
+        if label is not None:
+            self._values["label"] = label
+        if period is not None:
+            self._values["period"] = period
+        if search_account is not None:
+            self._values["search_account"] = search_account
+        if search_region is not None:
+            self._values["search_region"] = search_region
+
+    @builtins.property
+    def color(self) -> typing.Optional[builtins.str]:
+        '''Color for the metric produced by the search expression.
+
+        If the search expression produces more than one time series, the color is assigned to the first one.
+        Other metrics are assigned colors automatically.
+
+        :default: - Automatically assigned.
+        '''
+        result = self._values.get("color")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def label(self) -> typing.Optional[builtins.str]:
+        '''Label for this search expression when added to a Graph in a Dashboard.
+
+        If this expression evaluates to more than one time series,
+        each time series will appear in the graph using a combination of the
+        expression label and the individual metric label. Specify the empty
+        string (``''``) to suppress the expression label and only keep the
+        metric label.
+
+        You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_
+        to show summary information about the displayed time series
+        in the legend. For example, if you use::
+
+           [max: ${MAX}] MyMetric
+
+        As the metric label, the maximum value in the visible range will
+        be shown next to the time series name in the graph's legend. If the
+        search expression produces more than one time series, the maximum
+        will be shown for each individual time series produce by this
+        search expression.
+
+        :default: - No label.
+        '''
+        result = self._values.get("label")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def period(self) -> typing.Optional[_Duration_4839e8c3]:
+        '''The period over which the search expression's statistics are applied.
+
+        This period overrides the period defined within the search expression.
+
+        :default: Duration.minutes(5)
+        '''
+        result = self._values.get("period")
+        return typing.cast(typing.Optional[_Duration_4839e8c3], result)
+
+    @builtins.property
+    def search_account(self) -> typing.Optional[builtins.str]:
+        '''Account to evaluate search expressions within.
+
+        :default: - Deployment account.
+        '''
+        result = self._values.get("search_account")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def search_region(self) -> typing.Optional[builtins.str]:
+        '''Region to evaluate search expressions within.
+
+        :default: - Deployment region.
+        '''
+        result = self._values.get("search_region")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "SearchExpressionOptions(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_cloudwatch.SearchExpressionProps",
+    jsii_struct_bases=[SearchExpressionOptions],
+    name_mapping={
+        "color": "color",
+        "label": "label",
+        "period": "period",
+        "search_account": "searchAccount",
+        "search_region": "searchRegion",
+        "expression": "expression",
+    },
+)
+class SearchExpressionProps(SearchExpressionOptions):
+    def __init__(
+        self,
+        *,
+        color: typing.Optional[builtins.str] = None,
+        label: typing.Optional[builtins.str] = None,
+        period: typing.Optional[_Duration_4839e8c3] = None,
+        search_account: typing.Optional[builtins.str] = None,
+        search_region: typing.Optional[builtins.str] = None,
+        expression: builtins.str,
+    ) -> None:
+        '''Properties for a SearchExpression.
+
+        :param color: Color for the metric produced by the search expression. If the search expression produces more than one time series, the color is assigned to the first one. Other metrics are assigned colors automatically. Default: - Automatically assigned.
+        :param label: Label for this search expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series, each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the search expression produces more than one time series, the maximum will be shown for each individual time series produce by this search expression. Default: - No label.
+        :param period: The period over which the search expression's statistics are applied. This period overrides the period defined within the search expression. Default: Duration.minutes(5)
+        :param search_account: Account to evaluate search expressions within. Default: - Deployment account.
+        :param search_region: Region to evaluate search expressions within. Default: - Deployment region.
+        :param expression: The search expression defining the metrics to be retrieved. A search expression cannot be used within an Alarm. A search expression allows you to retrieve and graph multiple related metrics in a single statement. It can return up to 500 time series. Examples: - ``SEARCH('{AWS/EC2,InstanceId} CPUUtilization', 'Average', 300)`` - ``SEARCH('{AWS/ApplicationELB,LoadBalancer} RequestCount', 'Sum', 60)`` - ``SEARCH('{MyNamespace,ServiceName} Errors', 'Sum')`` For more information about search expression syntax, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html
+
+        :exampleMetadata: infused
+
+        Example::
+
+            cpu_utilization = cloudwatch.SearchExpression(
+                expression="SEARCH('{AWS/EC2,InstanceId} MetricName=\"CPUUtilization\"', 'Average', 900)",
+                label="EC2 CPU Utilization",
+                color="#ff7f0e"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__ea7b0e5733d6f08911d542fd96929aa00fb8c855f30bc6cce35d09d7e062f08e)
+            check_type(argname="argument color", value=color, expected_type=type_hints["color"])
+            check_type(argname="argument label", value=label, expected_type=type_hints["label"])
+            check_type(argname="argument period", value=period, expected_type=type_hints["period"])
+            check_type(argname="argument search_account", value=search_account, expected_type=type_hints["search_account"])
+            check_type(argname="argument search_region", value=search_region, expected_type=type_hints["search_region"])
+            check_type(argname="argument expression", value=expression, expected_type=type_hints["expression"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "expression": expression,
+        }
+        if color is not None:
+            self._values["color"] = color
+        if label is not None:
+            self._values["label"] = label
+        if period is not None:
+            self._values["period"] = period
+        if search_account is not None:
+            self._values["search_account"] = search_account
+        if search_region is not None:
+            self._values["search_region"] = search_region
+
+    @builtins.property
+    def color(self) -> typing.Optional[builtins.str]:
+        '''Color for the metric produced by the search expression.
+
+        If the search expression produces more than one time series, the color is assigned to the first one.
+        Other metrics are assigned colors automatically.
+
+        :default: - Automatically assigned.
+        '''
+        result = self._values.get("color")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def label(self) -> typing.Optional[builtins.str]:
+        '''Label for this search expression when added to a Graph in a Dashboard.
+
+        If this expression evaluates to more than one time series,
+        each time series will appear in the graph using a combination of the
+        expression label and the individual metric label. Specify the empty
+        string (``''``) to suppress the expression label and only keep the
+        metric label.
+
+        You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_
+        to show summary information about the displayed time series
+        in the legend. For example, if you use::
 
-        :exampleMetadata: infused
+           [max: ${MAX}] MyMetric
 
-        Example::
+        As the metric label, the maximum value in the visible range will
+        be shown next to the time series name in the graph's legend. If the
+        search expression produces more than one time series, the maximum
+        will be shown for each individual time series produce by this
+        search expression.
 
-            import aws_cdk.aws_cloudwatch as cw
-            
-            
-            dashboard = cw.Dashboard(self, "Dash",
-                default_interval=Duration.days(7),
-                variables=[cw.DashboardVariable(
-                    id="functionName",
-                    type=cw.VariableType.PATTERN,
-                    label="Function",
-                    input_type=cw.VariableInputType.RADIO,
-                    value="originalFuncNameInDashboard",
-                    # equivalent to cw.Values.fromSearch('{AWS/Lambda,FunctionName} MetricName=\"Duration\"', 'FunctionName')
-                    values=cw.Values.from_search_components(
-                        namespace="AWS/Lambda",
-                        dimensions=["FunctionName"],
-                        metric_name="Duration",
-                        populate_from="FunctionName"
-                    ),
-                    default_value=cw.DefaultValue.FIRST,
-                    visible=True
-                )]
-            )
+        :default: - No label.
         '''
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__834c69a269555056b1b73146ff2784af68174eb591f39133c585607049d7afe7)
-            check_type(argname="argument dimensions", value=dimensions, expected_type=type_hints["dimensions"])
-            check_type(argname="argument metric_name", value=metric_name, expected_type=type_hints["metric_name"])
-            check_type(argname="argument namespace", value=namespace, expected_type=type_hints["namespace"])
-            check_type(argname="argument populate_from", value=populate_from, expected_type=type_hints["populate_from"])
-        self._values: typing.Dict[builtins.str, typing.Any] = {
-            "dimensions": dimensions,
-            "metric_name": metric_name,
-            "namespace": namespace,
-            "populate_from": populate_from,
-        }
+        result = self._values.get("label")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
-    def dimensions(self) -> typing.List[builtins.str]:
-        '''The list of dimensions to be used in the search expression.'''
-        result = self._values.get("dimensions")
-        assert result is not None, "Required property 'dimensions' is missing"
-        return typing.cast(typing.List[builtins.str], result)
+    def period(self) -> typing.Optional[_Duration_4839e8c3]:
+        '''The period over which the search expression's statistics are applied.
+
+        This period overrides the period defined within the search expression.
+
+        :default: Duration.minutes(5)
+        '''
+        result = self._values.get("period")
+        return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
     @builtins.property
-    def metric_name(self) -> builtins.str:
-        '''The metric name to be used in the search expression.'''
-        result = self._values.get("metric_name")
-        assert result is not None, "Required property 'metric_name' is missing"
-        return typing.cast(builtins.str, result)
+    def search_account(self) -> typing.Optional[builtins.str]:
+        '''Account to evaluate search expressions within.
+
+        :default: - Deployment account.
+        '''
+        result = self._values.get("search_account")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
-    def namespace(self) -> builtins.str:
-        '''The namespace to be used in the search expression.'''
-        result = self._values.get("namespace")
-        assert result is not None, "Required property 'namespace' is missing"
-        return typing.cast(builtins.str, result)
+    def search_region(self) -> typing.Optional[builtins.str]:
+        '''Region to evaluate search expressions within.
+
+        :default: - Deployment region.
+        '''
+        result = self._values.get("search_region")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
-    def populate_from(self) -> builtins.str:
-        '''The dimension name, that the search expression retrieves, whose values will be used to populate the values to choose from.'''
-        result = self._values.get("populate_from")
-        assert result is not None, "Required property 'populate_from' is missing"
+    def expression(self) -> builtins.str:
+        '''The search expression defining the metrics to be retrieved.
+
+        A search expression cannot be used within an Alarm.
+
+        A search expression allows you to retrieve and graph multiple related metrics in a single statement.
+        It can return up to 500 time series.
+
+        Examples:
+
+        - ``SEARCH('{AWS/EC2,InstanceId} CPUUtilization', 'Average', 300)``
+        - ``SEARCH('{AWS/ApplicationELB,LoadBalancer} RequestCount', 'Sum', 60)``
+        - ``SEARCH('{MyNamespace,ServiceName} Errors', 'Sum')``
+
+        For more information about search expression syntax, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html
+        '''
+        result = self._values.get("expression")
+        assert result is not None, "Required property 'expression' is missing"
         return typing.cast(builtins.str, result)
 
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
@@ -10877,7 +11891,7 @@ class SearchComponents:
         return not (rhs == self)
 
     def __repr__(self) -> str:
-        return "SearchComponents(%s)" % ", ".join(
+        return "SearchExpressionProps(%s)" % ", ".join(
             k + "=" + repr(v) for k, v in self._values.items()
         )
 
@@ -10898,6 +11912,7 @@ class Shading(enum.Enum):
     jsii_type="aws-cdk-lib.aws_cloudwatch.SingleValueWidgetProps",
     jsii_struct_bases=[MetricWidgetProps],
     name_mapping={
+        "account_id": "accountId",
         "height": "height",
         "region": "region",
         "title": "title",
@@ -10915,6 +11930,7 @@ class SingleValueWidgetProps(MetricWidgetProps):
     def __init__(
         self,
         *,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -10929,6 +11945,7 @@ class SingleValueWidgetProps(MetricWidgetProps):
     ) -> None:
         '''Properties for a SingleValueWidget.
 
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -10956,6 +11973,7 @@ class SingleValueWidgetProps(MetricWidgetProps):
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4596565f40195bdcc9fe939fa585a3bdf484f8a4a6817e427c6f9e1e49650041)
+            check_type(argname="argument account_id", value=account_id, expected_type=type_hints["account_id"])
             check_type(argname="argument height", value=height, expected_type=type_hints["height"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
@@ -10970,6 +11988,8 @@ class SingleValueWidgetProps(MetricWidgetProps):
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "metrics": metrics,
         }
+        if account_id is not None:
+            self._values["account_id"] = account_id
         if height is not None:
             self._values["height"] = height
         if region is not None:
@@ -10991,6 +12011,22 @@ class SingleValueWidgetProps(MetricWidgetProps):
         if start is not None:
             self._values["start"] = start
 
+    @builtins.property
+    def account_id(self) -> typing.Optional[builtins.str]:
+        '''The AWS account ID where the metrics are located.
+
+        This enables cross-account functionality for CloudWatch dashboards.
+        Before using this feature, ensure that proper cross-account sharing is configured
+        between the monitoring account and source account.
+
+        For more information, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+
+        :default: - Current account
+        '''
+        result = self._values.get("account_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
         '''Height of the widget.
@@ -11910,6 +12946,7 @@ class TableThreshold(
     jsii_type="aws-cdk-lib.aws_cloudwatch.TableWidgetProps",
     jsii_struct_bases=[MetricWidgetProps],
     name_mapping={
+        "account_id": "accountId",
         "height": "height",
         "region": "region",
         "title": "title",
@@ -11932,6 +12969,7 @@ class TableWidgetProps(MetricWidgetProps):
     def __init__(
         self,
         *,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -11951,6 +12989,7 @@ class TableWidgetProps(MetricWidgetProps):
     ) -> None:
         '''Properties for a TableWidget.
 
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -11985,6 +13024,7 @@ class TableWidgetProps(MetricWidgetProps):
             summary = TableSummaryProps(**summary)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__03726ba90bb01c2a1340af4f73005fffe1b8288cff57d77f31d745d629defb8b)
+            check_type(argname="argument account_id", value=account_id, expected_type=type_hints["account_id"])
             check_type(argname="argument height", value=height, expected_type=type_hints["height"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
@@ -12002,6 +13042,8 @@ class TableWidgetProps(MetricWidgetProps):
             check_type(argname="argument summary", value=summary, expected_type=type_hints["summary"])
             check_type(argname="argument thresholds", value=thresholds, expected_type=type_hints["thresholds"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if account_id is not None:
+            self._values["account_id"] = account_id
         if height is not None:
             self._values["height"] = height
         if region is not None:
@@ -12035,6 +13077,22 @@ class TableWidgetProps(MetricWidgetProps):
         if thresholds is not None:
             self._values["thresholds"] = thresholds
 
+    @builtins.property
+    def account_id(self) -> typing.Optional[builtins.str]:
+        '''The AWS account ID where the metrics are located.
+
+        This enables cross-account functionality for CloudWatch dashboards.
+        Before using this feature, ensure that proper cross-account sharing is configured
+        between the monitoring account and source account.
+
+        For more information, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+
+        :default: - Current account
+        '''
+        result = self._values.get("account_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
         '''Height of the widget.
@@ -12872,8 +13930,8 @@ class YAxisProps:
         '''Properties for a Y-Axis.
 
         :param label: The label. Default: - No label
-        :param max: The max value. Default: - No maximum value
-        :param min: The min value. Default: 0
+        :param max: The max value. Default: - Auto
+        :param min: The min value. Default: - Auto
         :param show_units: Whether to show units. Default: true
 
         :exampleMetadata: infused
@@ -12922,7 +13980,7 @@ class YAxisProps:
     def max(self) -> typing.Optional[jsii.Number]:
         '''The max value.
 
-        :default: - No maximum value
+        :default: - Auto
         '''
         result = self._values.get("max")
         return typing.cast(typing.Optional[jsii.Number], result)
@@ -12931,7 +13989,7 @@ class YAxisProps:
     def min(self) -> typing.Optional[jsii.Number]:
         '''The min value.
 
-        :default: 0
+        :default: - Auto
         '''
         result = self._values.get("min")
         return typing.cast(typing.Optional[jsii.Number], result)
@@ -13005,31 +14063,29 @@ class AlarmProps(CreateAlarmOptions):
 
         Example::
 
-            import aws_cdk.aws_cloudwatch as cloudwatch
+            # log_group: logs.LogGroup
             
-            # alias: lambda.Alias
+            mf = logs.MetricFilter(self, "MetricFilter",
+                log_group=log_group,
+                metric_namespace="MyApp",
+                metric_name="Latency",
+                filter_pattern=logs.FilterPattern.exists("$.latency"),
+                metric_value="$.latency",
+                dimensions={
+                    "ErrorCode": "$.errorCode"
+                },
+                unit=cloudwatch.Unit.MILLISECONDS
+            )
             
-            # or add alarms to an existing group
-            # blue_green_alias: lambda.Alias
+            # expose a metric from the metric filter
+            metric = mf.metric()
             
-            alarm = cloudwatch.Alarm(self, "Errors",
-                comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
-                threshold=1,
-                evaluation_periods=1,
-                metric=alias.metric_errors()
-            )
-            deployment_group = codedeploy.LambdaDeploymentGroup(self, "BlueGreenDeployment",
-                alias=alias,
-                deployment_config=codedeploy.LambdaDeploymentConfig.LINEAR_10PERCENT_EVERY_1MINUTE,
-                alarms=[alarm
-                ]
+            # you can use the metric to create a new alarm
+            cloudwatch.Alarm(self, "alarm from metric filter",
+                metric=metric,
+                threshold=100,
+                evaluation_periods=2
             )
-            deployment_group.add_alarm(cloudwatch.Alarm(self, "BlueGreenErrors",
-                comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
-                threshold=1,
-                evaluation_periods=1,
-                metric=blue_green_alias.metric_errors()
-            ))
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__b2e7c873c118fbc1f6cf26e1bb5bd3d8549040c626a6450f2d686bb07b87266b)
@@ -13175,6 +14231,7 @@ class AlarmProps(CreateAlarmOptions):
     jsii_type="aws-cdk-lib.aws_cloudwatch.AlarmWidgetProps",
     jsii_struct_bases=[MetricWidgetProps],
     name_mapping={
+        "account_id": "accountId",
         "height": "height",
         "region": "region",
         "title": "title",
@@ -13187,6 +14244,7 @@ class AlarmWidgetProps(MetricWidgetProps):
     def __init__(
         self,
         *,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -13196,6 +14254,7 @@ class AlarmWidgetProps(MetricWidgetProps):
     ) -> None:
         '''Properties for an AlarmWidget.
 
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -13220,6 +14279,7 @@ class AlarmWidgetProps(MetricWidgetProps):
             left_y_axis = YAxisProps(**left_y_axis)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__8b6bef2cc64a78bffd68dc95a764829a6c125294deaebcd42b56c493541573d5)
+            check_type(argname="argument account_id", value=account_id, expected_type=type_hints["account_id"])
             check_type(argname="argument height", value=height, expected_type=type_hints["height"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
@@ -13229,6 +14289,8 @@ class AlarmWidgetProps(MetricWidgetProps):
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "alarm": alarm,
         }
+        if account_id is not None:
+            self._values["account_id"] = account_id
         if height is not None:
             self._values["height"] = height
         if region is not None:
@@ -13240,6 +14302,22 @@ class AlarmWidgetProps(MetricWidgetProps):
         if left_y_axis is not None:
             self._values["left_y_axis"] = left_y_axis
 
+    @builtins.property
+    def account_id(self) -> typing.Optional[builtins.str]:
+        '''The AWS account ID where the metrics are located.
+
+        This enables cross-account functionality for CloudWatch dashboards.
+        Before using this feature, ensure that proper cross-account sharing is configured
+        between the monitoring account and source account.
+
+        For more information, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+
+        :default: - Current account
+        '''
+        result = self._values.get("account_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
         '''Height of the widget.
@@ -13336,7 +14414,7 @@ class AnomalyDetectionMetricOptions(MathExpressionOptions):
 
         :param color: Color for this metric when added to a Graph in a Dashboard. Default: - Automatic color
         :param label: Label for this expression when added to a Graph in a Dashboard. If this expression evaluates to more than one time series (for example, through the use of ``METRICS()`` or ``SEARCH()`` expressions), each time series will appear in the graph using a combination of the expression label and the individual metric label. Specify the empty string (``''``) to suppress the expression label and only keep the metric label. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. If the math expression produces more than one time series, the maximum will be shown for each individual time series produce by this math expression. Default: - Expression value is used as label
-        :param period: The period over which the expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
+        :param period: The period over which the math expression's statistics are applied. This period overrides all periods in the metrics used in this math expression. Default: Duration.minutes(5)
         :param search_account: Account to evaluate search expressions within. Specifying a searchAccount has no effect to the account used for metrics within the expression (passed via usingMetrics). Default: - Deployment account.
         :param search_region: Region to evaluate search expressions within. Specifying a searchRegion has no effect to the region used for metrics within the expression (passed via usingMetrics). Default: - Deployment region.
         :param metric: The metric to add the alarm on. Metric objects can be obtained from most resources, or you can construct custom Metric objects by instantiating one.
@@ -13429,7 +14507,7 @@ class AnomalyDetectionMetricOptions(MathExpressionOptions):
 
     @builtins.property
     def period(self) -> typing.Optional[_Duration_4839e8c3]:
-        '''The period over which the expression's statistics are applied.
+        '''The period over which the math expression's statistics are applied.
 
         This period overrides all periods in the metrics used in this
         math expression.
@@ -13864,6 +14942,7 @@ class GaugeWidget(
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
         start: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -13872,7 +14951,7 @@ class GaugeWidget(
         '''
         :param annotations: Annotations for the left Y axis. Default: - No annotations
         :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
-        :param left_y_axis: Left Y axis. Default: - None
+        :param left_y_axis: Left Y axis. Default: {min:0,max:100}
         :param legend_position: Position of the legend. Default: - bottom
         :param live_data: Whether the graph should show live data. Default: false
         :param metrics: Metrics to display on left Y axis. Default: - No metrics
@@ -13880,6 +14959,7 @@ class GaugeWidget(
         :param set_period_to_time_range: Whether to show the value from the entire time range. Only applicable for Bar and Pie charts. If false, values will be from the most recent period of your chosen time range; if true, shows the value from the entire time range. Default: false
         :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
         :param statistic: The default statistic to be displayed for each metric. This default can be overridden within the definition of each individual metric Default: - The statistic for each metric is used
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -13896,6 +14976,7 @@ class GaugeWidget(
             set_period_to_time_range=set_period_to_time_range,
             start=start,
             statistic=statistic,
+            account_id=account_id,
             height=height,
             region=region,
             title=title,
@@ -13925,6 +15006,7 @@ class GaugeWidget(
     jsii_type="aws-cdk-lib.aws_cloudwatch.GaugeWidgetProps",
     jsii_struct_bases=[MetricWidgetProps],
     name_mapping={
+        "account_id": "accountId",
         "height": "height",
         "region": "region",
         "title": "title",
@@ -13945,6 +15027,7 @@ class GaugeWidgetProps(MetricWidgetProps):
     def __init__(
         self,
         *,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -13962,13 +15045,14 @@ class GaugeWidgetProps(MetricWidgetProps):
     ) -> None:
         '''Properties for a GaugeWidget.
 
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
         :param width: Width of the widget, in a grid of 24 units wide. Default: 6
         :param annotations: Annotations for the left Y axis. Default: - No annotations
         :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
-        :param left_y_axis: Left Y axis. Default: - None
+        :param left_y_axis: Left Y axis. Default: {min:0,max:100}
         :param legend_position: Position of the legend. Default: - bottom
         :param live_data: Whether the graph should show live data. Default: false
         :param metrics: Metrics to display on left Y axis. Default: - No metrics
@@ -13998,6 +15082,7 @@ class GaugeWidgetProps(MetricWidgetProps):
             left_y_axis = YAxisProps(**left_y_axis)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__c1f8fe2511861f7fc6d2225bf5821fc9134b7036355dffb1d0ddd86a99b53dc5)
+            check_type(argname="argument account_id", value=account_id, expected_type=type_hints["account_id"])
             check_type(argname="argument height", value=height, expected_type=type_hints["height"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
@@ -14013,6 +15098,8 @@ class GaugeWidgetProps(MetricWidgetProps):
             check_type(argname="argument start", value=start, expected_type=type_hints["start"])
             check_type(argname="argument statistic", value=statistic, expected_type=type_hints["statistic"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if account_id is not None:
+            self._values["account_id"] = account_id
         if height is not None:
             self._values["height"] = height
         if region is not None:
@@ -14042,6 +15129,22 @@ class GaugeWidgetProps(MetricWidgetProps):
         if statistic is not None:
             self._values["statistic"] = statistic
 
+    @builtins.property
+    def account_id(self) -> typing.Optional[builtins.str]:
+        '''The AWS account ID where the metrics are located.
+
+        This enables cross-account functionality for CloudWatch dashboards.
+        Before using this feature, ensure that proper cross-account sharing is configured
+        between the monitoring account and source account.
+
+        For more information, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+
+        :default: - Current account
+        '''
+        result = self._values.get("account_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
         '''Height of the widget.
@@ -14106,7 +15209,7 @@ class GaugeWidgetProps(MetricWidgetProps):
     def left_y_axis(self) -> typing.Optional[YAxisProps]:
         '''Left Y axis.
 
-        :default: - None
+        :default: {min:0,max:100}
         '''
         result = self._values.get("left_y_axis")
         return typing.cast(typing.Optional[YAxisProps], result)
@@ -14216,14 +15319,22 @@ class GraphWidget(
         
         dashboard.add_widgets(cloudwatch.GraphWidget(
             # ...
+            account_id="123456789012"
+        ))
         
-            legend_position=cloudwatch.LegendPosition.RIGHT
+        dashboard.add_widgets(cloudwatch.LogQueryWidget(
+            log_group_names=["my-log-group"],
+            # ...
+            account_id="123456789012",
+            query_lines=["fields @message"
+            ]
         ))
     '''
 
     def __init__(
         self,
         *,
+        display_labels_on_chart: typing.Optional[builtins.bool] = None,
         end: typing.Optional[builtins.str] = None,
         left: typing.Optional[typing.Sequence[IMetric]] = None,
         left_annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -14240,12 +15351,14 @@ class GraphWidget(
         statistic: typing.Optional[builtins.str] = None,
         vertical_annotations: typing.Optional[typing.Sequence[typing.Union[VerticalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
         view: typing.Optional[GraphWidgetView] = None,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
         width: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
+        :param display_labels_on_chart: Whether the graph should show labels on the chart. Currently only applicable for Pie charts. Default: false
         :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param left: Metrics to display on left Y axis. Default: - No metrics
         :param left_annotations: Annotations for the left Y axis. Default: - No annotations
@@ -14262,12 +15375,14 @@ class GraphWidget(
         :param statistic: The default statistic to be displayed for each metric. This default can be overridden within the definition of each individual metric Default: - The statistic for each metric is used
         :param vertical_annotations: Annotations for the X axis. Default: - No annotations
         :param view: Display this metric. Default: TimeSeries
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
         :param width: Width of the widget, in a grid of 24 units wide. Default: 6
         '''
         props = GraphWidgetProps(
+            display_labels_on_chart=display_labels_on_chart,
             end=end,
             left=left,
             left_annotations=left_annotations,
@@ -14284,6 +15399,7 @@ class GraphWidget(
             statistic=statistic,
             vertical_annotations=vertical_annotations,
             view=view,
+            account_id=account_id,
             height=height,
             region=region,
             title=title,
@@ -14324,10 +15440,12 @@ class GraphWidget(
     jsii_type="aws-cdk-lib.aws_cloudwatch.GraphWidgetProps",
     jsii_struct_bases=[MetricWidgetProps],
     name_mapping={
+        "account_id": "accountId",
         "height": "height",
         "region": "region",
         "title": "title",
         "width": "width",
+        "display_labels_on_chart": "displayLabelsOnChart",
         "end": "end",
         "left": "left",
         "left_annotations": "leftAnnotations",
@@ -14350,10 +15468,12 @@ class GraphWidgetProps(MetricWidgetProps):
     def __init__(
         self,
         *,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
         width: typing.Optional[jsii.Number] = None,
+        display_labels_on_chart: typing.Optional[builtins.bool] = None,
         end: typing.Optional[builtins.str] = None,
         left: typing.Optional[typing.Sequence[IMetric]] = None,
         left_annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -14373,10 +15493,12 @@ class GraphWidgetProps(MetricWidgetProps):
     ) -> None:
         '''Properties for a GraphWidget.
 
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
         :param width: Width of the widget, in a grid of 24 units wide. Default: 6
+        :param display_labels_on_chart: Whether the graph should show labels on the chart. Currently only applicable for Pie charts. Default: false
         :param end: The end of the time range to use for each widget independently from those of the dashboard. If you specify a value for end, you must also specify a value for start. Specify an absolute time in the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the end date will be the current time.
         :param left: Metrics to display on left Y axis. Default: - No metrics
         :param left_annotations: Annotations for the left Y axis. Default: - No annotations
@@ -14403,8 +15525,15 @@ class GraphWidgetProps(MetricWidgetProps):
             
             dashboard.add_widgets(cloudwatch.GraphWidget(
                 # ...
+                account_id="123456789012"
+            ))
             
-                legend_position=cloudwatch.LegendPosition.RIGHT
+            dashboard.add_widgets(cloudwatch.LogQueryWidget(
+                log_group_names=["my-log-group"],
+                # ...
+                account_id="123456789012",
+                query_lines=["fields @message"
+                ]
             ))
         '''
         if isinstance(left_y_axis, dict):
@@ -14413,10 +15542,12 @@ class GraphWidgetProps(MetricWidgetProps):
             right_y_axis = YAxisProps(**right_y_axis)
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__3471ad100c9e34a517506d76368276ef9b137a3c7b33aecc91910b5dc9263b3b)
+            check_type(argname="argument account_id", value=account_id, expected_type=type_hints["account_id"])
             check_type(argname="argument height", value=height, expected_type=type_hints["height"])
             check_type(argname="argument region", value=region, expected_type=type_hints["region"])
             check_type(argname="argument title", value=title, expected_type=type_hints["title"])
             check_type(argname="argument width", value=width, expected_type=type_hints["width"])
+            check_type(argname="argument display_labels_on_chart", value=display_labels_on_chart, expected_type=type_hints["display_labels_on_chart"])
             check_type(argname="argument end", value=end, expected_type=type_hints["end"])
             check_type(argname="argument left", value=left, expected_type=type_hints["left"])
             check_type(argname="argument left_annotations", value=left_annotations, expected_type=type_hints["left_annotations"])
@@ -14434,6 +15565,8 @@ class GraphWidgetProps(MetricWidgetProps):
             check_type(argname="argument vertical_annotations", value=vertical_annotations, expected_type=type_hints["vertical_annotations"])
             check_type(argname="argument view", value=view, expected_type=type_hints["view"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if account_id is not None:
+            self._values["account_id"] = account_id
         if height is not None:
             self._values["height"] = height
         if region is not None:
@@ -14442,6 +15575,8 @@ class GraphWidgetProps(MetricWidgetProps):
             self._values["title"] = title
         if width is not None:
             self._values["width"] = width
+        if display_labels_on_chart is not None:
+            self._values["display_labels_on_chart"] = display_labels_on_chart
         if end is not None:
             self._values["end"] = end
         if left is not None:
@@ -14475,6 +15610,22 @@ class GraphWidgetProps(MetricWidgetProps):
         if view is not None:
             self._values["view"] = view
 
+    @builtins.property
+    def account_id(self) -> typing.Optional[builtins.str]:
+        '''The AWS account ID where the metrics are located.
+
+        This enables cross-account functionality for CloudWatch dashboards.
+        Before using this feature, ensure that proper cross-account sharing is configured
+        between the monitoring account and source account.
+
+        For more information, see:
+        https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+
+        :default: - Current account
+        '''
+        result = self._values.get("account_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def height(self) -> typing.Optional[jsii.Number]:
         '''Height of the widget.
@@ -14514,6 +15665,17 @@ class GraphWidgetProps(MetricWidgetProps):
         result = self._values.get("width")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def display_labels_on_chart(self) -> typing.Optional[builtins.bool]:
+        '''Whether the graph should show labels on the chart.
+
+        Currently only applicable for Pie charts.
+
+        :default: false
+        '''
+        result = self._values.get("display_labels_on_chart")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def end(self) -> typing.Optional[builtins.str]:
         '''The end of the time range to use for each widget independently from those of the dashboard.
@@ -14767,7 +15929,9 @@ class LogQueryWidget(
         self,
         *,
         log_group_names: typing.Sequence[builtins.str],
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
+        query_language: typing.Optional[LogQueryLanguage] = None,
         query_lines: typing.Optional[typing.Sequence[builtins.str]] = None,
         query_string: typing.Optional[builtins.str] = None,
         region: typing.Optional[builtins.str] = None,
@@ -14777,7 +15941,9 @@ class LogQueryWidget(
     ) -> None:
         '''
         :param log_group_names: Names of log groups to query.
+        :param account_id: The AWS account ID where the log groups are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: 6
+        :param query_language: The query language to use for the query. Default: LogQueryLanguage.LOGS_INSIGHTS
         :param query_lines: A sequence of lines to use to build the query. The query will be built by joining the lines together using ``\\n|``. Default: - Exactly one of ``queryString``, ``queryLines`` is required.
         :param query_string: Full query string for log insights. Be sure to prepend every new line with a newline and pipe character (``\\n|``). Default: - Exactly one of ``queryString``, ``queryLines`` is required.
         :param region: The region the metrics of this widget should be taken from. Default: Current region
@@ -14787,7 +15953,9 @@ class LogQueryWidget(
         '''
         props = LogQueryWidgetProps(
             log_group_names=log_group_names,
+            account_id=account_id,
             height=height,
+            query_language=query_language,
             query_lines=query_lines,
             query_string=query_string,
             region=region,
@@ -14835,6 +16003,7 @@ class SingleValueWidget(
         set_period_to_time_range: typing.Optional[builtins.bool] = None,
         sparkline: typing.Optional[builtins.bool] = None,
         start: typing.Optional[builtins.str] = None,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -14848,6 +16017,7 @@ class SingleValueWidget(
         :param set_period_to_time_range: Whether to show the value from the entire time range. Default: false
         :param sparkline: Whether to show a graph below the value illustrating the value for the whole time range. Cannot be used in combination with ``setPeriodToTimeRange`` Default: false
         :param start: The start of the time range to use for each widget independently from those of the dashboard. You can specify start without specifying end to specify a relative time range that ends with the current time. In this case, the value of start must begin with -P, and you can use M, H, D, W and M as abbreviations for minutes, hours, days, weeks and months. For example, -PT8H shows the last 8 hours and -P3M shows the last three months. You can also use start along with an end field, to specify an absolute time range. When specifying an absolute time range, use the ISO 8601 format. For example, 2018-12-17T06:00:00.000Z. Default: When the dashboard loads, the start time will be the default time range.
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -14861,6 +16031,7 @@ class SingleValueWidget(
             set_period_to_time_range=set_period_to_time_range,
             sparkline=sparkline,
             start=start,
+            account_id=account_id,
             height=height,
             region=region,
             title=title,
@@ -14911,6 +16082,7 @@ class TableWidget(
         statistic: typing.Optional[builtins.str] = None,
         summary: typing.Optional[typing.Union[TableSummaryProps, typing.Dict[builtins.str, typing.Any]]] = None,
         thresholds: typing.Optional[typing.Sequence[TableThreshold]] = None,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -14929,6 +16101,7 @@ class TableWidget(
         :param statistic: The default statistic to be displayed for each metric. This default can be overridden within the definition of each individual metric Default: - The statistic for each metric is used
         :param summary: Properties for displaying summary columns. Default: - no summary columns are shown
         :param thresholds: Thresholds for highlighting table cells. Default: - No thresholds
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -14947,6 +16120,7 @@ class TableWidget(
             statistic=statistic,
             summary=summary,
             thresholds=thresholds,
+            account_id=account_id,
             height=height,
             region=region,
             title=title,
@@ -15296,6 +16470,7 @@ class AlarmWidget(
         *,
         alarm: IAlarm,
         left_y_axis: typing.Optional[typing.Union[YAxisProps, typing.Dict[builtins.str, typing.Any]]] = None,
+        account_id: typing.Optional[builtins.str] = None,
         height: typing.Optional[jsii.Number] = None,
         region: typing.Optional[builtins.str] = None,
         title: typing.Optional[builtins.str] = None,
@@ -15304,6 +16479,7 @@ class AlarmWidget(
         '''
         :param alarm: The alarm to show.
         :param left_y_axis: Left Y axis. Default: - No minimum or maximum values for the left Y-axis
+        :param account_id: The AWS account ID where the metrics are located. This enables cross-account functionality for CloudWatch dashboards. Before using this feature, ensure that proper cross-account sharing is configured between the monitoring account and source account. For more information, see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html Default: - Current account
         :param height: Height of the widget. Default: - 6 for Alarm and Graph widgets. 3 for single value widgets where most recent value of a metric is displayed.
         :param region: The region the metrics of this graph should be taken from. Default: - Current region
         :param title: Title for the graph. Default: - None
@@ -15312,6 +16488,7 @@ class AlarmWidget(
         props = AlarmWidgetProps(
             alarm=alarm,
             left_y_axis=left_y_axis,
+            account_id=account_id,
             height=height,
             region=region,
             title=title,
@@ -15473,31 +16650,29 @@ class Alarm(
 
     Example::
 
-        import aws_cdk.aws_cloudwatch as cloudwatch
+        # log_group: logs.LogGroup
         
-        # alias: lambda.Alias
+        mf = logs.MetricFilter(self, "MetricFilter",
+            log_group=log_group,
+            metric_namespace="MyApp",
+            metric_name="Latency",
+            filter_pattern=logs.FilterPattern.exists("$.latency"),
+            metric_value="$.latency",
+            dimensions={
+                "ErrorCode": "$.errorCode"
+            },
+            unit=cloudwatch.Unit.MILLISECONDS
+        )
         
-        # or add alarms to an existing group
-        # blue_green_alias: lambda.Alias
+        # expose a metric from the metric filter
+        metric = mf.metric()
         
-        alarm = cloudwatch.Alarm(self, "Errors",
-            comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
-            threshold=1,
-            evaluation_periods=1,
-            metric=alias.metric_errors()
-        )
-        deployment_group = codedeploy.LambdaDeploymentGroup(self, "BlueGreenDeployment",
-            alias=alias,
-            deployment_config=codedeploy.LambdaDeploymentConfig.LINEAR_10PERCENT_EVERY_1MINUTE,
-            alarms=[alarm
-            ]
+        # you can use the metric to create a new alarm
+        cloudwatch.Alarm(self, "alarm from metric filter",
+            metric=metric,
+            threshold=100,
+            evaluation_periods=2
         )
-        deployment_group.add_alarm(cloudwatch.Alarm(self, "BlueGreenErrors",
-            comparison_operator=cloudwatch.ComparisonOperator.GREATER_THAN_THRESHOLD,
-            threshold=1,
-            evaluation_periods=1,
-            metric=blue_green_alias.metric_errors()
-        ))
     '''
 
     def __init__(
@@ -15687,7 +16862,7 @@ class AnomalyDetectionAlarm(
             namespace="AWS/EC2",
             metric_name="CPUUtilization",
             statistic="Average",
-            period=Duration.minutes(5)
+            period=Duration.hours(1)
         )
         
         # Create an anomaly detection alarm
@@ -15821,6 +16996,7 @@ __all__ = [
     "IVariable",
     "IWidget",
     "LegendPosition",
+    "LogQueryLanguage",
     "LogQueryVisualizationType",
     "LogQueryWidget",
     "LogQueryWidgetProps",
@@ -15837,6 +17013,9 @@ __all__ = [
     "PeriodOverride",
     "Row",
     "SearchComponents",
+    "SearchExpression",
+    "SearchExpressionOptions",
+    "SearchExpressionProps",
     "Shading",
     "SingleValueWidget",
     "SingleValueWidgetProps",
@@ -15970,6 +17149,22 @@ def _typecheckingstub__5adc477b9cef758736625389f1a51dec08eb7b348be35f42b0e37d6d4
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__544b0968def3d9b72962fb1bbce7dec4b2d60b4c2518711cc9df447306ed6c4c(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    arn: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__191b683ee20d5f420eb03eb2e0b1a6e0e7cfed31f66a3afa94d14da0767a90f4(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    alarm_name: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__83bef261115d965bc301e33589e4c9b4a854da5d951fb8e2186758fba16c7f57(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:
@@ -16477,6 +17672,14 @@ def _typecheckingstub__5add67d5fc6c551e627bade2623b719ee8c8de03ff6216bc3471bbe52
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__f2a65575230b6782811b6cc1c4a4d1c6cc87f971ef5aa437442cc859d489ff82(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    dashboard_name: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__ea2b521a69d5f78d24dc5aba9c387baa4fc450da2dc68bb876531861ee0929b2(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:
@@ -16592,6 +17795,22 @@ def _typecheckingstub__324083d9d1c11bed8d2cf8d1d0cab6adbcb8194552cea34115b984457
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__50e36a4aae3592a141f72295c65ce2cf6f01c0153925f610e589758abcc065e2(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    arn: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__635a32b621fbf5f4f1c0d44f6749043dfa44bfb3ec257d8fe8a02439751244c1(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    metric_stream_name: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__3d75d145801429f4f9f0daaae66adb695e6690f2bd7b00a62aedff30952bef4c(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:
@@ -16702,6 +17921,7 @@ def _typecheckingstub__dd18f372aac3bb8d4a678dd4ee7a3b5bd34447637695b896086139ee2
     account: typing.Optional[builtins.str] = None,
     color: typing.Optional[builtins.str] = None,
     dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+    id: typing.Optional[builtins.str] = None,
     label: typing.Optional[builtins.str] = None,
     period: typing.Optional[_Duration_4839e8c3] = None,
     region: typing.Optional[builtins.str] = None,
@@ -16709,6 +17929,7 @@ def _typecheckingstub__dd18f372aac3bb8d4a678dd4ee7a3b5bd34447637695b896086139ee2
     stack_region: typing.Optional[builtins.str] = None,
     statistic: typing.Optional[builtins.str] = None,
     unit: typing.Optional[Unit] = None,
+    visible: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -16851,7 +18072,9 @@ def _typecheckingstub__f09026a4cce4261b0c1f425d42f625c9bd8f0ba4495e11743f621a2cd
 def _typecheckingstub__b7d4a308b1274696259a35b14b5ae833f34881f95eaba521bb47a74b3a80e8c0(
     *,
     log_group_names: typing.Sequence[builtins.str],
+    account_id: typing.Optional[builtins.str] = None,
     height: typing.Optional[jsii.Number] = None,
+    query_language: typing.Optional[LogQueryLanguage] = None,
     query_lines: typing.Optional[typing.Sequence[builtins.str]] = None,
     query_string: typing.Optional[builtins.str] = None,
     region: typing.Optional[builtins.str] = None,
@@ -16937,6 +18160,7 @@ def _typecheckingstub__2ddb584abe8421d7f77520aa621133794d500e179ff044f43970dac3f
     math_expression: typing.Optional[typing.Union[MetricExpressionConfig, typing.Dict[builtins.str, typing.Any]]] = None,
     metric_stat: typing.Optional[typing.Union[MetricStatConfig, typing.Dict[builtins.str, typing.Any]]] = None,
     rendering_properties: typing.Optional[typing.Mapping[builtins.str, typing.Any]] = None,
+    search_expression: typing.Optional[typing.Union[MetricExpressionConfig, typing.Dict[builtins.str, typing.Any]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -16957,6 +18181,7 @@ def _typecheckingstub__0dbe737a4d124c27184430b7c20048e16171cb8b5b94bdac632b26d84
     account: typing.Optional[builtins.str] = None,
     color: typing.Optional[builtins.str] = None,
     dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+    id: typing.Optional[builtins.str] = None,
     label: typing.Optional[builtins.str] = None,
     period: typing.Optional[_Duration_4839e8c3] = None,
     region: typing.Optional[builtins.str] = None,
@@ -16964,6 +18189,7 @@ def _typecheckingstub__0dbe737a4d124c27184430b7c20048e16171cb8b5b94bdac632b26d84
     stack_region: typing.Optional[builtins.str] = None,
     statistic: typing.Optional[builtins.str] = None,
     unit: typing.Optional[Unit] = None,
+    visible: typing.Optional[builtins.bool] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -16973,6 +18199,7 @@ def _typecheckingstub__5e1e153a11ab88ed91297aedb5d7a78a81e7bf88f8aeda51bc11ff42e
     account: typing.Optional[builtins.str] = None,
     color: typing.Optional[builtins.str] = None,
     dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+    id: typing.Optional[builtins.str] = None,
     label: typing.Optional[builtins.str] = None,
     period: typing.Optional[_Duration_4839e8c3] = None,
     region: typing.Optional[builtins.str] = None,
@@ -16980,6 +18207,7 @@ def _typecheckingstub__5e1e153a11ab88ed91297aedb5d7a78a81e7bf88f8aeda51bc11ff42e
     stack_region: typing.Optional[builtins.str] = None,
     statistic: typing.Optional[builtins.str] = None,
     unit: typing.Optional[Unit] = None,
+    visible: typing.Optional[builtins.bool] = None,
     metric_name: builtins.str,
     namespace: builtins.str,
 ) -> None:
@@ -17004,6 +18232,7 @@ def _typecheckingstub__b4491ad5e5a4b9301258f50e45d0278fe9bbf165c840e3c65f8feab63
 
 def _typecheckingstub__028d2c6eccbbf06b74566403b038cac0cdc1c8588c939f4352cc861885b12c38(
     *,
+    account_id: typing.Optional[builtins.str] = None,
     height: typing.Optional[jsii.Number] = None,
     region: typing.Optional[builtins.str] = None,
     title: typing.Optional[builtins.str] = None,
@@ -17041,8 +18270,32 @@ def _typecheckingstub__834c69a269555056b1b73146ff2784af68174eb591f39133c58560704
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__9f60f6548f685a7de97fff8e4e2d7ad81a4a32dbef7d990d9298e04900ccf74c(
+    *,
+    color: typing.Optional[builtins.str] = None,
+    label: typing.Optional[builtins.str] = None,
+    period: typing.Optional[_Duration_4839e8c3] = None,
+    search_account: typing.Optional[builtins.str] = None,
+    search_region: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__ea7b0e5733d6f08911d542fd96929aa00fb8c855f30bc6cce35d09d7e062f08e(
+    *,
+    color: typing.Optional[builtins.str] = None,
+    label: typing.Optional[builtins.str] = None,
+    period: typing.Optional[_Duration_4839e8c3] = None,
+    search_account: typing.Optional[builtins.str] = None,
+    search_region: typing.Optional[builtins.str] = None,
+    expression: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__4596565f40195bdcc9fe939fa585a3bdf484f8a4a6817e427c6f9e1e49650041(
     *,
+    account_id: typing.Optional[builtins.str] = None,
     height: typing.Optional[jsii.Number] = None,
     region: typing.Optional[builtins.str] = None,
     title: typing.Optional[builtins.str] = None,
@@ -17188,6 +18441,7 @@ def _typecheckingstub__837fdebf81b3f53de6d99624ebde152b4aba1d764a0cc2bd930440701
 
 def _typecheckingstub__03726ba90bb01c2a1340af4f73005fffe1b8288cff57d77f31d745d629defb8b(
     *,
+    account_id: typing.Optional[builtins.str] = None,
     height: typing.Optional[jsii.Number] = None,
     region: typing.Optional[builtins.str] = None,
     title: typing.Optional[builtins.str] = None,
@@ -17278,6 +18532,7 @@ def _typecheckingstub__b2e7c873c118fbc1f6cf26e1bb5bd3d8549040c626a6450f2d686bb07
 
 def _typecheckingstub__8b6bef2cc64a78bffd68dc95a764829a6c125294deaebcd42b56c493541573d5(
     *,
+    account_id: typing.Optional[builtins.str] = None,
     height: typing.Optional[jsii.Number] = None,
     region: typing.Optional[builtins.str] = None,
     title: typing.Optional[builtins.str] = None,
@@ -17360,6 +18615,7 @@ def _typecheckingstub__11f194bd6989eaa4279174f388eb1c44a7faf424b684d189ffe90647d
 
 def _typecheckingstub__c1f8fe2511861f7fc6d2225bf5821fc9134b7036355dffb1d0ddd86a99b53dc5(
     *,
+    account_id: typing.Optional[builtins.str] = None,
     height: typing.Optional[jsii.Number] = None,
     region: typing.Optional[builtins.str] = None,
     title: typing.Optional[builtins.str] = None,
@@ -17392,10 +18648,12 @@ def _typecheckingstub__d98276ba6bbea7a9a5b2efedfda4a862eeca9b42a2aaca743679984a1
 
 def _typecheckingstub__3471ad100c9e34a517506d76368276ef9b137a3c7b33aecc91910b5dc9263b3b(
     *,
+    account_id: typing.Optional[builtins.str] = None,
     height: typing.Optional[jsii.Number] = None,
     region: typing.Optional[builtins.str] = None,
     title: typing.Optional[builtins.str] = None,
     width: typing.Optional[jsii.Number] = None,
+    display_labels_on_chart: typing.Optional[builtins.bool] = None,
     end: typing.Optional[builtins.str] = None,
     left: typing.Optional[typing.Sequence[IMetric]] = None,
     left_annotations: typing.Optional[typing.Sequence[typing.Union[HorizontalAnnotation, typing.Dict[builtins.str, typing.Any]]]] = None,
@@ -17574,3 +18832,6 @@ def _typecheckingstub__a7086e47981f437b1862310e2c90e4c5bcd6054dc3450e46e526bc835
 ) -> None:
     """Type checking stubs"""
     pass
+
+for cls in [IAlarm, IAlarmAction, IAlarmRule, IMetric, IVariable, IWidget]:
+    typing.cast(typing.Any, cls).__protocol_attrs__ = typing.cast(typing.Any, cls).__protocol_attrs__ - set(['__jsii_proxy_class__', '__jsii_type__'])