# 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\$1**
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*.