CloudWatch ejemplos que utilizan AWS CLI

Eliminación de una alarma

En el siguiente ejemplo, se utiliza el delete-alarms comando para eliminar la CloudWatch alarma de Amazon denominada «myalarm»:

aws cloudwatch delete-alarms --alarm-names myalarm

Salida:

This command returns to the prompt if successful.

Eliminación de un modelo de detección de anomalías especificado

En el siguiente ejemplo de delete-anomaly-detector, se elimina un modelo de detector de anomalías de la cuenta especificada.

aws cloudwatch delete-anomaly-detector \
    --namespace AWS/Logs \
    --metric-name IncomingBytes \
    --stat SampleCount

Este comando no genera ninguna salida.

Para obtener más información, consulta Eliminar un modelo de detección de anomalías en la Guía del CloudWatch usuario de Amazon.

Eliminación de paneles especificados

En el siguiente ejemplo de delete-dashboards, se eliminan dos paneles denominados Dashboard-A y Dashboard-B de la cuenta especificada.

aws cloudwatch delete-dashboards \
    --dashboard-names Dashboard-A Dashboard-B

Este comando no genera ninguna salida.

Para obtener más información, consulta los CloudWatch paneles de Amazon en la Guía del CloudWatch usuario de Amazon.

Eliminación de las reglas de Información de colaboradores especificadas

En el siguiente ejemplo de delete-insight-rules, se eliminan dos reglas de Información de colaboradores denominadas Rule-A y Rule-B en la cuenta especificada.

aws cloudwatch delete-insight-rules \
    --rule-names Rule-A Rule-B

Salida:

{
    "Failures": []
}

Para obtener más información, consulte Utilizar Contributor Insights para analizar datos de alta cardinalidad en la Guía CloudWatch del usuario de Amazon.

Eliminación de un flujo de métricas específico

En el siguiente ejemplo de delete-metric-stream, se elimina el flujo métrico denominado QuickPartial-gSCKvO en la cuenta especificada.

aws cloudwatch delete-metric-stream \
    --name QuickPartial-gSCKvO

Este comando no genera ninguna salida.

Para obtener más información, consulta Usar flujos de métricas en la Guía del CloudWatch usuario de Amazon.

Recuperación del historial de una alarma

En el siguiente ejemplo, se utiliza el describe-alarm-history comando para recuperar el historial de la CloudWatch alarma de Amazon denominada «myalarm»:

aws cloudwatch describe-alarm-history --alarm-name "myalarm" --history-item-type StateUpdate

Salida:

{
    "AlarmHistoryItems": [
        {
            "Timestamp": "2014-04-09T18:59:06.442Z",
            "HistoryItemType": "StateUpdate",
            "AlarmName": "myalarm",
            "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"},\"newState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}}}",
            "HistorySummary": "Alarm updated from ALARM to OK"
        },
        {
            "Timestamp": "2014-04-09T18:59:05.805Z",
            "HistoryItemType": "StateUpdate",
            "AlarmName": "myalarm",
            "HistoryData": "{\"version\":\"1.0\",\"oldState\":{\"stateValue\":\"OK\",\"stateReason\":\"Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.839999999999996, 39.714].\",\"stateReasonData\":{\"version\":\"1.0\",\"queryDate\":\"2014-03-11T22:45:41.569+0000\",\"startDate\":\"2014-03-11T22:30:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.839999999999996,39.714],\"threshold\":70.0}},\"newState\":{\"stateValue\":\"ALARM\",\"stateReason\":\"testing purposes\"}}",
            "HistorySummary": "Alarm updated from OK to ALARM"
        }
    ]
}

Visualización de información sobre las alarmas asociadas a una métrica

En el siguiente ejemplo, se usa el describe-alarms-for-metric comando para mostrar información sobre cualquier alarma asociada a la EC2 CPUUtilization métrica de Amazon y a la instancia con el ID i-0c986c72. :

aws cloudwatch describe-alarms-for-metric --metric-name CPUUtilization --namespace AWS/EC2 --dimensions Name=InstanceId,Value=i-0c986c72

Salida:

