# Exemplos do CloudWatch usando o AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o CloudWatch.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `delete-alarms`
O código de exemplo a seguir mostra como usar `delete-alarms`.
**AWS CLI**
**Como excluir um alarme**
O seguinte exemplo usa o comando `delete-alarms` para excluir o alarme “myalarm” do Amazon CloudWatch:
```
aws cloudwatch delete-alarms --alarm-names {{myalarm}}
```
Resultado:
```
This command returns to the prompt if successful.
```
+ Consulte detalhes da API em [DeleteAlarms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-alarms.html) na *Referência de comandos da AWS CLI*.
### `delete-anomaly-detector`
O código de exemplo a seguir mostra como usar `delete-anomaly-detector`.
**AWS CLI**
**Para excluir um modelo específico de detecção de anomalias**
O exemplo `delete-anomaly-detector` a seguir exclui um modelo de detector de anomalias na conta específica.
```
aws cloudwatch delete-anomaly-detector \
--namespace {{AWS/Logs}} \
--metric-name {{IncomingBytes}} \
--stat {{SampleCount}}
```
Este comando não produz saída.
Para obter mais informações, consulte [Excluir um modelo de detecção de anomalias](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Anomaly_Detection_Alarm.html#Delete_Anomaly_Detection_Model) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DeleteAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-anomaly-detector.html) na *Referência de comandos da AWS CLI*.
### `delete-dashboards`
O código de exemplo a seguir mostra como usar `delete-dashboards`.
**AWS CLI**
**Para excluir painéis específicos**
O exemplo `delete-dashboards` a seguir exclui dois painéis denominados `Dashboard-A` e `Dashboard-B` na conta específica.
```
aws cloudwatch delete-dashboards \
--dashboard-names {{Dashboard-A}} {{Dashboard-B}}
```
Este comando não produz saída.
Para obter mais informações, consulte [Painéis do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) no *Guiado usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DeleteDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-dashboards.html) na *Referência de comandos da AWS CLI*.
### `delete-insight-rules`
O código de exemplo a seguir mostra como usar `delete-insight-rules`.
**AWS CLI**
**Como excluir regras específicas do Contributor Insights**
O exemplo de `delete-insight-rules` a seguir exclui duas regras do Contributor Insights chamadas `Rule-A` e `Rule-B` na conta específica.
```
aws cloudwatch delete-insight-rules \
--rule-names {{Rule-A}} {{Rule-B}}
```
Resultado:
```
{
"Failures": []
}
```
Consulte mais informações em [Usar o Contributor Insights para analisar dados de alta cardinalidade](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DeleteInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-insight-rules.html) na *Referência de comandos da AWS CLI*.
### `delete-metric-stream`
O código de exemplo a seguir mostra como usar `delete-metric-stream`.
**AWS CLI**
**Como excluir um fluxo de métricas especificado**
O exemplo de `delete-metric-stream` a seguir exclui o fluxo de métricas chamado `QuickPartial-gSCKvO` na conta especificada.
```
aws cloudwatch delete-metric-stream \
--name {{QuickPartial-gSCKvO}}
```
Este comando não produz saída.
Consulte mais informações em [Usar fluxos de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DeleteMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/delete-metric-stream.html) na *Referência de comandos da AWS CLI*.
### `describe-alarm-history`
O código de exemplo a seguir mostra como usar `describe-alarm-history`.
**AWS CLI**
**Para recuperar o histórico de um alarme**
O seguinte exemplo usa o comando `describe-alarm-history` para recuperar o histórico do alarme “myalarm” do Amazon CloudWatch:
```
aws cloudwatch describe-alarm-history --alarm-name {{"myalarm"}} --history-item-type {{StateUpdate}}
```
Resultado:
```
{
"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"
}
]
}
```
+ Consulte detalhes da API em [DescribeAlarmHistory](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarm-history.html) na *Referência de comandos da AWS CLI*.
### `describe-alarms-for-metric`
O código de exemplo a seguir mostra como usar `describe-alarms-for-metric`.
**AWS CLI**
**Como exibir informações sobre os alarmes associados a uma métrica**
O seguinte exemplo usa o comando `describe-alarms-for-metric` para exibir informações sobre qualquer alarme associado à métrica CPUUtilization do Amazon EC2 e à instância com o ID i-0c986c72.:
```
aws cloudwatch describe-alarms-for-metric --metric-name {{CPUUtilization}} --namespace {{AWS/EC2}} --dimensions {{Name=InstanceId,Value=i-0c986c72}}
```
Resultado:
```
{
"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"
}
]
}
```
+ Consulte detalhes da API em [DescribeAlarmsForMetric](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms-for-metric.html) na *Referência de comandos da AWS CLI*.
### `describe-alarms`
O código de exemplo a seguir mostra como usar `describe-alarms`.
**AWS CLI**
**Para listar informações sobre um alarme**
O seguinte exemplo usa o comando `describe-alarms` para fornecer informações sobre o alarme chamado “myalarm”:
```
aws cloudwatch describe-alarms --alarm-names {{"myalarm"}}
```
Resultado:
```
{
"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"
}
]
}
```
+ Consulte detalhes da API em [DescribeAlarms](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-alarms.html) na *Referência de comandos da AWS CLI*.
### `describe-anomaly-detectors`
O código de exemplo a seguir mostra como usar `describe-anomaly-detectors`.
**AWS CLI**
**Para recuperar uma lista de modelos de detecção de anomalias**
O exemplo `describe-anomaly-detectors` a seguir exibe informações sobre modelos de detectores de anomalias associados ao namespace `AWS/Logs` na conta específica.
```
aws cloudwatch describe-anomaly-detectors \
--namespace {{AWS/Logs}}
```
Resultado:
```
{
"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 obter mais informações, consulte [Usar a detecção de anomalias do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DescribeAnomalyDetectors](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-anomaly-detectors.html) na *Referência de comandos da AWS CLI*.
### `describe-insight-rules`
O código de exemplo a seguir mostra como usar `describe-insight-rules`.
**AWS CLI**
**Como recuperar uma lista de regras do Contributor Insights**
O exemplo de `describe-insight-rules` a seguir mostra todas as regras do Contributor Insights na conta especificada.
```
aws cloudwatch describe-insight-rules
```
Resultado:
```
{
"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
}
]
}
```
Consulte mais informações em [Usar o Contributor Insights para analisar dados de alta cardinalidade](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DescribeInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/describe-insight-rules.html) na *Referência de comandos da AWS CLI*.
### `disable-alarm-actions`
O código de exemplo a seguir mostra como usar `disable-alarm-actions`.
**AWS CLI**
**Como desativar ações de um alarme**
O seguinte exemplo usa o comando `disable-alarm-actions` para desabilitar todas as ações do alarme “myalarm”:
```
aws cloudwatch disable-alarm-actions --alarm-names {{myalarm}}
```
Esse comando retornará ao prompt, se houver êxito.
+ Consulte detalhes da API em [DisableAlarmActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-alarm-actions.html) na *Referência de comandos da AWS CLI*.
### `disable-insight-rules`
O código de exemplo a seguir mostra como usar `disable-insight-rules`.
**AWS CLI**
**Como desabilitar regras especificadas do Contributor Insights**
O exemplo de `disable-insight-rules` a seguir desabilita duas regras do Contributor Insights chamadas `Rule-A` e `Rule-B` na conta especificada.
```
aws cloudwatch disable-insight-rules \
--rule-names {{Rule-A}} {{Rule-B}}
```
Resultado:
```
{
"Failures": []
}
```
Consulte mais informações em [Usar o Contributor Insights para analisar dados de alta cardinalidade](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DisableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/disable-insight-rules.html) na *Referência de comandos da AWS CLI*.
### `enable-alarm-actions`
O código de exemplo a seguir mostra como usar `enable-alarm-actions`.
**AWS CLI**
**Para habilitar todas as ações de um alarme**
O seguinte exemplo usa o comando `enable-alarm-actions` para habilitar todas as ações para o alarme “myalarm”:
```
aws cloudwatch enable-alarm-actions --alarm-names {{myalarm}}
```
Esse comando retornará ao prompt, se tiver êxito.
+ Consulte detalhes da API em [EnableAlarmActions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-alarm-actions.html) na *Referência de comandos da AWS CLI*.
### `enable-insight-rules`
O código de exemplo a seguir mostra como usar `enable-insight-rules`.
**AWS CLI**
**Como habilitar regras especificadas do Contributor Insights**
O exemplo de `enable-insight-rules` a seguir habilita duas regras do Contributor Insights chamadas `Rule-A` e `Rule-B` na conta especificada.
```
aws cloudwatch enable-insight-rules \
--rule-names {{Rule-A}} {{Rule-B}}
```
Resultado:
```
{
"Failures": []
}
```
Consulte mais informações em [Usar o Contributor Insights para analisar dados de alta cardinalidade](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [EnableInsightRules](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/enable-insight-rules.html) na *Referência de comandos da AWS CLI*.
### `get-dashboard`
O código de exemplo a seguir mostra como usar `get-dashboard`.
**AWS CLI**
**Para recuperar informações sobre um painel**
O exemplo `get-dashboard` a seguir exibe as informações sobre o painel denominado `Dashboard-A` na conta específica.
```
aws cloudwatch get-dashboard \
--dashboard-name {{Dashboard-A}}
```
Resultado:
```
{
"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 obter mais informações, consulte [Painéis do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) no *Guiado usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [GetDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-dashboard.html) na *Referência de comandos da AWS CLI*.
### `get-insight-rule-report`
O código de exemplo a seguir mostra como usar `get-insight-rule-report`.
**AWS CLI**
**Como recuperar os dados de séries temporais coletados por uma regra do Contributor Insights**
O exemplo de `get-insight-rule-report` a seguir retorna os dados de séries temporais coletados por uma regra do Contributor Insights.
```
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}}
```
Resultado:
```
{
"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": []
}
```
Consulte mais informações em [Usar o Contributor Insights para analisar dados de alta cardinalidade](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [GetInsightRuleReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-insight-rule-report.html) na *Referência de comandos da AWS CLI*.
### `get-metric-data`
O código de exemplo a seguir mostra como usar `get-metric-data`.
**AWS CLI**
**Exemplo 1: para obter a média total de IOPS para o EC2 especificado usando a expressão matemática**
O exemplo `get-metric-data` a seguir recupera os valores de métricas do CloudWatch para a instância do EC2 com InstanceID `i-abcdef` usando uma expressão matemática métrica que combina as métricas `EBSReadOps` e `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}}
```
Conteúdo 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
}
]
```
Resultado:
```
{
"MetricDataResults": [
{
"Id": "m3",
"Label": "Avg Total IOPS",
"Timestamps": [
"2024-09-29T22:10:00+00:00"
],
"Values": [
96.85
],
"StatusCode": "Complete"
}
],
"Messages": []
}
```
**Exemplo 2: para monitorar as cobranças estimadas da AWS usando as métricas de faturamento do CloudWatch**
O exemplo `get-metric-data` a seguir recupera a métrica `EstimatedCharges` do CloudWatch do namespace AWS/Faturamento.
```
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}}
```
Resultado:
```
{
"MetricDataResults": [
{
"Id": "m1",
"Label": "EstimatedCharges",
"Timestamps": [
"2024-09-26T12:00:00+00:00"
],
"Values": [
542.38
],
"StatusCode": "Complete"
}
],
"Messages": []
}
```
Para obter mais informações, consulte [Uso de expressões matemáticas com as métricas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [GetMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-data.html) na *Referência de comandos da AWS CLI*.
### `get-metric-statistics`
O código de exemplo a seguir mostra como usar `get-metric-statistics`.
**AWS CLI**
**Como obter a utilização da CPU por instância do EC**
O exemplo a seguir usa o comando `get-metric-statistics` para obter a utilização da CPU de uma instância do EC2 com o 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}}
```
Resultado:
```
{
"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"
}
```
**Especificar várias dimensões**
O exemplo a seguir ilustra como especificar diversas dimensões. Cada dimensão é especificada como um par de nome/valor, com uma vírgula entre o nome e o valor. As diversas dimensões são separadas por um espaço. Se uma única métrica incluir diversas dimensões, você deverá especificar um valor para cada dimensão definida.
Para obter mais exemplos relacionados ao uso do comando `get-metric-statistics`, consulte Obter estatísticas de uma métrica no *Guia do desenvolvedor do 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}}
```
+ Consulte detalhes da API em [GetMetricStatistics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-statistics.html) na *Referência de comandos da AWS CLI*.
### `get-metric-stream`
O código de exemplo a seguir mostra como usar `get-metric-stream`.
**AWS CLI**
**Como recuperar informações sobre um fluxo de métricas**
O exemplo de `get-metric-stream` a seguir exibe as informações sobre o fluxo de métricas chamado `QuickFull-GuaFbs` na conta especificada.
```
aws cloudwatch get-metric-stream \
--name {{QuickFull-GuaFbs}}
```
Resultado:
```
{
"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
}
```
Consulte mais informações em [Usar fluxos de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [GetMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-stream.html) na *Referência de comandos da AWS CLI*.
### `get-metric-widget-image`
O código de exemplo a seguir mostra como usar `get-metric-widget-image`.
**AWS CLI**
**Para recuperar um grafo de snapshot de CPUUtilization**
O exemplo `get-metric-widget-image` a seguir recupera o grafo de snapshot da métrica `CPUUtilization` da instância do EC2 com o ID `i-abcde` e salva a imagem recuperada como um arquivo denominado "image.png" na 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 não produz saída.
+ Consulte detalhes da API em [GetMetricWidgetImage](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/get-metric-widget-image.html) na *Referência de comandos da AWS CLI*.
### `list-dashboards`
O código de exemplo a seguir mostra como usar `list-dashboards`.
**AWS CLI**
**Para recuperar uma lista de painéis**
O exemplo `list-dashboards` a seguir lista todos os painéis na conta especificada.
```
aws cloudwatch list-dashboards
```
Resultado:
```
{
"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 obter mais informações, consulte [Painéis do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html) no *Guiado usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [ListDashboards](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-dashboards.html) na *Referência de comandos da AWS CLI*.
### `list-metric-streams`
O código de exemplo a seguir mostra como usar `list-metric-streams`.
**AWS CLI**
**Como recuperar uma lista de fluxos de métricas**
O exemplo de `list-metric-streams` a seguir lista todos os fluxos de métricas na conta especificada.
```
aws cloudwatch list-metric-streams
```
Resultado:
```
{
"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"
}
]
}
```
Consulte mais informações em [Usar fluxos de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [ListMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metric-streams.html) na *Referência de comandos da AWS CLI*.
### `list-metrics`
O código de exemplo a seguir mostra como usar `list-metrics`.
**AWS CLI**
**Para listar as métricas do Amazon SNS**
O exemplo apresentado a seguir para `list-metrics` exibe as métricas do Amazon SNS.
```
aws cloudwatch list-metrics \
--namespace {{"AWS/SNS"}}
```
Resultado:
```
{
"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"
}
]
}
```
+ Consulte detalhes da API em [ListMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-metrics.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Como listar as tags associadas a um alarme existente\***
O exemplo de `list-tags-for-resource` a seguir lista todas as tags associadas a um alarme chamado `demo` na conta especificada.
```
aws cloudwatch list-tags-for-resource \
--resource-arn {{arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo}}
```
Resultado:
```
{
"Tags": [
{
"Key": "stack",
"Value": "Production"
},
{
"Key": "team",
"Value": "Devops"
}
]
}
```
Consulte mais informações em [Alarmes e marcação](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_alarms_and_tagging.html) no *Guia do usuário do Amazon CloudWatch*.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `put-anomaly-detector`
O código de exemplo a seguir mostra como usar `put-anomaly-detector`.
**AWS CLI**
**Para criar um modelo de detecção de anomalias**
O exemplo `put-anomaly-detector` a seguir cria um modelo de detecção de anomalias de uma métrica do CloudWatch.
```
aws cloudwatch put-anomaly-detector \
--namespace {{AWS/Logs}} \
--metric-name {{IncomingBytes}} \
--stat {{SampleCount}}
```
Este comando não produz saída.
Para obter mais informações, consulte [Usar a detecção de anomalias do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Anomaly_Detection.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [PutAnomalyDetector](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-anomaly-detector.html) na *Referência de comandos da AWS CLI*.
### `put-composite-alarm`
O código de exemplo a seguir mostra como usar `put-composite-alarm`.
**AWS CLI**
**Como criar um alarme composto no CloudWatch**
O exemplo de `put-composite-alarm` a seguir cria um alarme composto chamado `ProdAlarm` na conta 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 não produz saída.
Consulte mais informações em [Criar um alarme composto](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Create_Composite_Alarm_How_To.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [PutCompositeAlarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-composite-alarm.html) na *Referência de comandos da AWS CLI*.
### `put-dashboard`
O código de exemplo a seguir mostra como usar `put-dashboard`.
**AWS CLI**
**Para criar um painel**
O exemplo `put-dashboard` a seguir cria um painel denominado `Dashboard-A` na conta 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"}}]}}}'
```
Resultado:
```
{
"DashboardValidationMessages": []
}
```
Para obter mais informações, consulte [Criar um painel do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create_dashboard.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [PutDashboard](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-dashboard.html) na *Referência de comandos da AWS CLI*.
### `put-insight-rule`
O código de exemplo a seguir mostra como usar `put-insight-rule`.
**AWS CLI**
**Como criar uma regra do Contributor Insights**
O exemplo de `put-insight-rule` a seguir cria uma regra do Contributor Insights chamada `VPCFlowLogsContributorInsights` na conta especificada.
```
aws cloudwatch put-insight-rule \
--rule-name {{VPCFlowLogsContributorInsights}} \
--rule-definition {{file://insight-rule.json}} \
--rule-state {{ENABLED}}
```
Conteúdo 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 não produz saída.
Consulte mais informações em [Criação de uma regra do Contributor Insights no CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ContributorInsights-CreateRule.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [PutInsightRule](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-insight-rule.html) na *Referência de comandos da AWS CLI*.
### `put-metric-alarm`
O código de exemplo a seguir mostra como usar `put-metric-alarm`.
**AWS CLI**
**Como enviar uma mensagem de e-mail do Amazon Simple Notification Service quando a utilização da CPU exceder**
O seguinte exemplo usa o comando `put-metric-alarm` para enviar uma mensagem de e-mail do Amazon Simple Notification Service quando a utilização da CPU excede 70%:
```
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}}
```
Esse comando retornará ao prompt, se houver êxito. Se já existir um alarme com o mesmo nome, ele será substituído pelo novo alarme.
**Como especificar diversas dimensões**
O exemplo a seguir ilustra como especificar diversas dimensões. Cada dimensão é especificada como um par de nome/valor, com uma vírgula entre o nome e o valor. As diversas dimensões são separadas por um espaço:
```
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}}
```
+ Consulte detalhes da API em [PutMetricAlarm](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-alarm.html) na *Referência de comandos da AWS CLI*.
### `put-metric-data`
O código de exemplo a seguir mostra como usar `put-metric-data`.
**AWS CLI**
**Como publicar uma métrica personalizada no Amazon CloudWatch**
O seguinte exemplo usa o comando `put-metric-data` para publicar uma métrica personalizada no Amazon CloudWatch:
```
aws cloudwatch put-metric-data --namespace {{"Usage Metrics"}} --metric-data {{file://metric.json}}
```
Os valores da própria métrica estão armazenados no arquivo em JSON, `metric.json`.
Veja o conteúdo desse arquivo:
```
[
{
"MetricName": "New Posts",
"Timestamp": "Wednesday, June 12, 2013 8:28:20 PM",
"Value": 0.50,
"Unit": "Count"
}
]
```
Para obter mais informações, consulte Publicar métricas personalizadas no *Guia do desenvolvedor do Amazon CloudWatch*.
**Como especificar diversas dimensões**
O exemplo a seguir ilustra como especificar diversas dimensões. Cada dimensão é especificada como um par de nome/valor. As diversas dimensões são separadas por uma vírgula.
```
aws cloudwatch put-metric-data --metric-name {{Buffers}} --namespace {{MyNameSpace}} --unit {{Bytes}} --value {{231434333}} --dimensions {{InstanceID=1-23456789,InstanceType=m1.small}}
```
+ Consulte detalhes da API em [PutMetricData](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-data.html) na *Referência de comandos da AWS CLI*.
### `put-metric-stream`
O código de exemplo a seguir mostra como usar `put-metric-stream`.
**AWS CLI**
**Como criar um fluxo de métricas**
O exemplo de `put-metric-stream` a seguir cria um fluxo de métricas chamado `QuickFull-GuaFb` na conta 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
```
Resultado:
```
{
"Arn": "arn:aws:cloudwatch:us-east-1:123456789012:metric-stream/QuickFull-GuaFbs"
}
```
Consulte mais informações em [Configurar um fluxo de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-metric-streams-setup.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [PutMetricStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/put-metric-stream.html) na *Referência de comandos da AWS CLI*.
### `set-alarm-state`
O código de exemplo a seguir mostra como usar `set-alarm-state`.
**AWS CLI**
**Para alterar temporariamente o estado de um alarme**
O seguinte exemplo usa o comando `set-alarm-state` para alterar temporariamente o estado de um alarme do Amazon CloudWatch chamado “myalarm” e definir seu estado como ALARM para fins de teste:
```
aws cloudwatch set-alarm-state --alarm-name {{"myalarm"}} --state-value {{ALARM}} --state-reason {{"testing purposes"}}
```
Esse comando retornará ao prompt, se houver êxito.
+ Para ver detalhes da API, consulte [SetAlarmState](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/set-alarm-state.html) na *Referência de comandos da AWS CLI*.
### `start-metric-streams`
O código de exemplo a seguir mostra como usar `start-metric-streams`.
**AWS CLI**
**Como iniciar um fluxo de métricas especificado**
O exemplo de `start-metric-streams` a seguir inicia o fluxo de métricas chamado `QuickFull-GuaFbs` na conta especificada.
```
aws cloudwatch start-metric-streams \
--names {{QuickFull-GuaFbs}}
```
Este comando não produz saída.
Consulte mais informações em [Usar fluxos de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [StartMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/start-metric-streams.html) na *Referência de comandos da AWS CLI*.
### `stop-metric-streams`
O código de exemplo a seguir mostra como usar `stop-metric-streams`.
**AWS CLI**
**Como interromper um fluxo de métricas especificado**
O exemplo de `stop-metric-streams` a seguir interrompe o fluxo de métricas chamado `QuickFull-GuaFbs` na conta especificada.
```
aws cloudwatch stop-metric-streams \
--names {{QuickFull-GuaFbs}}
```
Este comando não produz saída.
Consulte mais informações em [Usar fluxos de métricas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [StopMetricStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/stop-metric-streams.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como adicionar uma ou mais tags ao recurso especificado**
O exemplo de `tag-resource` a seguir adiciona duas tags ao alarme do CloudWatch chamado `demo` na conta 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 não produz saída.
Consulte mais informações em [Etiquetar recursos do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Como remover uma ou mais tags do recurso especificado**
O exemplo de `untag-resource` a seguir remove duas tags do alarme do CloudWatch chamado `demo` na conta especificada.
```
aws cloudwatch untag-resource \
--resource-arn {{arn:aws:cloudwatch:us-east-1:123456789012:alarm:demo}} \
--tag-keys {{stack}} {{team}}
```
Este comando não produz saída.
Consulte mais informações em [Etiquetar recursos do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Tagging.html) no *Guia do usuário do Amazon CloudWatch*.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloudwatch/untag-resource.html) na *Referência de comandos da AWS CLI*.