# Configure as Regras

1. Na tela principal de Alarmes, o sistema permite cadastrar um novo alarme clicando na opção "**Novo alarme**":

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FWj4bUeVTj5aGKyHy2bYM%2Fimage.png?alt=media&#x26;token=9640c63d-555c-4de1-92e5-5d0494249183" alt=""><figcaption></figcaption></figure>

2. Informações **Geral**

Preencha os dados do novo alarme e pressione o botão **Próximo.**

* **Nome**: Identificação do alarme.
* **Descrição**: Alguma informação adicional sobre o alarme

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F4urYe2GGDDVT7B9hVJvL%2Fimage.png?alt=media&#x26;token=846a98da-8c5e-479f-8e07-846017481d50" alt=""><figcaption></figcaption></figure>

3. Preencha as informações do **Indicador**.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FuixeliH5M5sWHpidLNeZ%2Fimage.png?alt=media&#x26;token=5a6733df-73a0-422d-82f6-09a011d5baf3" alt=""><figcaption></figcaption></figure>

**Agregador**: Selecione o agregador (Últimos, Período, Competência)

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FL9Ohxw4j7tEA1uKTEu5R%2Fimage.png?alt=media&#x26;token=9464d525-3dc0-47da-98ee-a847f420f0fd" alt=""><figcaption></figcaption></figure>

* **Ultimos**: Ao selecionar o agregador "**Últimos"**, o sistema exibirá alguns campos adicionais para preenchimento:
  * Valor
  * Período (Dia, Semana, Mês, Ano)
  * Atrasar por (Opcional)
  * Período (Dia, Semana, Mês, Ano)

Utilize esta opção para acumular valores dos últimos x dias, semanas, meses ou anos, por exemplo: Últimos 7 dias com atraso de 3 dias (consideramos 3 dias de delay para fechamento dos provedores da cloud)

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FlmrVLW4PTTkUiDNOOVGk%2Fimage.png?alt=media&#x26;token=bc45d0e3-a759-4158-ac69-50675938efd1" alt=""><figcaption></figcaption></figure>

* **Período**: Ao selecionar o agregador "**Período"**, o sistema exibirá alguns campos adicionais para preenchimento:
  * Início do período
  * Final do período

Utilize esta opção para consolidar os valores de um período especifico

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FCf65vDRSldz6SJPDStvr%2Fimage.png?alt=media&#x26;token=2c78a6d5-de78-4ac5-b059-5091120b6c54" alt=""><figcaption></figcaption></figure>

* **Competência**: Ao selecionar o agregador "**Competência**", o sistema apresentará um campo adicional
  * Competênci&#x61;**:** informe um mês de competencia.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FJ1q5uUjH2JWzGykmfKU6%2Fimage.png?alt=media&#x26;token=03558b52-0ba5-4b53-9109-60c6898d1099" alt=""><figcaption></figcaption></figure>

Utiliza essa opção para trabalhar com um mês de competência específico&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FanWD8gHIo7YKl5X8DRef%2Fimage.png?alt=media&#x26;token=53a07a8a-7f5f-4e5b-8943-f1c2d801d3db" alt=""><figcaption></figcaption></figure>

**Conjunto de Dados (opcional)** :  Selecione esta opção para utilizar um conjunto de dados.&#x20;

**Expressão**: Selecione as opções na lista, conforme abaixo:&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FmRW1FFQ9PgoKB35nj2Ah%2Fimage.png?alt=media&#x26;token=57b6bb1a-034f-43bb-9638-a88454342099" alt=""><figcaption></figcaption></figure>

* Soma: soma os valores do periodo parametrizado&#x20;
* Média:  calcula a média dos valores no período parametrizado
* Média por data: calcula a média por data no período parametrizado
* Quantidade: conta o número de valores que não estão em branco.

**Tipo de retorno:** Selecione a opção, conforme exemplo abaixo:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FDSviKO16eMbMyOgeNS23%2Fimage.png?alt=media&#x26;token=ce71033f-e2f3-401f-aacd-3a421413fe46" alt=""><figcaption></figcaption></figure>

