View a markdown version of this page

CloudWatch ejemplos que utilizan AWS CLI - AWS Ejemplos de código de SDK
Acciones

Hay más ejemplos de AWS SDK disponibles en el repositorio de ejemplos de AWS Doc SDK. GitHub

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CloudWatch ejemplos que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de AWS Command Line Interface with 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.

Acciones

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

AWS CLI

Eliminación de una alarma

El siguiente ejemplo usa el delete-alarms comando para eliminar la alarma de Amazon denominada « CloudWatch myalarm»:

aws cloudwatch delete-alarms --alarm-names myalarm

Salida:

This command returns to the prompt if successful.

  • Para obtener más información sobre la API, consulta la sección DeleteAlarms de referencia de AWS CLI comandos.

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

  • Para obtener más información sobre la API, consulte la sección DeleteAnomalyDetector de referencia de AWS CLI comandos.

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 los CloudWatch paneles de control de Amazon en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte DeleteDashboards la referencia de AWS CLI comandos.

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 la Guía del usuario de Amazon sobre cómo usar las estadísticas de los colaboradores para analizar datos de alta cardinalidad. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de DeleteInsightRules referencia de AWS CLI comandos.

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

  • Para obtener más información sobre la API, consulte DeleteMetricStream la Referencia de AWS CLI comandos.

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 usa el describe-alarm-history comando para recuperar el historial de la alarma de Amazon CloudWatch 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"
        }
    ]
}

  • Para obtener más información sobre la API, consulta la sección DescribeAlarmHistory de referencia de AWS CLI comandos.

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

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 más información sobre la API, consulte la Referencia de DescribeAlarms comandos 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 la detección de CloudWatch anomalías en la Guía del usuario de Amazon. CloudWatch

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 la Guía del usuario de Amazon sobre cómo usar las estadísticas de los colaboradores para analizar datos de alta cardinalidad. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de DescribeInsightRules referencia de AWS CLI comandos.

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 más información sobre la API, consulte la Referencia de comandos. DisableAlarmActions 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 la Guía del usuario de Amazon sobre cómo usar las estadísticas de los colaboradores para analizar datos de alta cardinalidad. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de DisableInsightRules referencia de AWS CLI comandos.

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 más información sobre la API, consulte la Referencia de comandos. EnableAlarmActions 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 las estadísticas de los colaboradores para analizar datos de alta cardinalidad en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte EnableInsightRules AWS CLI Command Reference.

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

  • Para obtener más información sobre la API, consulte GetDashboard la referencia de AWS CLI comandos.

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 la Guía del usuario de Amazon sobre cómo usar las estadísticas de los colaboradores para analizar datos de alta cardinalidad. CloudWatch

  • Para obtener más información sobre la API, consulte la sección de GetInsightRuleReport referencia de AWS CLI comandos.

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 get-metric-data ejemplo, se recuperan los valores CloudWatch métricos de la instancia EC2 con InstanceID i-abcdef 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: Para supervisar los cargos estimados mediante las métricas de facturación AWS CloudWatch

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

  • Para obtener más información sobre la API, consulte GetMetricData la sección de referencia de AWS CLI comandos.

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 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 sobre el uso del get-metric-statistics comando, consulte 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

  • Para obtener más información sobre la API, consulte GetMetricStatistics la referencia de AWS CLI comandos.

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

  • Para obtener más información sobre la API, consulte GetMetricStream la Referencia de AWS CLI comandos.

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 más información sobre la API, consulte la Referencia de comandos. GetMetricWidgetImage 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 los CloudWatch paneles de Amazon en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte ListDashboards la referencia de AWS CLI comandos.

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

  • Para obtener más información sobre la API, consulte ListMetricStreams la Referencia de AWS CLI comandos.

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 más información sobre la API, consulte la Referencia ListMetrics de AWS CLI comandos.

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 CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulte la sección ListTagsForResource de referencia de AWS CLI comandos.

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

El siguiente put-anomaly-detector ejemplo crea un modelo de detección de anomalías para una métrica. 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 la detección de CloudWatch anomalías en la Guía del CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulte la sección PutAnomalyDetector de referencia de AWS CLI comandos.

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 Crear una alarma compuesta en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte PutCompositeAlarm la sección de referencia de AWS CLI comandos.

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 CloudWatch panel de control en la Guía del CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulte PutDashboard la sección de referencia de AWS CLI comandos.

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 Crear una regla sobre las estadísticas de los colaboradores CloudWatch en la Guía del usuario de Amazon. CloudWatch

  • Para obtener más información sobre la API, consulte PutInsightRule la sección AWS CLI Command Reference.

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

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

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

AWS CLI

Para publicar una métrica personalizada en Amazon CloudWatch

En el siguiente ejemplo, se usa 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 la publicación de 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

  • Para obtener más información sobre la API, consulte PutMetricData la sección de referencia de AWS CLI comandos.

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

  • Para obtener más información sobre la API, consulte PutMetricStream la sección de referencia de AWS CLI comandos.

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 usa el set-alarm-state comando para cambiar temporalmente el estado de una alarma de Amazon denominada « CloudWatch myalarm» y configurarla 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.

  • Para obtener más información sobre la API, consulte SetAlarmState la Referencia de AWS CLI comandos.

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

  • Para obtener más información sobre la API, consulte StartMetricStreams la Referencia de AWS CLI comandos.

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

  • Para obtener más información sobre la API, consulte StopMetricStreams la Referencia de AWS CLI comandos.

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, consulta Cómo etiquetar tus CloudWatch recursos de Amazon en la Guía del CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulta la sección TagResource de referencia de AWS CLI comandos.

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, consulta Cómo etiquetar tus CloudWatch recursos de Amazon en la Guía del CloudWatch usuario de Amazon.

  • Para obtener más información sobre la API, consulta la sección UntagResource de referencia de AWS CLI comandos.