aws-cdk-lib 2.203.1__py3-none-any.whl → 2.205.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,6 +124,32 @@ 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
@@ -811,6 +872,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:
@@ -6694,6 +6769,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",
@@ -6701,6 +6777,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:
@@ -6710,6 +6787,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,
@@ -6717,12 +6795,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.
@@ -6730,6 +6810,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
 
@@ -6746,13 +6827,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__:
@@ -6760,6 +6843,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"])
@@ -6767,6 +6851,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
@@ -6774,6 +6859,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:
@@ -6788,6 +6875,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]:
@@ -6818,6 +6907,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.
@@ -6915,6 +7017,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
 
@@ -8524,6 +8638,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.
@@ -8563,6 +8704,7 @@ class LogQueryVisualizationType(enum.Enum):
         "log_group_names": "logGroupNames",
         "account_id": "accountId",
         "height": "height",
+        "query_language": "queryLanguage",
         "query_lines": "queryLines",
         "query_string": "queryString",
         "region": "region",
@@ -8578,6 +8720,7 @@ class LogQueryWidgetProps:
         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,
@@ -8590,6 +8733,7 @@ class LogQueryWidgetProps:
         :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
@@ -8617,6 +8761,7 @@ class LogQueryWidgetProps:
             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"])
@@ -8630,6 +8775,8 @@ class LogQueryWidgetProps:
             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:
@@ -8675,6 +8822,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.
@@ -8770,21 +8926,16 @@ class MathExpression(
 
     Example::
 
-        # matchmaking_rule_set: gamelift.MatchmakingRuleSet
+        # fn: lambda.Function
         
-        # Alarm that triggers when the per-second average of not placed matches exceed 10%
-        rule_evaluation_ratio = cloudwatch.MathExpression(
-            expression="1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)",
+        
+        all_problems = cloudwatch.MathExpression(
+            expression="errors + throttles",
             using_metrics={
-                "rule_evaluations_passed": matchmaking_rule_set.metric_rule_evaluations_passed(statistic=cloudwatch.Statistic.SUM),
-                "rule_evaluations_failed": matchmaking_rule_set.metric("ruleEvaluationsFailed")
+                "errors": fn.metric_errors(),
+                "throttles": fn.metric_throttles()
             }
         )
-        cloudwatch.Alarm(self, "Alarm",
-            metric=rule_evaluation_ratio,
-            threshold=0.1,
-            evaluation_periods=3
-        )
     '''
 
     def __init__(
@@ -9161,21 +9312,16 @@ class MathExpressionProps(MathExpressionOptions):
 
         Example::
 
-            # matchmaking_rule_set: gamelift.MatchmakingRuleSet
+            # fn: lambda.Function
+            
             
-            # Alarm that triggers when the per-second average of not placed matches exceed 10%
-            rule_evaluation_ratio = cloudwatch.MathExpression(
-                expression="1 - (ruleEvaluationsPassed / ruleEvaluationsFailed)",
+            all_problems = cloudwatch.MathExpression(
+                expression="errors + throttles",
                 using_metrics={
-                    "rule_evaluations_passed": matchmaking_rule_set.metric_rule_evaluations_passed(statistic=cloudwatch.Statistic.SUM),
-                    "rule_evaluations_failed": matchmaking_rule_set.metric("ruleEvaluationsFailed")
+                    "errors": fn.metric_errors(),
+                    "throttles": fn.metric_throttles()
                 }
             )
-            cloudwatch.Alarm(self, "Alarm",
-                metric=rule_evaluation_ratio,
-                threshold=0.1,
-                evaluation_periods=3
-            )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7cfb588e44acd0977aa0e09f00c3e2435bad84385ab7b6d163b332963d844e0a)
@@ -9385,6 +9531,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,
@@ -9392,6 +9539,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.
@@ -9399,6 +9547,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.
@@ -9406,6 +9555,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,
@@ -9413,6 +9563,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,
@@ -9420,6 +9571,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])
@@ -9561,6 +9713,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,
@@ -9568,6 +9721,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.
 
@@ -9576,6 +9730,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.
@@ -9583,11 +9738,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,
@@ -9595,6 +9752,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]))
@@ -9641,6 +9799,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]:
@@ -9659,6 +9823,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]]:
@@ -9936,6 +10106,7 @@ class MetricExpressionConfig:
         "account": "account",
         "color": "color",
         "dimensions_map": "dimensionsMap",
+        "id": "id",
         "label": "label",
         "period": "period",
         "region": "region",
@@ -9943,6 +10114,7 @@ class MetricExpressionConfig:
         "stack_region": "stackRegion",
         "statistic": "statistic",
         "unit": "unit",
+        "visible": "visible",
     },
 )
 class MetricOptions(CommonMetricOptions):
@@ -9952,6 +10124,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,
@@ -9959,12 +10132,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.
@@ -9972,6 +10147,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
 
@@ -10002,6 +10178,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"])
@@ -10009,6 +10186,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
@@ -10016,6 +10194,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:
@@ -10030,6 +10210,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]:
@@ -10060,6 +10242,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.
@@ -10157,6 +10352,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
 
@@ -10176,6 +10383,7 @@ class MetricOptions(CommonMetricOptions):
         "account": "account",
         "color": "color",
         "dimensions_map": "dimensionsMap",
+        "id": "id",
         "label": "label",
         "period": "period",
         "region": "region",
@@ -10183,6 +10391,7 @@ class MetricOptions(CommonMetricOptions):
         "stack_region": "stackRegion",
         "statistic": "statistic",
         "unit": "unit",
+        "visible": "visible",
         "metric_name": "metricName",
         "namespace": "namespace",
     },
@@ -10194,6 +10403,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,
@@ -10201,6 +10411,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:
@@ -10209,6 +10420,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.
@@ -10216,6 +10428,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.
 
@@ -10248,6 +10461,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"])
@@ -10255,6 +10469,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] = {
@@ -10267,6 +10482,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:
@@ -10281,6 +10498,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]:
@@ -10311,6 +10530,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.
@@ -10408,6 +10640,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.'''
@@ -14980,6 +15224,7 @@ class LogQueryWidget(
         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,
@@ -14991,6 +15236,7 @@ class LogQueryWidget(
         :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
@@ -15002,6 +15248,7 @@ class LogQueryWidget(
             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,
@@ -16044,6 +16291,7 @@ __all__ = [
     "IVariable",
     "IWidget",
     "LegendPosition",
+    "LogQueryLanguage",
     "LogQueryVisualizationType",
     "LogQueryWidget",
     "LogQueryWidgetProps",
@@ -16925,6 +17173,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,
@@ -16932,6 +17181,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
@@ -17076,6 +17326,7 @@ def _typecheckingstub__b7d4a308b1274696259a35b14b5ae833f34881f95eaba521bb47a74b3
     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,
@@ -17181,6 +17432,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,
@@ -17188,6 +17440,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
@@ -17197,6 +17450,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,
@@ -17204,6 +17458,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: