As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# CloudWatch \| Criar alarmes
<a name="deployment-monitoring-cloudwatch-create-alarms"></a>

Crie um ou mais CloudWatch alarmes. Para obter informações detalhadas sobre propriedades de CloudWatch alarmes, consulte a documentação da AWS “Creating CloudWatch Alarms”.

**Classificação completa:** Implantação \| Monitoramento e notificação \| CloudWatch \| Crie alarmes

## Detalhes do tipo de alteração
<a name="ct-361vpyun9a9dd-DMCc-table"></a>


****  

|  |  | 
| --- |--- |
| ID do tipo de alteração | ct-361vpyun9a9dd | 
| Versão atual | 1,0 | 
| Duração esperada da execução | 60 minutos | 
| Aprovação da AWS | Obrigatório | 
| Aprovação do cliente | Não obrigatório | 
| Modo de execução | Automatizado | 

## Informações adicionais
<a name="deployment-monitoring-cloudwatch-create-alarms-info"></a>

### Criar CloudWatch alarme
<a name="ex-cw-alarm-create-col"></a>

#### Criando um CloudWatch alarme com o console
<a name="cw-alarm-create-con"></a>

Como funciona:

1. Navegue até a página **Criar RFC**: No painel de navegação esquerdo do console AMS, clique **RFCs**para abrir a página da RFCs lista e, em seguida, clique em **Criar** RFC.

1. Escolha um tipo de alteração popular (CT) na visualização padrão **Procurar tipos de alteração** ou selecione uma CT na visualização **Escolher por categoria**.
   + **Navegar por tipo de alteração**: você pode clicar em um CT popular na área de **criação rápida** para abrir imediatamente a página **Executar RFC**. Observe que você não pode escolher uma versão mais antiga do CT com a criação rápida.

     Para classificar CTs, use a área **Todos os tipos de alteração** na exibição **Cartão** ou **Tabela**. Em qualquer exibição, selecione uma CT e clique em **Criar RFC** para abrir a página **Executar RFC**. Se aplicável, a opção **Criar com uma versão mais antiga** aparece ao lado do botão **Criar RFC**.
   + **Escolha por categoria**: selecione uma categoria, subcategoria, item e operação e a caixa de detalhes do CT será aberta com a opção **Criar com uma versão mais antiga**, se aplicável. Clique em **Criar RFC** para abrir a página **Executar RFC**.

1. Na página **Executar RFC**, abra a área do nome do CT para ver a caixa de detalhes do CT. É necessário um **Assunto** (preenchido se você escolher seu CT na visualização **Procurar tipos de alteração**). Abra a área **Configuração adicional** para adicionar informações sobre o RFC.

   Na área **Configuração de execução**, use as listas suspensas disponíveis ou insira valores para os parâmetros necessários. Para configurar parâmetros de execução opcionais, abra a área **Configuração adicional**.

1. Ao terminar, clique em **Executar**. Se não houver erros, a página **RFC criada com sucesso** será exibida com os detalhes da RFC enviada e a saída inicial de **execução**. 

1. Abra a área **Parâmetros de execução** para ver as configurações que você enviou. Atualize a página para atualizar o status de execução do RFC. Opcionalmente, cancele a RFC ou crie uma cópia dela com as opções na parte superior da página.

#### Criando um CloudWatch alarme com a CLI
<a name="cw-alarm-create-cli"></a>

Como funciona:

1. Use o Inline Create (você emite um `create-rfc` comando com todos os parâmetros de RFC e execução incluídos) ou o Template Create (você cria dois arquivos JSON, um para os parâmetros RFC e outro para os parâmetros de execução) e emita o `create-rfc` comando com os dois arquivos como entrada. Ambos os métodos são descritos aqui.

1. Envie o `aws amscm submit-rfc --rfc-id {{ID}}` comando RFC: com o ID RFC retornado.

   Monitore o `aws amscm get-rfc --rfc-id {{ID}}` comando RFC:.

Para verificar a versão do tipo de alteração, use este comando:

```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value={{CT_ID}}
```
**nota**  
Você pode usar qualquer `CreateRfc` parâmetro com qualquer RFC, independentemente de eles fazerem parte do esquema para o tipo de alteração. Por exemplo, para receber notificações quando o status da RFC mudar, adicione essa linha `--notification "{\"Email\": {\"EmailRecipients\" : [\"email@example.com\"]}}"` à parte dos parâmetros da RFC da solicitação (não aos parâmetros de execução). Para obter uma lista de todos os CreateRfc parâmetros, consulte a [Referência da API de gerenciamento de alterações do AMS](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_CreateRfc.html).

*CRIAÇÃO EM LINHA*:

Execute o comando create RFC com os parâmetros de execução fornecidos em linha (aspas de escape ao fornecer parâmetros de execução em linha) e, em seguida, envie a ID de RFC retornada. Por exemplo, você pode substituir o conteúdo por algo assim:

```
aws --profile saml --region us-east-1 amscm create-rfc --change-type-id "ct-361vpyun9a9dd" --change-type-version "1.0" --title "{{Test Create CloudWatch Alarms}}" --execution-parameters "{\"Alarms\": [{\"{{ActionsEnabled}}\": {{true}},\"AlarmActions\": [\"{{arn:aws:sns:us-east-1:000000000000:SNS-Topic}}\"],\"AlarmDescription\": \"{{Test alarm description.}}\",\"AlarmName\": \"{{Test alarm name}}\",\"ComparisonOperator\": \"{{GreaterThanThreshold}}\",\"DatapointsToAlarm\": {{1}},\"Dimensions\": [{\"Name\": \"InstanceId\",\"Value\": \"{{i-12345678901234567}}\"}],\"EvaluateLowSampleCountPercentile\": \"{{ignore}}\",\"EvaluationPeriods\": {{2}},\"InsufficientDataActions\": [\"{{arn:aws:sns:us-east-1:000000000000:SNS-Topic}}\"],\"MetricName\": \"{{TestMetric}}\",\"Namespace\": \"{{AWS/Test}}\",\"OkActions\": [\"{{arn:aws:sns:us-east-1:000000000000:SNS-Topic}}\"],\"Period\": {{300}},\"Statistic\": \"{{Average}}\",\"Threshold\": {{85}},\"TreatMissingData\": \"{{breaching}}\",\"Unit\": \"{{Percent}}\"}],\"Region\": \"{{us-east-1}}\"}"
```

*CRIAÇÃO DE MODELO*:

1. Exiba os parâmetros de execução do esquema JSON para esse tipo de alteração em um arquivo na sua pasta atual; este exemplo o chama de .json: CwAlarmsParams

   ```
   aws amscm get-change-type-version --change-type-id "ct-361vpyun9a9dd" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CwAlarmsParams.json
   ```

1. Modifique e salve o CwAlarmsParams arquivo.json. Por exemplo, você pode substituir o conteúdo por algo assim:

   ```
   {
     "Alarms": [
       {
         "ActionsEnabled": {{true}},
         "AlarmActions": ["{{arn:aws:sns:us-east-1:000000000000:SNS-Topic}}"],
         "AlarmDescription": "{{Test alarm description.}}",
         "AlarmName": "{{Test alarm name}}",
         "ComparisonOperator": "{{GreaterThanThreshold}}",
         "DatapointsToAlarm": {{1}},
         "Dimensions": [
           {
             "Name": "{{InstanceId}}",
             "Value": "{{i-12345678901234567}}"
           }
         ],
         "EvaluateLowSampleCountPercentile": "{{ignore}}",
         "EvaluationPeriods": {{2}},
         "InsufficientDataActions": ["{{arn:aws:sns:us-east-1:000000000000:SNS-Topic}}"],
         "MetricName": "{{TestMetric}}",
         "Namespace": "{{AWS/Test}}",
         "OkActions": ["{{arn:aws:sns:us-east-1:000000000000:SNS-Topic}}"],
         "Period": {{300}},
         "Statistic": "{{Average}}",
         "Threshold": {{85}},
         "TreatMissingData": "{{breaching}}",
         "Unit": "{{Percent}}"
       }
     ],
     "Region": "{{us-east-1}}"
   }
   ```

1. Envie o modelo JSON CreateRfc para um arquivo em sua pasta atual; este exemplo o chama de CwAlarmsRfc .json:

   ```
   aws amscm create-rfc --generate-cli-skeleton > CwAlarmsRfc.json
   ```

1. Modifique e salve o CwAlarmsRfc arquivo.json. Por exemplo, você pode substituir o conteúdo por algo assim:

   ```
   {
   "ChangeTypeVersion":    "{{1.0}}",
   "ChangeTypeId":         "ct-361vpyun9a9dd",
   "Title":                "{{CW-ALARMS-RFC}}"
   }
   ```

1. Crie o RFC, especificando o CwAlarmsRfc arquivo e o arquivo de parâmetros de execução:

   ```
   aws amscm create-rfc --cli-input-json file://CwAlarmsRfc.json --execution-parameters file://CwAlarmsParams.json
   ```

   Você recebe a ID da nova RFC na resposta e pode usá-la para enviar e monitorar a RFC. Até que você o envie, o RFC permanece no estado de edição e não inicia.

#### Dicas
<a name="ex-cw-alarm-create-tip"></a>

Para saber mais sobre isso CloudWatch, consulte [Criação de CloudWatch alarmes na Amazon](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html).

## Parâmetros de entrada de execução
<a name="deployment-monitoring-cloudwatch-create-alarms-input"></a>

Para obter informações detalhadas sobre os parâmetros de entrada de execução, consulte[Esquema para o tipo de alteração ct-361vpyun9a9dd](schemas.md#ct-361vpyun9a9dd-schema-section).

## Exemplo: parâmetros obrigatórios
<a name="deployment-monitoring-cloudwatch-create-alarms-ex-min"></a>

```
Example not available.
```

## Exemplo: Todos os parâmetros
<a name="deployment-monitoring-cloudwatch-create-alarms-ex-max"></a>

```
{
  "Alarms": [
    {
      "ActionsEnabled": true,
      "AlarmActions": ["arn:aws:sns:us-east-1:000000000000:SNS-Topic"],
      "AlarmDescription": "Test alarm description.",
      "AlarmName": "Test alarm name",
      "ComparisonOperator": "GreaterThanThreshold",
      "DatapointsToAlarm": 1,
      "Dimensions": [
        {
          "Name": "InstanceId",
          "Value": "i-12345678901234567"
        }
      ],
      "EvaluateLowSampleCountPercentile": "ignore",
      "EvaluationPeriods": 2,
      "InsufficientDataActions": ["arn:aws:sns:us-east-1:000000000000:SNS-Topic"],
      "MetricName": "TestMetric",
      "Namespace": "AWS/Test",
      "OkActions": ["arn:aws:sns:us-east-1:000000000000:SNS-Topic"],
      "Period": 300,
      "Statistic": "Average",
      "Threshold": 85,
      "TreatMissingData": "breaching",
      "Unit": "Percent"
    }
  ],
  "Region": "us-east-1"
}
```