{
    "MetricAlarms": [
        {
            "EvaluationPeriods": 10,
            "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm2",
            "StateUpdatedTimestamp": "2013-10-30T03:03:51.479Z",
            "AlarmConfigurationUpdatedTimestamp": "2013-10-30T03:03:50.865Z",
            "ComparisonOperator": "GreaterThanOrEqualToThreshold",
            "AlarmActions": [
                "arn:aws:sns:us-east-1:111122223333:NotifyMe"
            ],
            "Namespace": "AWS/EC2",
            "AlarmDescription": "CPU usage exceeds 70 percent",
            "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2013-10-30T03:03:51.479+0000\",\"startDate\":\"2013-10-30T02:08:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[40.698,39.612,42.432,39.796,38.816,42.28,42.854,40.088,40.760000000000005,41.316],\"threshold\":70.0}",
            "Period": 300,
            "StateValue": "OK",
            "Threshold": 70.0,
            "AlarmName": "myHighCpuAlarm2",
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "i-0c986c72"
                }
            ],
            "Statistic": "Average",
            "StateReason": "Threshold Crossed: 10 datapoints were not greater than or equal to the threshold (70.0). The most recent datapoints: [40.760000000000005, 41.316].",
            "InsufficientDataActions": [],
            "OKActions": [],
            "ActionsEnabled": true,
            "MetricName": "CPUUtilization"
        },
        {
            "EvaluationPeriods": 2,
            "AlarmArn": "arn:aws:cloudwatch:us-east-1:111122223333:alarm:myHighCpuAlarm",
            "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z",
            "AlarmConfigurationUpdatedTimestamp": "2014-04-09T22:26:05.958Z",
            "ComparisonOperator": "GreaterThanThreshold",
            "AlarmActions": [
                "arn:aws:sns:us-east-1:111122223333:HighCPUAlarm"
            ],
            "Namespace": "AWS/EC2",
            "AlarmDescription": "CPU usage exceeds 70 percent",
            "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}",
            "Period": 300,
            "StateValue": "OK",
            "Threshold": 70.0,
            "AlarmName": "myHighCpuAlarm",
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "i-0c986c72"
                }
            ],
            "Statistic": "Average",
            "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].",
            "InsufficientDataActions": [],
            "OKActions": [],
            "ActionsEnabled": false,
            "MetricName": "CPUUtilization"
        }
    ]
}

Visualización de información acerca de una alarma

En el siguiente ejemplo, se utiliza el comando describe-alarms para proporcionar información sobre la alarma denominada “mialarma”:

aws cloudwatch describe-alarms --alarm-names "myalarm"

Salida:

{
    "MetricAlarms": [
        {
            "EvaluationPeriods": 2,
            "AlarmArn": "arn:aws:cloudwatch:us-east-1:123456789012:alarm:myalarm",
            "StateUpdatedTimestamp": "2014-04-09T18:59:06.442Z",
            "AlarmConfigurationUpdatedTimestamp": "2012-12-27T00:49:54.032Z",
            "ComparisonOperator": "GreaterThanThreshold",
            "AlarmActions": [
                "arn:aws:sns:us-east-1:123456789012:myHighCpuAlarm"
            ],
            "Namespace": "AWS/EC2",
            "AlarmDescription": "CPU usage exceeds 70 percent",
            "StateReasonData": "{\"version\":\"1.0\",\"queryDate\":\"2014-04-09T18:59:06.419+0000\",\"startDate\":\"2014-04-09T18:44:00.000+0000\",\"statistic\":\"Average\",\"period\":300,\"recentDatapoints\":[38.958,40.292],\"threshold\":70.0}",
            "Period": 300,
            "StateValue": "OK",
            "Threshold": 70.0,
            "AlarmName": "myalarm",
            "Dimensions": [
                {
                    "Name": "InstanceId",
                    "Value": "i-0c986c72"
                }
            ],
            "Statistic": "Average",
            "StateReason": "Threshold Crossed: 2 datapoints were not greater than the threshold (70.0). The most recent datapoints: [38.958, 40.292].",
            "InsufficientDataActions": [],
            "OKActions": [],
            "ActionsEnabled": true,
            "MetricName": "CPUUtilization"
        }
    ]
}

