> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md).

# Políticas de automação

Reúna checks, tarefas, uma política de atualizações e um modelo de alerta em uma política de automação, atribua-a a clientes, sites ou dispositivos e controle herança, precedência e exclusões.

## O que é e quando usar

Uma política de automação é um pacote reutilizável de monitoramento e manutenção: um conjunto de [checks](https://wiki.datadike.com/pt/sonar/administration/automation/checks.md), um conjunto de [tarefas automatizadas](https://wiki.datadike.com/pt/sonar/administration/automation/automated-tasks.md), uma [política de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md) opcional e um [modelo de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md) opcional. Você monta a política uma vez e a atribui onde ela se aplica; todo dispositivo coberto pela atribuição recebe os checks e as tarefas dela sem precisar ser configurado um a um.

Use políticas para a base de cada tipo de dispositivo (por exemplo, todas as estações de trabalho de um cliente recebem as mesmas regras de disco, de serviço e de limpeza) e reserve os checks e as tarefas no nível do dispositivo para as exceções.

## Antes de começar

* Um papel com **List Automation Policies** para abrir a lista e **Manage Automation Policies** para criar, editar, copiar, excluir e definir exclusões, ambos no grupo **Automation & Tasks** de **Admin Center › Roles**. Adicionar checks e tarefas a uma política também exige **Manage Checks** e **Manage Tasks**.
* Para atribuir uma política, a caixa de diálogo **Assign Automation Policy** exige **Manage Policies** (grupo **Policies**), e salvar a atribuição exige o direito de alterar o alvo: **Manage Clients** para um cliente, **Manage Sites** para um site, **Edit Agent** para um dispositivo.
* Os scripts usados pelos checks de script e pelas tarefas, em **Management › Scripts**.

## Como as políticas chegam a um dispositivo

Um dispositivo pode receber até quatro políticas, uma de cada nível:

| Nível       | Onde é definida                                                                                              | Aplica-se a                                          |
| ----------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------- |
| Dispositivo | **Assign Automation Policy** no dispositivo, campo **Policy**                                                | Esse dispositivo                                     |
| Site        | **Assign Automation Policy** no site, campos **Server Policy** e **Workstation Policy**                      | Os servidores ou as estações de trabalho do site     |
| Cliente     | **Assign Automation Policy** no cliente, os mesmos dois campos                                               | Os servidores ou as estações de trabalho do cliente  |
| Padrão      | **Admin Center › Settings › General**, seção **Defaults**, campos **Server Policy** e **Workstation Policy** | Todos os servidores ou todas as estações de trabalho |

Qual dos dois campos se aplica depende do tipo do dispositivo (servidor ou estação de trabalho). Uma política só tem efeito enquanto está **Active**.

**Block policy inheritance** bloqueia as políticas dos níveis superiores: em um dispositivo, ignora as políticas do site, do cliente e padrão; em um site, ignora as políticas do cliente e padrão; em um cliente, ignora a política padrão.

Um dispositivo que consta das exclusões de uma política, ou que pertence a um site ou a um cliente que consta delas, não recebe essa política; os outros níveis continuam valendo.

### Precedência

* As **tarefas** se somam: o dispositivo executa as próprias tarefas mais as tarefas de todas as políticas que chegam até ele, nas plataformas que cada tarefa suporta.
* Os **checks** são mesclados por tipo, de modo que um dispositivo nunca executa dois checks do mesmo tipo: um check de CPU, um check de memória, um check de disco por unidade, um check de ping por alvo, um check de serviço por serviço, um check de script por script, um check de log de eventos por log e ID de evento. Quando dois checks do mesmo tipo se encontram, vence o primeiro nesta ordem:

  1. os checks das políticas **Enforced**,
  2. os checks do próprio dispositivo,
  3. os checks das demais políticas.

  Dentro de cada grupo, a política do dispositivo vem primeiro, depois a do site, a do cliente e a padrão. Um check do dispositivo que perde para um check de política imposta mostra `This check is overriden by a policy` na aba **CHECKS** do dispositivo.

Os checks e as tarefas que só existem para Windows (checks de disco, CPU, memória, serviço e log de eventos, e tarefas limitadas ao Windows) são ignorados nos dispositivos Linux e macOS.

## Passos

### Criar uma política

1. Abra o menu **Management** no cabeçalho e escolha **Automations**.
2. Clique em **New**.
3. Em **Add Policy**, preencha **Policy Name** e **Description**.
4. Marque **Active** para que a política tenha efeito assim que for atribuída. Uma política nova fica inativa até você marcar essa opção.
5. Marque **Enforced** se os checks dela precisarem prevalecer sobre os checks dos próprios dispositivos. **Enforced** não tem efeito sobre a política de atualizações dela.
6. Clique em **Submit**. A confirmação diz `Policy added. Now you can add Tasks and Checks!`

### Adicionar checks e tarefas

1. Selecione a política na lista. As abas **Checks** e **Tasks** dela se abrem abaixo.
2. Em **Checks**, clique em **+** e escolha o tipo de check. Preencha o formulário conforme descrito em [Checks](https://wiki.datadike.com/pt/sonar/administration/automation/checks.md).
3. Em **Tasks**, clique em **Add Task** e preencha o formulário conforme descrito em [Tarefas automatizadas](https://wiki.datadike.com/pt/sonar/administration/automation/automated-tasks.md). Marque as **Supported Platforms** às quais a tarefa se aplica.

### Adicionar uma política de atualizações e um modelo de alerta

1. Na linha da política, clique em **Create Patch Policy** (ou **Modify Patch Policy**) e preencha o formulário descrito em [Política de aprovação de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md). Para o procedimento completo de manter os dispositivos Windows atualizados, veja [Automatizar as atualizações do Windows](https://wiki.datadike.com/pt/sonar/administration/patching/automate-windows-updates.md).
2. Clique em **Assign Alert Template** (ou **Modify Alert Template**) e escolha um modelo. Veja [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md).

### Atribuir a política

* **A um cliente ou a um site**: na lista **CLIENTS** da barra lateral, clique com o botão direito no cliente ou no site e escolha **Assign Automation Policy**. Escolha a **Server Policy** e a **Workstation Policy**, marque **Block policy inheritance** se necessário e clique em **Submit**.
* **A um dispositivo**: abra o menu de ações do dispositivo e escolha **Assign Automation Policy**. Escolha a **Policy**, marque **Block policy inheritance** se necessário e clique em **Submit**.
* **Como padrão**: em **Admin Center › Settings › General**, defina **Server Policy** e **Workstation Policy** em **Defaults** e salve.

A confirmação diz `Policies Updated Successfully!`

{% hint style="info" %}
Um cliente ou um site tem uma política para servidores e uma para estações de trabalho. Quando ele tem os dois tipos de dispositivo, preencha **Server Policy** e **Workstation Policy**; caso contrário, um dos tipos fica sem a política. Experimente uma política nova em um dispositivo ou site de teste antes de atribuí-la a um cliente inteiro.
{% endhint %}

### Definir exclusões de clientes, sites ou dispositivos

1. Na linha da política, clique em **Show Policy Exclusions (N)**, ou clique com o botão direito na política e escolha **Policy Exclusions**.
2. Adicione entradas a **Excluded Clients**, **Excluded Sites** ou **Excluded Agents**.
3. Salve. A confirmação diz `Policy exclusions added`.

### Copiar, editar, desativar ou excluir

* Clique no ícone de cópia (`Create a copy of this policy`) ou clique com o botão direito e escolha **Copy** para criar uma nova política com os mesmos checks e tarefas. As tarefas com o gatilho **On check failure** não são copiadas.
* Clique duas vezes em uma política, ou clique com o botão direito e escolha **Edit**, para alterar o nome, a descrição, **Active** ou **Enforced**.
* Desmarque **Active** na lista para interromper a política em todos os lugares sem excluí-la.
* Clique com o botão direito e escolha **Delete** para removê-la.

### Executar uma tarefa de política e acompanhar o status

* Na aba **Tasks** da política, clique em **Run** em uma tarefa para iniciá-la em todos os dispositivos que recebem a política. A confirmação diz `The task was initated on all affected agents`.
* Na aba **Checks** ou **Tasks**, clique em **See Status** para ver o resultado em cada dispositivo: **Hostname**, **Status**, **More Info** e **Date / Time** e, para as tarefas, se a tarefa está sincronizada com cada dispositivo Windows.

## O que você deve ver

A lista de políticas mostra **Active**, **Enforced**, **Name** (com o selo **Default Server** ou **Default Workstation** quando é uma política padrão), **Description**, **Relations** (`Show Relations (N)`), **Exclusions** (`Show Policy Exclusions (N)`), **Patch Policy**, **Alert Template** e **Actions**.

**Show Relations (N)** conta os dispositivos que recebem a política. A caixa de diálogo correspondente lista, nas abas **Clients** e **Sites**, onde a política está atribuída, com a marca **Applied to Servers** ou **Applied to Workstations**, e, na aba **Agents**, os dispositivos aos quais ela está atribuída diretamente.

## Como verificar se funcionou

1. Abra um dispositivo que deveria receber a política e escolha **Edit** no menu de ações dele. A aba **Automation Policies** lista a política que se aplica em cada nível (**Agent policy**, **Site policy**, **Client policy**, **Default policy**), marca as inativas como **Disabled** e mostra o **Alert Template** efetivo e a **Effective Patch Policy**.
2. Abra as abas **CHECKS** e **TASKS** do dispositivo. Os itens de política mostram o ícone de política (`This check is managed by a policy`, `This task is managed by a policy`).
3. Depois do próximo ciclo de checks, **See Status** na política lista o dispositivo com um resultado.
4. Em **Reports & Audits › Audits**, a criação e a alteração da política são registradas como **Add Object** e **Modify Object** em uma **Policy**.

## Erros comuns

| Sintoma                                                                                                     | Causa                                                                                                                        | Correção                                                 |
| ----------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| Os dispositivos não recebem a política                                                                      | A política não está **Active**                                                                                               | Marque **Active** na lista                               |
| Só os servidores (ou só as estações de trabalho) a recebem                                                  | A política foi definida em **Server Policy**, mas não em **Workstation Policy**, ou o inverso                                | Defina o campo que corresponde ao tipo do dispositivo    |
| Um dispositivo não recebe uma política de cliente ou padrão                                                 | **Block policy inheritance** está definido no dispositivo, no site ou no cliente dele, ou o dispositivo consta das exclusões | Revise as opções de herança e **Show Policy Exclusions** |
| Um check de política não aparece em um dispositivo Linux ou macOS                                           | O tipo de check é só para Windows, ou o script não suporta a plataforma                                                      | Use checks de ping ou de script nesses dispositivos      |
| O check do próprio dispositivo parou de rodar                                                               | Uma política imposta tem um check do mesmo tipo                                                                              | Remova um dos dois, ou tire a imposição da política      |
| **Submit** em **Assign Automation Policy** está desativado, com `You don't have permission for this action` | O papel não tem **Manage Policies**                                                                                          | Adicione a permissão                                     |
| A caixa de diálogo mostra `No Automation Policies have been setup.`                                         | Ainda não existe nenhuma política                                                                                            | Crie uma em **Management › Automations**                 |
| `Task cannot be run when it's disabled. Enable it first.`                                                   | **Run** em uma tarefa de política desativada                                                                                 | Ative a tarefa                                           |

## Referência de campos

### Add Policy / Edit Policy

| Campo       | O que faz                                                                         | Valores aceitos     | Padrão             |
| ----------- | --------------------------------------------------------------------------------- | ------------------- | ------------------ |
| Policy Name | Identifica a política. Precisa ser único                                          | Texto               | Vazio. Obrigatório |
| Description | Descrição livre                                                                   | Texto               | Vazio              |
| Active      | A política tem efeito onde for atribuída                                          | Ligado ou desligado | Desligado          |
| Enforced    | Os checks dela prevalecem sobre os checks do mesmo tipo dos próprios dispositivos | Ligado ou desligado | Desligado          |

### Assign Automation Policy

| Campo                    | Exibido para               | O que faz                                                   | Padrão    |
| ------------------------ | -------------------------- | ----------------------------------------------------------- | --------- |
| Server Policy            | Cliente, site              | Política para os servidores do cliente ou do site           | Nenhuma   |
| Workstation Policy       | Cliente, site              | Política para as estações de trabalho do cliente ou do site | Nenhuma   |
| Policy                   | Dispositivo                | Política para este dispositivo                              | Nenhuma   |
| Block policy inheritance | Cliente, site, dispositivo | Ignora as políticas dos níveis acima                        | Desligado |

### Policy Exclusions

| Campo            | O que faz                                                 |
| ---------------- | --------------------------------------------------------- |
| Excluded Clients | A política não se aplica aos dispositivos desses clientes |
| Excluded Sites   | A política não se aplica aos dispositivos desses sites    |
| Excluded Agents  | A política não se aplica a esses dispositivos             |

## Páginas relacionadas

* [Checks](https://wiki.datadike.com/pt/sonar/administration/automation/checks.md)
* [Tarefas automatizadas](https://wiki.datadike.com/pt/sonar/administration/automation/automated-tasks.md)
* [Política de aprovação de atualizações](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md)
* [Alertas e modelos de alerta](https://wiki.datadike.com/pt/sonar/administration/automation/alerts.md)
* [Clientes e sites](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md)
