LookoutMetrics / Client / describe_alert



Describes an alert.

Amazon Lookout for Metrics API actions are eventually consistent. If you do a read operation on a resource immediately after creating or modifying it, use retries to allow time for the write operation to complete.

See also: AWS API Documentation

Request Syntax

response = client.describe_alert(

AlertArn (string) –


The ARN of the alert to describe.

Return type:



Response Syntax

    'Alert': {
        'Action': {
            'SNSConfiguration': {
                'RoleArn': 'string',
                'SnsTopicArn': 'string',
                'SnsFormat': 'LONG_TEXT'|'SHORT_TEXT'|'JSON'
            'LambdaConfiguration': {
                'RoleArn': 'string',
                'LambdaArn': 'string'
        'AlertDescription': 'string',
        'AlertArn': 'string',
        'AnomalyDetectorArn': 'string',
        'AlertName': 'string',
        'AlertSensitivityThreshold': 123,
        'AlertType': 'SNS'|'LAMBDA',
        'AlertStatus': 'ACTIVE'|'INACTIVE',
        'LastModificationTime': datetime(2015, 1, 1),
        'CreationTime': datetime(2015, 1, 1),
        'AlertFilters': {
            'MetricList': [
            'DimensionFilterList': [
                    'DimensionName': 'string',
                    'DimensionValueList': [

Response Structure

  • (dict) –

    • Alert (dict) –

      Contains information about an alert.

      • Action (dict) –

        Action that will be triggered when there is an alert.

        • SNSConfiguration (dict) –

          A configuration for an Amazon SNS channel.

          • RoleArn (string) –

            The ARN of the IAM role that has access to the target SNS topic.

          • SnsTopicArn (string) –

            The ARN of the target SNS topic.

          • SnsFormat (string) –

            The format of the SNS topic.

            • JSON – Send JSON alerts with an anomaly ID and a link to the anomaly detail page. This is the default.

            • LONG_TEXT – Send human-readable alerts with information about the impacted timeseries and a link to the anomaly detail page. We recommend this for email.

            • SHORT_TEXT – Send human-readable alerts with a link to the anomaly detail page. We recommend this for SMS.

        • LambdaConfiguration (dict) –

          A configuration for an AWS Lambda channel.

          • RoleArn (string) –

            The ARN of an IAM role that has permission to invoke the Lambda function.

          • LambdaArn (string) –

            The ARN of the Lambda function.

      • AlertDescription (string) –

        A description of the alert.

      • AlertArn (string) –

        The ARN of the alert.

      • AnomalyDetectorArn (string) –

        The ARN of the detector to which the alert is attached.

      • AlertName (string) –

        The name of the alert.

      • AlertSensitivityThreshold (integer) –

        The minimum severity for an anomaly to trigger the alert.

      • AlertType (string) –

        The type of the alert.

      • AlertStatus (string) –

        The status of the alert.

      • LastModificationTime (datetime) –

        The time at which the alert was last modified.

      • CreationTime (datetime) –

        The time at which the alert was created.

      • AlertFilters (dict) –

        The configuration of the alert filters, containing MetricList and DimensionFilter.

        • MetricList (list) –

          The list of measures that you want to get alerts for.

          • (string) –

        • DimensionFilterList (list) –

          The list of DimensionFilter objects that are used for dimension-based filtering.

          • (dict) –

            The dimension filter, containing DimensionName and DimensionValueList.

            • DimensionName (string) –

              The name of the dimension to filter on.

            • DimensionValueList (list) –

              The list of values for the dimension specified in DimensionName that you want to filter on.

              • (string) –


  • LookoutMetrics.Client.exceptions.ResourceNotFoundException

  • LookoutMetrics.Client.exceptions.ValidationException

  • LookoutMetrics.Client.exceptions.AccessDeniedException

  • LookoutMetrics.Client.exceptions.InternalServerException

  • LookoutMetrics.Client.exceptions.TooManyRequestsException