* Chave e valor: Utilize esta opção para filtrar campos do billing (chave),  e o conteúdo (valor). Por exemplo:&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FHyMDheQYatkUHkFBRJmT%2Fimage.png?alt=media&#x26;token=57b72559-955d-45f7-8539-784c67543111" alt=""><figcaption></figcaption></figure>

* Campo calculado: Utilize esta opção para filtros que combinam operadores matemáticos, exemplo custo amortizado maior que 1.000: &#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FUslVFC76beVcLJKBJGbl%2Fimage.png?alt=media&#x26;token=19fb0f9d-242c-4763-90bd-11ace03f1282" alt=""><figcaption></figcaption></figure>

**Retorno do campo calculado:** informe o campo da billing que será totalizado neste contexto.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FJwD9xjhyjmBa59V99e0Q%2Fimage.png?alt=media&#x26;token=c9050604-68e6-412f-a780-cd98ac6d2655" alt=""><figcaption></figcaption></figure>

4. Preencha as informações de **Limite.**

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FsRKOWSwz1jd1dQ2T3uNm%2Fimage.png?alt=media&#x26;token=5f3e4a61-aa9e-4072-8c8f-a14d98806731" alt=""><figcaption></figcaption></figure>

**Tipo**: Selecione o tipo, conforme exemplo abaixo:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F0R8rROqDYPHyhIyee31q%2Fimage.png?alt=media&#x26;token=1ae00367-58da-4c70-84eb-e053378da310" alt=""><figcaption></figcaption></figure>

* Estático: Ao selecionar essa opção, o sistema irá solicitar algumas informações adicionais:
  * Competência: Informe o mês de competência.
  * Estático: Informe o valor limite para envio da notificação.

Utilize esta opção para estabelecer um  limite a partir de um valor fixo. Exemplo: Neste contexto, quando o valor do indicador atingir 100.000 a notificação será enviada.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FKKubJMJDuZFtkEWoYDz0%2Fimage.png?alt=media&#x26;token=0885d93b-50e3-4e30-89c4-8bb180dd5057" alt=""><figcaption></figcaption></figure>

* Dinâmico: Ao selecionar essa opção, o sistema irá solicitar algumas informações adicionais:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F9LczvuuO077NdhfseeVg%2Fimage.png?alt=media&#x26;token=f88bf26c-ad2c-41dc-aab3-84b8fa8dbb9e" alt=""><figcaption></figcaption></figure>

Utilize esta opção para limites dinâmicos, por exemplo, quando o indicador atingir 10% do custo real o alarme será acionado.

**Agregador**: Selecione o agregador (Últimos, Período, Competência)

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FL9Ohxw4j7tEA1uKTEu5R%2Fimage.png?alt=media&#x26;token=9464d525-3dc0-47da-98ee-a847f420f0fd" alt=""><figcaption></figcaption></figure>

* **Ultimos**: Ao selecionar o agregador "**Últimos"**, o sistema exibirá alguns campos adicionais para preenchimento:
  * Valor
  * Período (Dia, Semana, Mês, Ano)
  * Atrasar por (Opcional)
  * Período (Dia, Semana, Mês, Ano)

Utilize esta opção para acumular valores dos últimos x dias, semanas, meses ou anos, por exemplo: Últimos 7 dias com atraso de 3 dias (consideramos 3 dias de delay para fechamento dos provedores da cloud)

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FlmrVLW4PTTkUiDNOOVGk%2Fimage.png?alt=media&#x26;token=bc45d0e3-a759-4158-ac69-50675938efd1" alt=""><figcaption></figcaption></figure>

* **Período**: Ao selecionar o agregador "**Período"**, o sistema exibirá alguns campos adicionais para preenchimento:
  * Início do período
  * Final do período