Recuperación de una lista de modelos de detección de anomalías

En el siguiente ejemplo de describe-anomaly-detectors se muestra información sobre los modelos de detectores de anomalías que están asociados al espacio de nombres de AWS/Logs en la cuenta especificada.

aws cloudwatch describe-anomaly-detectors \
    --namespace AWS/Logs

Salida:

{
    "AnomalyDetectors": [
        {
            "Namespace": "AWS/Logs",
            "MetricName": "IncomingBytes",
            "Dimensions": [],
            "Stat": "SampleCount",
            "Configuration": {
                "ExcludedTimeRanges": []
            },
            "StateValue": "TRAINED",
            "SingleMetricAnomalyDetector": {
                "AccountId": "123456789012",
                "Namespace": "AWS/Logs",
                "MetricName": "IncomingBytes",
                "Dimensions": [],
                "Stat": "SampleCount"
            }
        },
        {
            "Namespace": "AWS/Logs",
            "MetricName": "IncomingBytes",
            "Dimensions": [
                {
                    "Name": "LogGroupName",
                    "Value": "demo"
                }
            ],
            "Stat": "Average",
            "Configuration": {
                "ExcludedTimeRanges": []
            },
            "StateValue": "PENDING_TRAINING",
            "SingleMetricAnomalyDetector": {
                "AccountId": "123456789012",
                "Namespace": "AWS/Logs",
                "MetricName": "IncomingBytes",
                "Dimensions": [
                    {
                        "Name": "LogGroupName",
                        "Value": "demo"
                    }
                ],
                "Stat": "Average"
            }
        }
    ]
}

Para obtener más información, consulta Uso de la detección de CloudWatch anomalías en la Guía del CloudWatch usuario de Amazon.

Recuperación de una lista de reglas de Información de colaboradores

En el siguiente ejemplo de describe-insight-rules, se muestran todas las reglas de Información de colaboradores en la cuenta especificada.

aws cloudwatch describe-insight-rules

Salida:

{
    "InsightRules": [
        {
            "Name": "Rule-A",
            "State": "ENABLED",
            "Schema": "CloudWatchLogRule/1",
            "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo\"\n\t]\n}",
            "ManagedRule": false
        },
        {
            "Name": "Rule-B",
            "State": "ENABLED",
            "Schema": "CloudWatchLogRule/1",
            "Definition": "{\n\t\"AggregateOn\": \"Count\",\n\t\"Contribution\": {\n\t\t\"Filters\": [],\n\t\t\"Keys\": [\n\t\t\t\"$.requestId\"\n\t\t]\n\t},\n\t\"LogFormat\": \"JSON\",\n\t\"Schema\": {\n\t\t\"Name\": \"CloudWatchLogRule\",\n\t\t\"Version\": 1\n\t},\n\t\"LogGroupARNs\": [\n\t\t\"arn:aws:logs:us-east-1:123456789012:log-group:demo-1\"\n\t]\n}",
            "ManagedRule": false
        }
    ]
}

Para obtener más información, consulte Utilizar Contributor Insights para analizar datos de alta cardinalidad en la Guía CloudWatch del usuario de Amazon.

Desactivación de acciones en una alarma

En el siguiente ejemplo, se utiliza el comando disable-alarm-actions para deshabilitar todas las acciones de la alarma denominada mialarma:

aws cloudwatch disable-alarm-actions --alarm-names myalarm

Este comando vuelve a la petición si se ejecuta correctamente.

Desactivación de las reglas de Información de colaboradores especificadas

En el siguiente ejemplo de disable-insight-rules, se desactivan dos reglas de Información de colaboradores denominadas Rule-A y Rule-B en la cuenta especificada.

aws cloudwatch disable-insight-rules \
    --rule-names Rule-A Rule-B

Salida:

{
    "Failures": []
}

Para obtener más información, consulte Utilizar Contributor Insights para analizar datos de alta cardinalidad en la Guía CloudWatch del usuario de Amazon.

Activación de todas las acciones de una alarma

En el siguiente ejemplo, se utiliza el comando enable-alarm-actions para activar todas las acciones de la alarma denominada myalarm.:

