# 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](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/double-braces/overview) 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*