

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á.

# Configurar regras de gravação
<a name="v10-alerting-configure-recordingrules"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 10.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 9.x, consulte [Trabalhar no Grafana versão 9](using-grafana-v9.md).  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 8.x, consulte [Trabalhar no Grafana versão 8](using-grafana-v8.md).

Você pode criar e gerenciar regras de gravação para uma instância externa do Grafana Mimir ou Loki. As regras de gravação calculam expressões frequentemente necessárias ou computacionalmente caras e salvam os resultados como um novo conjunto de séries temporais. Consultar essa nova série temporal é mais rápida, especialmente para dashboards, pois eles consultam a mesma expressão toda vez que os dashboards são atualizados.

**nota**  
As regras de gravação são executadas como regras de instância e a cada dez segundos.

**Pré-requisitos**
+ Verifique se você tem permissões de gravação na fonte de dados Prometheus ou Loki. Você criará ou atualizará as regras de alerta na fonte de dados.
+ Para as fontes de dados Grafana Mimir e Loki, habilite a API Ruler configurando seus respectivos serviços.
  + **Loki**: o tipo de armazenamento `local` de regras, padrão para a fonte de dados Loki, é compatível apenas com a visualização de regras. Para editar regras, configure um dos outros tipos de armazenamento.
  + **Grafana Mimir**: use o prefixo `/prometheus`. A fonte de dados Prometheus é compatível com o Grafana Mimir e o Prometheus, e o Grafana espera que a API Query e a API Ruler estejam no mesmo URL. Você não pode fornecer um URL separado para a API Ruler.

**nota**  
Se você não quiser gerenciar as regras de alertas para uma fonte de dados Loki ou Prometheus específica, acesse as configurações e desmarque a caixa de seleção **Gerenciar alertas por meio da interface de usuário de alertas**.

**Para criar regras de gravação**

1. No console do Grafana, no menu Grafana, escolha **Alertas**, **Regras de alerta**.

1. Escolha **Nova regra de gravação**.

1. Defina o nome da regra.

   O nome da regra de gravação deve ser um nome de métrica do Prometheus e não deve conter espaços em branco.

1. Definir consulta
   + Selecione a fonte de dados Loki ou Prometheus.
   + Insira uma consulta.

1. Adicione namespace e grupo.
   + No menu suspenso **Namespace**, selecione um namespace de regra existente ou adicione um novo. Os namespaces podem conter um ou mais grupos de regras e ter apenas uma finalidade organizacional.
   + No menu suspenso **Grupo**, selecione um grupo existente no namespace selecionado ou adicione um novo. As regras recém-criadas são anexadas ao final do grupo. As regras em um grupo são executadas sequencialmente em intervalos regulares, com o mesmo tempo de avaliação.

1. Adicione rótulos.
   + Adicione rótulos personalizados selecionando pares de chave/valor existentes no menu suspenso, ou adicione novos rótulos inserindo a nova chave ou valor.

1. Escolha **Salvar regra** para salvar a regra ou **Salvar regra e sair** para salvar a regra e voltar para a página de alertas.