

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

# Criar regras de gravação gerenciadas pelo Grafana Mimir ou Loki
<a name="v9-alerting-managerules-mimir-loki-recording"></a>

****  
Este tópico de documentação foi desenvolvido para espaços de trabalho do Grafana compatíveis com o **Grafana versão 9.x**.  
Para espaços de trabalho do Grafana compatíveis com o Grafana versão 10.x, consulte [Trabalhar no Grafana versão 10](using-grafana-v10.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.

**Pré-requisitos**

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**: ao configurar uma fonte de dados para apontar para o Grafana Mimir, use o prefixo `/api/prom` legado, não `/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 adicionar uma regra de gravação gerenciada pelo Grafana Mimir ou Loki**

1. No console do Grafana, no menu Grafana, escolha o ícone de **Alertas** (sino) para abrir a página **Alertas** listando os existentes.

1. Escolha **Criar regra de alerta**.

1. Na **Etapa 1**, adicione o tipo de regra, o nome da regra e o local de armazenamento, conforme a seguir.
   + Selecione a opção de **regra de gravação do Mimir ou Loki**.
   + Em **Nome da regra**, adicione um nome descritivo. Esse nome é exibido na lista de regras de alerta. Também é o rótulo `alertname` de cada instância de alerta criada dessa regra.
   + No menu suspenso **Selecionar fonte de dados**, selecione uma fonte de dados Prometheus ou Loki.
   + No menu suspenso **Namespace**, selecione um namespace de regra existente. Do contrário, escolha **Adicionar novo** e insira um nome para criar um. Os namespaces podem conter um ou mais grupos de regras e ter apenas uma finalidade organizacional. Para obter mais informações, consulte [Namespaces e grupos de regras do Cortex ou Loki](alert-rules.md#alert-rule-groups).
   + No menu suspenso **Grupo**, selecione um grupo existente no namespace selecionado. Do contrário, escolha **Adicionar novo** e insira um nome para criar um. 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. Na **Etapa 2**, adicione a consulta a ser avaliada.

   O valor pode ser uma expressão PromQL ou LogQL. A regra iniciará um alerta se o resultado da avaliação tiver pelo menos uma série com um valor maior que 0. Um alerta é criado para cada série.

1. Na **Etapa 3**, adicione outros metadados associados à regra.
   + Adicione uma descrição e um resumo para personalizar as mensagens de alerta. Use as diretrizes em [Anotações e rótulos para regras de alerta](alert-rules.md#alert-rule-labels).
   + Adicione URL, painel, painel e alerta IDs do Runbook.
   + Adicione rótulos personalizados.

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