aws cloudwatch enable-alarm-actions --alarm-names myalarm

Este comando vuelve a la petición si se ejecuta correctamente.

Habilitación de las reglas de Información de colaboradores especificadas

En el siguiente ejemplo de enable-insight-rules, se habilitan dos reglas de Información de colaboradores denominadas Rule-A y Rule-B en la cuenta especificada.

aws cloudwatch enable-insight-rules \
    --rule-names Rule-A Rule-B

Salida:

{
    "Failures": []
}

Para obtener más información, consulte Utilizar Contributor Insights para analizar datos de alta cardinalidad en la Guía CloudWatch del usuario de Amazon.

Recuperación de información sobre un panel

En el siguiente ejemplo de get-dashboard se muestra información acerca del panel denominado Dashboard-A en la cuenta especificada.

aws cloudwatch get-dashboard \
    --dashboard-name Dashboard-A

Salida:

{
    "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
    "DashboardBody": "{\"widgets\":[{\"type\":\"metric\",\"x\":0,\"y\":0,\"width\":6,\"height\":6,\"properties\":{\"view\":\"timeSeries\",\"stacked\":false,\"metrics\":[[\"AWS/EC2\",\"NetworkIn\",\"InstanceId\",\"i-0131f062232ade043\"],[\".\",\"NetworkOut\",\".\",\".\"]],\"region\":\"us-east-1\"}}]}",
    "DashboardName": "Dashboard-A"
}

Para obtener más información, consulta los CloudWatch paneles de Amazon en la Guía del CloudWatch usuario de Amazon.

Recuperación de datos de serie temporal recopilados por una regla de Información de colaboradores

En el siguiente ejemplo de get-insight-rule-report, se devuelven los datos de serie temporal recopilados por una regla de Información de colaboradores.

aws cloudwatch get-insight-rule-report \
    --rule-name Rule-A \
    --start-time 2024-10-13T20:15:00Z \
    --end-time 2024-10-13T20:30:00Z \
    --period 300

Salida:

{
    "KeyLabels": [
        "PartitionKey"
    ],
    "AggregationStatistic": "Sum",
    "AggregateValue": 0.5,
    "ApproximateUniqueCount": 1,
    "Contributors": [
        {
            "Keys": [
                "RequestID"
            ],
            "ApproximateAggregateValue": 0.5,
            "Datapoints": [
                {
                    "Timestamp": "2024-10-13T21:00:00+00:00",
                    "ApproximateValue": 0.5
                }
            ]
        }
    ],
    "RuleAttributes": []
}

Para obtener más información, consulte Utilizar Contributor Insights para analizar datos de alta cardinalidad en la Guía CloudWatch del usuario de Amazon.

Ejemplo 1: Para obtener el promedio total de IOPS del especificado EC2 mediante una expresión matemática

En el siguiente get-metric-data ejemplo, se recuperan los valores de las CloudWatch métricas de la EC2 instancia con i-abcdef instanceID mediante una expresión matemática métrica que combina métricas y métricas. EBSReadOps EBSWriteOps

aws cloudwatch get-metric-data \
    --metric-data-queries file://file.json \
    --start-time 2024-09-29T22:10:00Z \
    --end-time 2024-09-29T22:15:00Z

Contenido de file.json:

[
    {
        "Id": "m3",
        "Expression": "(m1+m2)/300",
        "Label": "Avg Total IOPS"
    },
    {
        "Id": "m1",
        "MetricStat": {
            "Metric": {
                "Namespace": "AWS/EC2",
                "MetricName": "EBSReadOps",
                "Dimensions": [
                    {
                        "Name": "InstanceId",
                        "Value": "i-abcdef"
                    }
                ]
            },
            "Period": 300,
            "Stat": "Sum",
            "Unit": "Count"
        },
        "ReturnData": false
    },
    {
        "Id": "m2",
        "MetricStat": {
            "Metric": {
                "Namespace": "AWS/EC2",
                "MetricName": "EBSWriteOps",
                "Dimensions": [
                    {
                        "Name": "InstanceId",
                        "Value": "i-abcdef"
                    }
                ]
            },
            "Period": 300,
            "Stat": "Sum",
            "Unit": "Count"
        },
        "ReturnData": false
    }
]

