# AWS CloudWatch

O **AWS CloudWatch** permite enviar dados de métricas personalizadas do *pipeline* para o serviço [Amazon CloudWatch](https://docs.aws.amazon.com/cloudwatch/). Isso proporciona maior flexibilidade no monitoramento da saúde dos *pipelines* além das métricas predefinidas fornecidas pela Digibee Integration Platform.

Mais informações podem ser encontradas na [documentação da API do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricData.html).

## **Parâmetros**

Dê uma olhada nos parâmetros de configuração do conector. Parâmetros suportados por [expressões Double Braces](/documentation/connectors-and-triggers/pt-br/double-braces/overview.md) estão marcados com (DB).

### **Aba General**

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Valor padrão</th><th>Tipo de dado</th></tr></thead><tbody><tr><td><strong>CloudWatch Client Account</strong></td><td>A conta usada para conectar o <em>pipeline</em> à API CloudWatch PutMetricData.</td><td>N/A</td><td>BASIC, AWS-V4</td></tr><tr><td><strong>Region</strong></td><td>A região da AWS na qual o cliente CloudWatch deve trabalhar.</td><td>AWS Global</td><td><em>String</em></td></tr><tr><td><strong>Namespace</strong> <code>(DB)</code></td><td>O <em>namespace</em> para os dados da métrica. Você pode usar caracteres ASCII para o <em>namespace</em>, exceto caracteres de controle, que não são suportados. Para evitar conflitos com <em>namespaces</em> de serviços da AWS, você não deve especificar um <em>namespace</em> que comece com “AWS/”.</td><td>N/A</td><td><em>String</em></td></tr><tr><td><strong>Fail On Error</strong></td><td>Se a opção estiver ativada, a execução do pipeline com erro será interrompida. Do contrário, a execução do pipeline continua, mas o resultado irá mostrar um valor falso para a propriedade <code>"success"</code>.</td><td><em>False</em></td><td>Booleano</td></tr></tbody></table>

### **Aba General**

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Valor padrão</th><th>Tipo de dado</th></tr></thead><tbody><tr><td><strong>Metric Name</strong> <code>(DB)</code></td><td>O nome da métrica.</td><td>N/A</td><td><em>String</em></td></tr><tr><td><strong>Metric Value</strong> <code>(DB)</code></td><td>O valor da métrica. Embora o parâmetro aceite números do tipo <em>double</em>, o CloudWatch rejeita valores muito pequenos ou muito grandes. Os valores devem estar no intervalo de -2^360 a 2^360.</td><td>0</td><td><em>String</em></td></tr><tr><td><strong>Metric Timestamp</strong> <code>(DB)</code></td><td>A hora em que os dados métricos foram recebidos, expresso como o número de milissegundos desde 1º de janeiro de 1970 00:00:00 UTC.</td><td>N/A</td><td><em>String</em></td></tr><tr><td><strong>Metric Unit</strong> <code>(DB)</code></td><td>Determina qual unidade você deseja usar ao armazenar a métrica. Valores permitidos: <em>Seconds</em></td><td><em>Microseconds</em></td><td><em>Milliseconds</em></td></tr><tr><td><strong>Metric Dimensions</strong> <code>(DB)</code></td><td>Uma dimensão é um par chave-valor que faz parte da identidade de uma métrica. Como as dimensões fazem parte do identificador exclusivo de uma métrica, sempre que você adiciona um par chave-valor exclusivo a uma de suas métricas, você cria uma nova variante dessa métrica.</td><td>N/A</td><td>Pares de chave-valor</td></tr></tbody></table>

### **Aba Documentation**

<table data-full-width="true"><thead><tr><th>Parâmetro</th><th>Descrição</th><th>Valor padrão</th><th>Tipo de dado</th></tr></thead><tbody><tr><td><strong>Documentation</strong></td><td>Seção para documentar qualquer informação necessária sobre a configuração do conector e regras de negócio.</td><td>N/A</td><td><em>String</em></td></tr></tbody></table>

## **Exemplos de uso**

Dada a flexibilidade do serviço, as possibilidades de métricas personalizadas com o Amazon CloudWatch são extensas. Alguns exemplos que podem ser interessantes no contexto de *pipelines* são:

* Métricas de integridade para *pipelines*:
  * Tempo de execução
  * Contagem de requisições
  * Tamanho dos arquivos enviados
  * Tempo de execução para seções específicas do *pipeline* (gargalos)
* Métricas de negócios personalizadas:
  * Solicitações iniciadas pelo usuário versus solicitações iniciadas pela máquina
  * Taxa de sucesso de chamadas de API
  * Tamanho dos pedidos recebidos
  * Taxa de conversão de *leads*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/aws/cloudwatch.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.