View a markdown version of this page

AWSSupport-TroubleshootCloudWatchAlarm - AWS Systems Manager Riferimento al runbook dell’automazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWSSupport-TroubleshootCloudWatchAlarm

Descrizione

Il AWSSupport-TroubleshootCloudWatchAlarm runbook aiuta a identificare e risolvere i problemi relativi agli allarmi Amazon () mal configurati o problematici. CloudWatch CloudWatch Sfrutta le AWS API pubbliche e la logica di valutazione degli allarmi nota per rilevare punti dati ritardati o mancanti nelle metriche monitorate, il che può portare a mancate o ritardate azioni di allarme. Questo runbook fornisce un approccio strutturato per analizzare e risolvere i problemi di Amazon (). CloudWatch CloudWatch Alarm-related

Come funziona?

Il runbook AWSSupport-TroubleshootCloudWatchAlarm esegue i seguenti passaggi:

  • Verifica i dettagli dell'allarme Amazon CloudWatch (CloudWatch) e il valore del AlarmTriggerTimestamp parametro per verificare se è entro 2.592.000 secondi (30 giorni).

  • Verifica se un allarme è basato su un sistema metrico o matematico metrico o è un allarme rilevatore di anomalie.

  • Verifica se lo stato dei dati di un allarme è insufficiente.

  • Verifica se le metriche utilizzate nell'allarme corrispondono al ListMetrics valore.

  • Verifica se a una metrica mancavano i datapoint in un determinato timestamp.

  • Ottiene la cronologia più recente per un determinato timestamp.

  • Verifica se un allarme non si è attivato a causa di una o più metriche ritardate o mancate.

  • Verifica se le azioni attivate per un allarme sono state eseguite. was/were

  • Genera un rapporto sulla risoluzione dei problemi che combina tutti i risultati diagnostici.

Esegui questa automazione (console)

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

LinuxmacOS, Windows

Parametri

Autorizzazioni IAM richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il runbook.

  • cloudwatch:DescribeAlarms

  • cloudwatch:DescribeAlarmHistory

  • cloudwatch:DescribeAnomalyDetectors

  • cloudwatch:GetMetricData

  • cloudwatch:GetMetricStatistics

  • cloudwatch:ListMetrics

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "cloudwatch:DescribeAlarms",
                "cloudwatch:DescribeAlarmHistory",
                "cloudwatch:DescribeAnomalyDetectors",
                "cloudwatch:GetMetricData",
                "cloudwatch:GetMetricStatistics",
                "cloudwatch:ListMetrics"
            ],
            "Resource": "*"
        }
    ]
}

Istruzioni