Salida:

{
    "MetricDataResults": [
        {
            "Id": "m3",
            "Label": "Avg Total IOPS",
            "Timestamps": [
                "2024-09-29T22:10:00+00:00"
            ],
            "Values": [
                96.85
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}

Ejemplo 2: Supervisar los cargos estimados mediante métricas de facturación AWS CloudWatch

En el siguiente get-metric-data ejemplo, se recupera una EstimatedCharges CloudWatch métrica del espacio de nombres AWS/Billing.

aws cloudwatch get-metric-data \
    --metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/Billing","MetricName":"EstimatedCharges","Dimensions":[{"Name":"Currency","Value":"USD"}]},"Period":21600,"Stat":"Maximum"}}]' \
    --start-time 2024-09-26T12:00:00Z \
    --end-time 2024-09-26T18:00:00Z \
    --region us-east-1

Salida:

{
    "MetricDataResults": [
        {
            "Id": "m1",
            "Label": "EstimatedCharges",
            "Timestamps": [
                "2024-09-26T12:00:00+00:00"
            ],
            "Values": [
                542.38
            ],
            "StatusCode": "Complete"
        }
    ],
    "Messages": []
}

Para obtener más información, consulta Uso de expresiones matemáticas con CloudWatch métricas en la Guía del CloudWatch usuario de Amazon.

Para obtener el uso de la CPU por EC2 instancia

En el siguiente ejemplo, se usa el get-metric-statistics comando para obtener el uso de la CPU de una EC2 instancia con el identificador i-abcdef.

aws cloudwatch get-metric-statistics --metric-name CPUUtilization --start-time 2014-04-08T23:18:00Z --end-time 2014-04-09T23:18:00Z --period 3600 --namespace AWS/EC2 --statistics Maximum --dimensions Name=InstanceId,Value=i-abcdef

Salida:

{
    "Datapoints": [
        {
            "Timestamp": "2014-04-09T11:18:00Z",
            "Maximum": 44.79,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T20:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T19:18:00Z",
            "Maximum": 50.85,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T09:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T03:18:00Z",
            "Maximum": 76.84,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T21:18:00Z",
            "Maximum": 48.96,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T14:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T08:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T16:18:00Z",
            "Maximum": 45.55,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T06:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T13:18:00Z",
            "Maximum": 45.08,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T05:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T18:18:00Z",
            "Maximum": 46.88,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T17:18:00Z",
            "Maximum": 52.08,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T07:18:00Z",
            "Maximum": 47.92,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T02:18:00Z",
            "Maximum": 51.23,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T12:18:00Z",
            "Maximum": 47.67,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-08T23:18:00Z",
            "Maximum": 46.88,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T10:18:00Z",
            "Maximum": 51.91,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T04:18:00Z",
            "Maximum": 47.13,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T15:18:00Z",
            "Maximum": 48.96,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T00:18:00Z",
            "Maximum": 48.16,
            "Unit": "Percent"
        },
        {
            "Timestamp": "2014-04-09T01:18:00Z",
            "Maximum": 49.18,
            "Unit": "Percent"
        }
    ],
    "Label": "CPUUtilization"
}

Especificación de varias dimensiones

En el siguiente ejemplo, se ilustra cómo especificar varias dimensiones. Cada dimensión se especifica como un Name/Value par, con una coma entre el nombre y el valor. Cuando existen varias dimensiones se separan con un espacio. Si una métrica incluye varias dimensiones, debe especificar un valor para cada dimensión definida.

Para ver más ejemplos del uso del get-metric-statistics comando, consulta Obtener estadísticas para una métrica en la Guía para CloudWatch desarrolladores de Amazon.

aws cloudwatch get-metric-statistics --metric-name Buffers --namespace MyNameSpace --dimensions Name=InstanceID,Value=i-abcdef Name=InstanceType,Value=m1.small --start-time 2016-10-15T04:00:00Z --end-time 2016-10-19T07:00:00Z --statistics Average --period 60

Recuperación de información sobre un flujo métrico

En el siguiente ejemplo de get-metric-stream, se muestra información acerca del flujo métrico denominado QuickFull-GuaFbs en la cuenta especificada.

aws cloudwatch get-metric-stream \
    --name QuickFull-GuaFbs

Salida:

{
    "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
    "Name": "QuickFull-GuaFbs",
    "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
    "RoleArn": "arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3",
    "State": "running",
    "CreationDate": "2024-10-11T18:48:59.187000+00:00",
    "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
    "OutputFormat": "json",
    "IncludeLinkedAccountsMetrics": false
}

Para obtener más información, consulta Usar flujos de métricas en la Guía del CloudWatch usuario de Amazon.

Para recuperar un gráfico instantáneo de CPUUtilization

En el siguiente get-metric-widget-image ejemplo, se recupera el gráfico de instantáneas CPUUtilization de la métrica de la EC2 instancia con el ID i-abcde y se guarda la imagen recuperada como un archivo denominado "image.png" en el equipo local.

aws cloudwatch get-metric-widget-image \
    --metric-widget '{"metrics":[["AWS/EC2","CPUUtilization","InstanceId","i-abcde"]]}' \
    --output-format png \
    --output text | base64 --decode > image.png

Este comando no genera ninguna salida.

Recuperación de una lista de paneles

En el siguiente ejemplo de list-dashboards, se enumeran todos los paneles de la cuenta especificada.

aws cloudwatch list-dashboards

Salida:

{
    "DashboardEntries": [
        {
            "DashboardName": "Dashboard-A",
            "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-A",
            "LastModified": "2024-10-11T18:40:11+00:00",
            "Size": 271
        },
        {
            "DashboardName": "Dashboard-B",
            "DashboardArn": "arn:aws:cloudwatch::123456789012:dashboard/Dashboard-B",
            "LastModified": "2024-10-11T18:44:41+00:00",
            "Size": 522
        }
    ]
}

Para obtener más información, consulta los CloudWatch paneles de Amazon en la Guía del CloudWatch usuario de Amazon.

Recuperación de una lista de flujos métricos

En el siguiente ejemplo de list-metric-streams, se muestran todos los flujos métricos de la cuenta especificada.

aws cloudwatch list-metric-streams

Salida:

{
    "Entries": [
        {
            "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs",
            "CreationDate": "2024-10-11T18:48:59.187000+00:00",
            "LastUpdateDate": "2024-10-11T18:48:59.187000+00:00",
            "Name": "QuickFull-GuaFbs",
            "FirehoseArn": "arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG",
            "State": "running",
            "OutputFormat": "json"
        }
    ]
}

Para obtener más información, consulta Usar flujos de métricas en la Guía del CloudWatch usuario de Amazon.

Creación de una lista de las métricas de Amazon SNS

En el siguiente ejemplo de list-metrics, se muestran las métricas de Amazon SNS.

aws cloudwatch list-metrics \
    --namespace "AWS/SNS"

Salida:

{
    "Metrics": [
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "PublishSize"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "PublishSize"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "NumberOfNotificationsFailed"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "NumberOfNotificationsDelivered"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "NotifyMe"
                }
            ],
            "MetricName": "NumberOfMessagesPublished"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "NumberOfMessagesPublished"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "NumberOfNotificationsDelivered"
        },
        {
            "Namespace": "AWS/SNS",
            "Dimensions": [
                {
                    "Name": "TopicName",
                    "Value": "CFO"
                }
            ],
            "MetricName": "NumberOfNotificationsFailed"
        }
    ]
}

