Ejemplos de CloudWatch que utilizan la AWS CLI

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con CloudWatch.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Temas

Acciones

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar delete-alarms.

AWS CLI

Eliminación de una alarma

En el siguiente ejemplo, se utiliza el comando delete-alarms para eliminar la alarma de Amazon CloudWatch denominada “mialarma”:


aws cloudwatch delete-alarms --alarm-names myalarm

Salida:


This command returns to the prompt if successful.

Para obtener información de la API, consulte DeleteAlarms en la Referencia de comandos de AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-anomaly-detector.

AWS CLI

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, consulte Eliminación de un modelo de detección de anomalías en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte DeleteAnomalyDetector en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-dashboards.

AWS CLI

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, consulte Paneles de Amazon CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte DeleteDashboards en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-insight-rules.

AWS CLI

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 Uso de Información de colaboradores para analizar datos de alta cardinalidad en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte DeleteInsightRules en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-metric-stream.

AWS CLI

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, consulte Uso de flujos métricos en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte DeleteMetricStream en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-alarm-history.

AWS CLI

Recuperación del historial de una alarma

En el siguiente ejemplo, se utiliza el comando describe-alarm-history para recuperar el historial de la alarma de Amazon CloudWatch denominada “mialarma”:


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"
        }
    ]
}

Para obtener información sobre la API, consulte DescribeAlarmHistory en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-alarms-for-metric.

AWS CLI

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

En el siguiente ejemplo, se utiliza el comando describe-alarms-for-metric para mostrar información sobre las alarmas asociadas a la métrica CPUUtilization de Amazon EC2 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"
        }
    ]
}

Para obtener información sobre la API, consulte DescribeAlarmsForMetric en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-alarms.

AWS CLI

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"
        }
    ]
}

Para obtener información sobre la API, consulte DescribeAlarms en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-anomaly-detectors.

AWS CLI

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, consulte Uso de detección de anomalías de CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte DescribeAnomalyDetectors en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-insight-rules.

AWS CLI

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 Uso de Información de colaboradores para analizar datos de alta cardinalidad en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte DescribeInsightRules en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar disable-alarm-actions.

AWS CLI

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.

Para obtener información sobre la API, consulte DisableAlarmActions en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar disable-insight-rules.

AWS CLI

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 Uso de Información de colaboradores para analizar datos de alta cardinalidad en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte DisableInsightRules en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar enable-alarm-actions.

AWS CLI

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.

Para obtener información sobre las API, consulte EnableAlarmActions en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar enable-insight-rules.

AWS CLI

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 Uso de Información de colaboradores para analizar datos de alta cardinalidad en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte EnableInsightRules en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-dashboard.

AWS CLI

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, consulte Paneles de Amazon CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte GetDashboard en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-insight-rule-report.

AWS CLI

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 Uso de Información de colaboradores para analizar datos de alta cardinalidad en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte GetInsightRuleReport en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-metric-data.

AWS CLI

Ejemplo 1: Obtención del promedio total de IOPS de la instancia de EC2 especificada mediante una expresión matemática

En el siguiente ejemplo de get-metric-data, se recuperan los valores de las métricas de CloudWatch para la instancia de EC2 con InstanceID i-abcdef mediante una expresión matemática de métricas que combina las métricas EBSReadOps y 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: Supervisión de los cargos de AWS estimados mediante las métricas de facturación de CloudWatch

En el siguiente ejemplo de get-metric-data, se recupera la métrica EstimatedCharges de CloudWatch 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, consulte Uso de expresiones matemáticas con métricas de CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte GetMetricData en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-metric-statistics.

AWS CLI

Obtención de la utilización de la CPU por cada instancia de EC2

En el siguiente ejemplo, se utiliza el comando get-metric-statistics para obtener la utilización de la CPU para una instancia de EC2 con el ID 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 mediante un par nombre/valor, 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 comando get-metric-statistics, consulte Obtener estadísticas para una métrica en la Guía para desarrolladores de Amazon CloudWatch.


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

Para obtener información sobre la API, consulte GetMetricStatistics en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-metric-stream.

AWS CLI

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, consulte Uso de flujos métricos en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte GetMetricStream en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar get-metric-widget-image.

AWS CLI

Recuperación de un gráfico de instantáneas de CPUUtilization

En el siguiente ejemplo de get-metric-widget-image, se recupera un gráfico de instantáneas de la métrica CPUUtilization de la instancia de EC2 con el ID i-abcde y se guarda la imagen recuperada como archivo denominado “image.png” en la máquina 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.

Para obtener información sobre la API, consulte GetMetricWidgetImage en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-dashboards.

AWS CLI

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, consulte Paneles de Amazon CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener detalles sobre la API, consulte ListDashboards en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-metric-streams.

AWS CLI

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, consulte Uso de flujos métricos en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte ListMetricStreams en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-metrics.

AWS CLI

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"
        }
    ]
}

Para obtener información sobre la API, consulte ListMetrics en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-tags-for-resource.

AWS CLI

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, consulte Alarmas y etiquetado en la Guía del usuario de Amazon CloudWatch.

Para ver los detalles de la API, consulte ListTagsForResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-anomaly-detector.

AWS CLI

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

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


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, consulte Uso de detección de anomalías de CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte PutAnomalyDetector en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-composite-alarm.

AWS CLI

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, consulte Creación de una alarma compuesta en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte PutCompositeAlarm en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-dashboard.

AWS CLI

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, consulte Creación de un panel de CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener información acerca de la API, consulte PutDashboard en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-insight-rule.

AWS CLI

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 Creación de una regla de Información de colaboradores en CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para obtener información acerca de la API, consulte PutInsightRule en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-metric-alarm.

AWS CLI

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


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 obtener información sobre la API, consulte PutMetricAlarm en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-metric-data.

AWS CLI

Publicación de métricas personalizadas en Amazon CloudWatch

En el siguiente ejemplo, se utiliza el comando put-metric-data 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 Publicación de métricas personalizadas en la Guía para desarrolladores de Amazon CloudWatch.

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

Para obtener información sobre la API, consulte PutMetricData en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar put-metric-stream.

AWS CLI

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, consulte Configuración de un flujo métrico en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte PutMetricStream en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar set-alarm-state.

AWS CLI

Cambio temporal del estado de una alarma

En el siguiente ejemplo, se utiliza el comando set-alarm-state para cambiar temporalmente el estado de una alarma de Amazon CloudWatch denominada mialarma y configurarla con el estado ALARMA para realizar pruebas:


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.

Para obtener información sobre la API, consulte SetAlarmState en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar start-metric-streams.

AWS CLI

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, consulte Uso de flujos métricos en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte StartMetricStreams en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar stop-metric-streams.

AWS CLI

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, consulte Uso de flujos métricos en la Guía del usuario de Amazon CloudWatch.

Para obtener información sobre la API, consulte StopMetricStreams en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar tag-resource.

AWS CLI

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, consulte Etiquetado de los recursos de Amazon CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para ver los detalles de la API, consulte TagResource en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar untag-resource.

AWS CLI

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, consulte Etiquetado de los recursos de Amazon CloudWatch en la Guía del usuario de Amazon CloudWatch.

Para ver los detalles de la API, consulte UntagResource en la Referencia de comandos de la AWS CLI.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

CloudTrail

Registros de CloudWatch