Segui questi passaggi per configurare l'automazione:

  1. Accedi AWSSupport-TroubleshootCloudWatchAlarm a Systems Manager in Documenti.

  2. Seleziona Execute automation (Esegui automazione).

  3. Per i parametri di input, inserisci quanto segue:

    • AutomationAssumeRole (Facoltativo):

      • Tipo: String

      • Descrizione: (Facoltativo) L'Amazon Resource Name (ARN) del ruolo AWS AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

    • CloudWatchMetricAlarmName(Obbligatorio):

      • Tipo: String

      • Descrizione: (Obbligatorio) Il nome della metrica Amazon CloudWatch (CloudWatch) Alarm per la risoluzione dei problemi.

      • Schema consentito: ^[a-zA-Z0-9.:;,\\-_&() ]{1,255}$

    • AlarmTriggerTimestamp (Obbligatorio):

      • Tipo: String

      • Descrizione: (Obbligatorio) Il timestamp UTC in cui si è verificato il problema dell'allarme. Queste informazioni sono fondamentali per risolvere il problema e comprendere il contesto in cui si è verificato. Il valore del timestamp deve essere un'ora compresa tra gli ultimi 30 giorni da oggi e nel formato. YYYY-MM-DDTHH:mm:ssZ Ad esempio: 2024-10-29T09:04:00Z

      • Modello consentito: ^(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})Z$

  4. Seleziona Esegui.

  5. L'automazione viene avviata.

  6. Il documento esegue i seguenti passaggi:

    • VerifyRunbookInputs

      Verifica i dettagli dell'allarme Amazon CloudWatch (CloudWatch) e il valore del AlarmTriggerTimestamp parametro per verificare se è entro 2.592.000 secondi (30 giorni).

    • UpdateSSMDocumentInputChecksVariable

      Aggiorna la variabile SSMDocumentInputChecks con il valore SSMDocumentInputChecks di step. VerifyRunbookInputs

    • BranchOnAlarmIsVerified

      Si occupa della verifica AlarmTriggerTimestamp degli input di Runbook e. CloudWatchAlarmName

    • CheckMetricAlarmType

      Verifica se un allarme è basato su un sistema metrico o matematico metrico o è un allarme rilevatore di anomalie.

    • CheckAlarmInInsufficientDataState

      Verifica se lo stato dei dati di un allarme è insufficiente.

    • UpdateInsufficientDataChecksVariable

      Aggiorna la variabile InsufficientDataChecks con il valore InsufficientDataChecks di CheckAlarmInInsufficientDataState step.

    • BranchOnAlarmHasInsufficientData

      Dipende dal AlarmHasInsufficientData valore di CheckAlarmInInsufficientDataState step, il passaggio predefinito èCheckMetricMismatch.

    • CheckMetricMismatch

      Verifica se le metriche utilizzate nell'allarme corrispondono al ListMetrics valore.

    • UpdateMetricMismatchChecksVariable

      Aggiorna la variabile MetricMismatchChecks con il valore MetricMismatchChecks di CheckMetricMismatch step.

    • BranchOnMetricsMatched

      Dipende dal MetricsMatched valore di CheckMetricMismatch step, il passaggio predefinito èCheckMissingDatapoint.

    • CheckMissingDatapoint

      Verifica se a una metrica mancavano i datapoint in un determinato timestamp.

    • UpdateMetricMissingDatapointsChecksVariable

      Aggiorna la variabile con il valore di step. MetricMissingDatapointsChecks MetricMissingDatapointsChecks CheckMissingDatapoint

    • BranchOnMetricMissingDatapoint

      Dipende dal MetricMissingDatapoint valore di CheckMissingDatapoint step, il passaggio predefinito èGetAlarmHistoryDetails.

    • GetAlarmHistoryDetails

      Ottiene la cronologia più recente per un determinato timestamp.

    • UpdateAlarmHistoryChecksVariable

      Aggiorna la variabile AlarmHistoryChecks con il valore AlarmHistoryChecks di GetAlarmHistoryDetails step.

    • BranchOnAlarmHistoryFound

      Dipende dal AlarmHistoryFound valore di GetAlarmHistoryDetails step, il passaggio predefinito èCheckDelayedMetric.

    • CheckDelayedMetric

      Verifica se un allarme non si è attivato a causa di una o più metriche ritardate o mancate.

    • UpdateDelayedMetricChecksVariable

      Aggiorna la variabile DelayedMetricChecks con il valore DelayedMetricChecks di CheckDelayedMetric step.

    • BranchOnMetricDelayedAndDatapointsMeetThreshold

      Segue i DatapointsMeetThreshold valori del passo MetricDelayed e del CheckDelayedMetric passo, il passaggio predefinito èGenerateReport.

    • CheckActionDelivered

      Verifica se le azioni abilitate per un allarme sono state was/were eseguite.

    • UpdateActionDeliveredChecksVariable

      Aggiorna la variabile ActionDeliveredChecks con l'output ActionDeliveredChecks di CheckActionDelivered step.

    • GenerateReport

      Compila l'output dei passaggi precedenti e genera un report.

  7. Al termine dell'esecuzione, consulta la sezione Output per i risultati dettagliati dell'esecuzione:

    • GenerateReport.Report

      Un report della metrica Amazon () fornita da Amazon CloudWatch (CloudWatch).

                    ------------------------------------------------------------------------------------------
                |                     AWS CloudWatch Alarm Troubleshooting Results                       |
                ------------------------------------------------------------------------------------------
                |     Alarm Name                        -               Demo-Alarm                       |
                |     Timestamp                         -               2025-03-04T06:31:00Z             |
                ------------------------------------------------------------------------------------------
                |     ✅ No Issue(s) Found                                                               |
                ------------------------------------------------------------------------------------------



                ==========================================================================================
                1. Validating SSM Document input parameters:
                ==========================================================================================
                ✅ [PASSED]: Found a metric alarm with name Demo-Alarm


                ==========================================================================================
                2. Checking alarm's data state:
                ==========================================================================================
                ✅ [PASSED]: The alarm is not in INSUFFICIENT_DATA state, alarm's state is: ALARM


                ==========================================================================================
                3. Checking if the alarm experienced metric mismatches:
                ==========================================================================================
                ✅ [PASSED]: Metric matches with the configured metric for Alarm.


                ==========================================================================================
                4. Checking if the alarm's metric(s) experienced missing datapoint(s):
                ==========================================================================================
                ✅ [PASSED]: Metric has datapoints


                ==========================================================================================
                5. Retrieving alarm's history for timestamp 2025-03-04T06:31:00Z:
                ==========================================================================================
                ✅ [PASSED]: Found most recent alarm history item for the provided timestamp: '2025-03-04T06:31:00Z'


                ==========================================================================================
                6. Checking if the alarm experienced metric delays or the alarm's datapoint(s) did not meet the configured threshold:
                ==========================================================================================
                ✅ [PASSED]: CloudWatch alarm did not experience any delayed metric


                ==========================================================================================
                7. Checking if the alarm has actions enabled and if action(s) were delivered:
                ==========================================================================================
                ✅ [PASSED]: Successfully executed action arn:aws:sns:us-east-1:12345678910:Demo_Alarms_Topic


                ------------------------------------------------------------------------------------------

                ✅ All the checks have passed for CloudWatch alarm, Demo-Alarm, the alarm's configuration is correct.

Riferimenti

Systems Manager Automation