Muestra de las etiquetas asociadas a una alarma existente*

En el siguiente ejemplo de list-tags-for-resource, se muestran todas las etiquetas asociadas a una alarma denominada demo en la cuenta especificada.

aws cloudwatch list-tags-for-resource \
    --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo

Salida:

{
    "Tags": [
        {
            "Key": "stack",
            "Value": "Production"
        },
        {
            "Key": "team",
            "Value": "Devops"
        }
    ]
}

Para obtener más información, consulta Alarmas y etiquetado en la Guía del CloudWatch usuario de Amazon.

Creación de un modelo de detección de anomalías

En el siguiente put-anomaly-detector ejemplo, se crea un modelo de detección de anomalías para una CloudWatch métrica.

aws cloudwatch put-anomaly-detector \
    --namespace AWS/Logs \
    --metric-name IncomingBytes \
    --stat SampleCount

Este comando no genera ninguna salida.

Para obtener más información, consulta Uso de la detección de CloudWatch anomalías en la Guía del CloudWatch usuario de Amazon.

Creación de una alarma compuesta de CloudWatch

En el siguiente ejemplo de put-composite-alarm, se crea una alarma compuesta denominada ProdAlarm en la cuenta especificada.

aws cloudwatch put-composite-alarm \
    --alarm-name ProdAlarm \
    --alarm-rule "ALARM(CPUUtilizationTooHigh) AND ALARM(MemUsageTooHigh)" \
    --alarm-actions arn:aws:sns:us-east-1:123456789012:demo \
    --actions-enabled