Utilize esta opção para consolidar os valores de um período especifico

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FCf65vDRSldz6SJPDStvr%2Fimage.png?alt=media&#x26;token=2c78a6d5-de78-4ac5-b059-5091120b6c54" alt=""><figcaption></figcaption></figure>

* **Competência**: Ao selecionar o agregador "**Competência**", o sistema apresentará um campo adicional
  * Competênci&#x61;**:** Utiliza essa opção para trabalhar com um mês de competência específico&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FJ1q5uUjH2JWzGykmfKU6%2Fimage.png?alt=media&#x26;token=03558b52-0ba5-4b53-9109-60c6898d1099" alt=""><figcaption></figcaption></figure>

**Conjunto de Dados (opcional)** :  Selecione esta opção para utilizar um conjunto de dados.&#x20;

**Expressão**: Selecione as opções na lista, conforme abaixo:&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FmRW1FFQ9PgoKB35nj2Ah%2Fimage.png?alt=media&#x26;token=57b6bb1a-034f-43bb-9638-a88454342099" alt=""><figcaption></figcaption></figure>

* Soma: soma os valores do periodo parametrizado&#x20;
* Média:  calcula a média dos valores no período parametrizado
* Média por data: calcula a média por data no período parametrizado
* Quantidade: conta o número de valores que não estão em branco.

**Tipo de retorno:** Selecione a opção, conforme exemplo abaixo:

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FDSviKO16eMbMyOgeNS23%2Fimage.png?alt=media&#x26;token=ce71033f-e2f3-401f-aacd-3a421413fe46" alt=""><figcaption></figcaption></figure>

* Chave e valor: Utilize esta opção para filtrar campos do billing (chave),  e o conteúdo (valor). Por exemplo:&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FHyMDheQYatkUHkFBRJmT%2Fimage.png?alt=media&#x26;token=57b72559-955d-45f7-8539-784c67543111" alt=""><figcaption></figcaption></figure>

* Campo calculado: Utilize esta opção para filtros que combinam operadores matemáticos, exemplo custo amortizado maior que 1.000: &#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FUslVFC76beVcLJKBJGbl%2Fimage.png?alt=media&#x26;token=19fb0f9d-242c-4763-90bd-11ace03f1282" alt=""><figcaption></figcaption></figure>

**Retorno do campo calculado:** informe o campo da billing que será totalizado neste contexto.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FJwD9xjhyjmBa59V99e0Q%2Fimage.png?alt=media&#x26;token=c9050604-68e6-412f-a780-cd98ac6d2655" alt=""><figcaption></figcaption></figure>

**Operador do campo calculado**: Informe o operador que será utilizado no campo calculado

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FTQdsZw2vTGE40FtP5MIq%2Fimage.png?alt=media&#x26;token=7f487d37-9977-44fb-9747-1cdabeef609e" alt=""><figcaption></figcaption></figure>

5. Preencha as informações da **Notificação.**

* **Proporções da margem**: o alarme será acionado sempre que atingir a proporção configurada.&#x20;
* **Enviar notificação**:  selecione sim para envio da notificação sempre que o alarme for acionado.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FwYoxByichgir6jI9Wa3M%2Fimage.png?alt=media&#x26;token=111c3d6c-88e2-4c74-8f3e-37060f232145" alt="" width="563"><figcaption></figcaption></figure>

Ao selecionar **Sim**, o sistema irá solicitar as informações adicionais:

* **Ciclo**: Quantidade de vezes que a notificação será enviada, podendo avisar uma vez ou sempre.
* **Grupos de Notificações**: Selecione o grupo de notificação que será acionado.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F7w3vFLKpeaAYjO2clEFQ%2Fimage.png?alt=media&#x26;token=325fd37d-a83d-4bf9-9b39-cfea5060fd58" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Para seleção do Grupo de Notificação, será necessário configurar as grupos desejados na funcionalidade de [Notificações](https://docs.piercloud.com.br/plataforma-de-finops/configuracao-plataforma/funcionalidades-de-setup/notificacoes). Para que eles estejam previamente cadastrados e possam ser selecionados.
{% endhint %}