# 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.
**Topics**
+ [Acciones](#actions)
## Acciones
### `delete-alarms`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-alarms.html) en la *Referencia de comandos de AWS CLI*.
### `delete-anomaly-detector`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html#Delete_Anomaly_Detection_Model) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DeleteAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-anomaly-detector.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-dashboards`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DeleteDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-dashboards.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-insight-rules`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DeleteInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-insight-rules.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-metric-stream`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DeleteMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-metric-stream.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-alarm-history`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarm-history.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-alarms-for-metric`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms-for-metric.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-alarms`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-anomaly-detectors`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DescribeAnomalyDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-anomaly-detectors.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-insight-rules`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DescribeInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-insight-rules.html) en la *Referencia de comandos de la AWS CLI*.
### `disable-alarm-actions`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-alarm-actions.html) en la *Referencia de comandos de la AWS CLI*.
### `disable-insight-rules`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [DisableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-insight-rules.html) en la *Referencia de comandos de la AWS CLI*.
### `enable-alarm-actions`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-alarm-actions.html) en la *Referencia de comandos de la AWS CLI*.
### `enable-insight-rules`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [EnableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-insight-rules.html) en la *Referencia de comandos de la AWS CLI*.
### `get-dashboard`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [GetDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-dashboard.html) en la *Referencia de comandos de la AWS CLI*.
### `get-insight-rule-report`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [GetInsightRuleReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-insight-rule-report.html) en la *Referencia de comandos de la AWS CLI*.
### `get-metric-data`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [GetMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-data.html) en la *Referencia de comandos de la AWS CLI*.
### `get-metric-statistics`
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 EC**
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-statistics.html) en la *Referencia de comandos de la AWS CLI*.
### `get-metric-stream`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [GetMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-stream.html) en la *Referencia de comandos de la AWS CLI*.
### `get-metric-widget-image`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-widget-image.html) en la *Referencia de comandos de la AWS CLI*.
### `list-dashboards`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener detalles sobre la API, consulte [ListDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-dashboards.html) en la *Referencia de comandos de la AWS CLI*.
### `list-metric-streams`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [ListMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metric-streams.html) en la *Referencia de comandos de la AWS CLI*.
### `list-metrics`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metrics.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tags-for-resource`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarms_and_tagging.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `put-anomaly-detector`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [PutAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-anomaly-detector.html) en la *Referencia de comandos de la AWS CLI*.
### `put-composite-alarm`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm_How_To.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [PutCompositeAlarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-composite-alarm.html) en la *Referencia de comandos de la AWS CLI*.
### `put-dashboard`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información acerca de la API, consulte [PutDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-dashboard.html) en la *Referencia de comandos de la AWS CLI*.
### `put-insight-rule`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-CreateRule.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información acerca de la API, consulte [PutInsightRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-insight-rule.html) en la *Referencia de comandos de la AWS CLI*.
### `put-metric-alarm`
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 mediante un par nombre/valor, 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 información sobre la API, consulte [PutMetricAlarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-alarm.html) en la *Referencia de comandos de la AWS CLI*.
### `put-metric-data`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-data.html) en la *Referencia de comandos de la AWS CLI*.
### `put-metric-stream`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-setup.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [PutMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-stream.html) en la *Referencia de comandos de la AWS CLI*.
### `set-alarm-state`
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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/set-alarm-state.html) en la *Referencia de comandos de la AWS CLI*.
### `start-metric-streams`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [StartMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/start-metric-streams.html) en la *Referencia de comandos de la AWS CLI*.
### `stop-metric-streams`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para obtener información sobre la API, consulte [StopMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/stop-metric-streams.html) en la *Referencia de comandos de la AWS CLI*.
### `tag-resource`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/tag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `untag-resource`
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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) en la *Guía del usuario de Amazon CloudWatch*.
+ Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/untag-resource.html) en la *Referencia de comandos de la AWS CLI*.