Este comando no genera ninguna salida.

Para obtener más información, consulta Cómo crear una alarma compuesta en la Guía del CloudWatch usuario de Amazon.

Para crear un panel

En el siguiente ejemplo de put-dashboard, se crea un panel denominado Dashboard-A en la cuenta especificada.

aws cloudwatch put-dashboard \
    --dashboard-name Dashboard-A \
    --dashboard-body '{"widgets":[{"height":6,"width":6,"y":0,"x":0,"type":"metric","properties":{"view":"timeSeries","stacked":false,"metrics":[["Namespace","CPUUtilization","Environment","Prod","Type","App"]],"region":"us-east-1"}}]}'

Salida:

{
    "DashboardValidationMessages": []
}

Para obtener más información, consulta Cómo crear un CloudWatch panel de control en la Guía del CloudWatch usuario de Amazon.

Creación de una regla de Información de colaboradores

En el siguiente ejemplo de put-insight-rule, se crea una regla de Información de colaboradores denominada VPCFlowLogsContributorInsights en la cuenta especificada.

aws cloudwatch put-insight-rule \
    --rule-name VPCFlowLogsContributorInsights \
    --rule-definition file://insight-rule.json \
    --rule-state ENABLED

Contenido de insight-rule.json:

{
    "Schema": {
        "Name": "CloudWatchLogRule",
        "Version": 1
    },
    "AggregateOn": "Count",
    "Contribution": {
        "Filters": [],
        "Keys": [
            "tcp-flag"
        ]
    },
    "LogFormat": "CLF",
    "LogGroupNames": [
        "/vpc/flowlogs/*"
    ],
    "Fields": {
        "23": "tcp-flag"
    }
}

Este comando no genera ninguna salida.

Para obtener más información, consulte Crear una regla de Contributor Insights CloudWatch en la Guía del CloudWatch usuario de Amazon.

Envío de un mensaje por correo electrónico de Amazon Simple Notification Service cuando el uso de la CPU supere el 70 por ciento

El siguiente ejemplo usa el comando put-metric-alarm para enviar un mensaje por correo electrónico de Amazon Simple Notification Service cuando el uso de la CPU supere el 70 por ciento:

aws cloudwatch put-metric-alarm --alarm-name cpu-mon --alarm-description "Alarm when CPU exceeds 70 percent" --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 70 --comparison-operator GreaterThanThreshold  --dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 --alarm-actions arn:aws:sns:us-east-1:111122223333:MyTopic --unit Percent

Este comando vuelve a la petición si se ejecuta correctamente. Si existe una alarma con el mismo nombre, la alarma nueva la sobrescribirá.

Especificación de varias dimensiones

En el siguiente ejemplo, se ilustra cómo especificar varias dimensiones. Cada dimensión se especifica como un Name/Value par, con una coma entre el nombre y el valor. Cuando existen varias dimensiones se separan con un espacio:

aws cloudwatch put-metric-alarm --alarm-name "Default_Test_Alarm3" --alarm-description "The default example alarm" --namespace "CW EXAMPLE METRICS" --metric-name Default_Test --statistic Average --period 60 --evaluation-periods 3 --threshold 50 --comparison-operator GreaterThanOrEqualToThreshold --dimensions Name=key1,Value=value1 Name=key2,Value=value2

Para publicar una métrica personalizada en Amazon CloudWatch

En el siguiente ejemplo, se utiliza el put-metric-data comando para publicar una métrica personalizada en Amazon CloudWatch:

aws cloudwatch put-metric-data --namespace "Usage Metrics" --metric-data file://metric.json

Los valores de la métrica en sí se almacenan en el archivo JSON, metric.json.

A continuación, se muestra el contenido de ese archivo:

[
  {
    "MetricName": "New Posts",
    "Timestamp": "Wednesday, June 12, 2013 8:28:20 PM",
    "Value": 0.50,
    "Unit": "Count"
  }
]

Para obtener más información, consulte Publicar métricas personalizadas en la Guía para CloudWatch desarrolladores de Amazon.

Cómo especificar varias dimensiones

En el siguiente ejemplo, se ilustra cómo especificar varias dimensiones. Cada dimensión se especifica con un par Nombre=Valor. Cuando existen varias dimensiones se separan con una coma:

aws cloudwatch put-metric-data --metric-name Buffers --namespace MyNameSpace --unit Bytes --value 231434333 --dimensions InstanceID=1-23456789,InstanceType=m1.small

Creación de un flujo métrico

En el siguiente ejemplo de put-metric-stream, se crea un flujo métrico denominado QuickFull-GuaFb en la cuenta especificada.

aws cloudwatch put-metric-stream \
    --name QuickFull-GuaFbs \
    --firehose-arn arn:aws:firehose:us-east-1:123456789012:deliverystream/MetricStreams-QuickFull-GuaFbs-WnySbECG \
    --role-arn arn:aws:iam::123456789012:role/service-role/MetricStreams-FirehosePutRecords-JN10W9B3 \
    --output-format json \
    --no-include-linked-accounts-metrics

Salida:

{
    "Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs"
}

Para obtener más información, consulta Cómo configurar un flujo de métricas en la Guía del CloudWatch usuario de Amazon.

Cambio temporal del estado de una alarma

En el siguiente ejemplo, se utiliza el set-alarm-state comando para cambiar temporalmente el estado de una CloudWatch alarma de Amazon denominada «myalarm» y establecerla en el estado ALARM con fines de prueba:

aws cloudwatch set-alarm-state --alarm-name "myalarm" --state-value ALARM --state-reason "testing purposes"

Este comando vuelve a la petición si se ejecuta correctamente.

Inicio de un flujo métrico específico

En el siguiente ejemplo de start-metric-streams, se inicia el flujo métrico denominado QuickFull-GuaFbs en la cuenta especificada.

aws cloudwatch start-metric-streams \
    --names QuickFull-GuaFbs

Este comando no genera ninguna salida.

Para obtener más información, consulta Usar flujos de métricas en la Guía del CloudWatch usuario de Amazon.

Detención de un flujo métrico específico

En el siguiente ejemplo de stop-metric-streams, se detiene el flujo métrico denominado QuickFull-GuaFbs en la cuenta especificada.

aws cloudwatch stop-metric-streams \
    --names QuickFull-GuaFbs

Este comando no genera ninguna salida.

Para obtener más información, consulta Usar flujos de métricas en la Guía del CloudWatch usuario de Amazon.

Agregación de una o varias etiquetas a un recurso especificado

En el siguiente ejemplo de tag-resource, se agregan 2 etiquetas a la alarma de Cloudwatch denominada demo en la cuenta especificada.

aws cloudwatch tag-resource \
    --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
    --tags Key=stack,Value=Production Key=team,Value=Devops

Este comando no genera ninguna salida.

Para obtener más información, consulta Cómo etiquetar tus CloudWatch recursos de Amazon en la Guía del CloudWatch usuario de Amazon.

Eliminación de una o varias etiquetas del recurso especificado

En el siguiente ejemplo de untag-resource, se eliminan 2 etiquetas de la alarma de Cloudwatch denominada demo en la cuenta especificada.

aws cloudwatch untag-resource \
    --resource-arn arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo \
    --tag-keys stack team

Este comando no genera ninguna salida.

Para obtener más información, consulta Cómo etiquetar tus CloudWatch recursos de Amazon en la Guía del CloudWatch usuario de Amazon.