Criar regras de pipeline

As regras de nuvem do Pipeline Control são executadas na infraestrutura da New Relic e processam dados depois que eles chegam aos endpoints da New Relic. Use regras de nuvem para descartar dados ou atributos indesejados sem gerenciar nenhuma infraestrutura.

As regras de nuvem são específicas da conta, criadas usando NRQL e gerenciadas por meio da interface do New Relic ou da API NerdGraph. Para processar dados antes que eles saiam da sua rede, consulte o Pipeline Control gateway.

Para entender quando usar regras de nuvem versus gateway, consulte a visão geral do Pipeline Control.

Você tem duas maneiras de criar regras de nuvem por meio da interface do New Relic: o método guiado ou escrevendo sua própria consulta NRQL. O método guiado oferece um assistente passo a passo para ajudar você a configurar regras, enquanto a opção de consulta NRQL permite a criação de consultas personalizadas para filtrar dados com precisão. Você também pode gerenciar regras de nuvem via API. Para configuração do gateway, consulte a documentação do Gateway.

Ao criar uma regra usando o método guiado, você pode especificar o tipo de dados que deseja filtrar, incluindo métrica, evento, logs ou rastreamento. Além disso, você pode decidir onde implantar a regra como uma regra cloud em execução na infraestrutura do New Relicou como uma regra de gateway em execução no seu ambiente.

Por meio de método guiado

Siga estas etapas para criar uma regra de nuvem por meio do método guiado:

1. No New Relic, acesse o New Relic Control e abra a aba Pipeline Rules .

2. Clique em Criar uma regra. No assistente que aparece, o método guiado é selecionado por padrão.

3. Selecione o tipo de dados que deseja filtrar: métrica, evento, logs ou trace e clique em Avançar.

4. Insira o nome da regra.

5. Selecione se você deseja descartar dados ou atributos. Se você quiser remover registros inteiros, selecione Drop data. Se você quiser remover atributos ou propriedades específicas em dados que de outra forma seriam preservados, selecione Drop attributes.

6. Selecione Cloud rule para implantar a regra na infraestrutura da New Relic.

7. Opcionalmente, adicione uma descrição amigável para sua regra.

8. Para regras de nuvem, certifique-se de que a conta atual esteja selecionada.

9. Dependendo do tipo de dados de telemetria que você selecionar anteriormente, execute a seguinte ação: Para métrica:

   • Selecione a métrica para a qual você deseja descartar dados.
   • Filtrar dados usando a cláusula NRQL WHERE para delimitar os dados da consulta. A cláusula WHERE permite que você adicione filtragem condicional em vários tipos de dados.
   • Se você estiver descartando o atributo, use o menu suspenso para especificar o atributo métrico. Para evento:
   • Selecione o evento para o qual você deseja descartar dados.
   • Filtrar dados usando a cláusula NRQL WHERE para delimitar os dados da consulta.
   • Se você estiver descartando o atributo, use o menu suspenso para especificar o atributo do evento. Para logs:
   • Selecione a partição para a qual você deseja descartar dados.
   • Filtrar dados usando a cláusula NRQL WHERE para delimitar os dados da consulta. Exemplo de filtragem de log: level = 'INFO' Isso permite que você restrinja sua consulta a condições específicas, como filtrar logs por nível de log, tipos de erro ou outros atributos relevantes.
   • Se você estiver descartando o atributo, use o menu suspenso para especificá-lo. Para rastreamento:
   • Filtrar dados usando a cláusula NRQL WHERE para delimitar os dados da consulta.
   • Se você estiver descartando o atributo, use o menu suspenso para especificá-lo.

10. Salve a regra. A regra é implantar.

Ao escrever uma consulta NRQL

Siga estas etapas para criar uma regra de nuvem escrevendo sua própria consulta NRQL:

1. No New Relic, acesse o New Relic Control e abra a aba Pipeline Rules .
2. Clique em Create a rule. O assistente Criar uma nova regra é exibido. O método guiado é selecionado por padrão.
3. Selecione Write a NRQL query.
4. Insira o nome da regra.
5. Para escrever sua própria consulta NRQL para filtrar dados, clique em Write your query. O criador de consulta abre na parte inferior.
6. Escreva sua consulta usando a palavra-chave SELECT e teste-a clicando em Run. Isso mostrará um exemplo dos dados que serão impactados por essa regra no futuro, quando forem ingeridos. Entretanto, os dados em repouso não serão afetados pela regra que você criar.
7. Quando estiver satisfeito, clique em Save rule. A palavra-chave SELECT será substituída pela palavra-chave DELETE ao salvar, de modo que a regra descartará os dados que você referenciou usando SELECT.
8. Selecione Cloud rule para implantar a regra na infraestrutura de nuvem da New Relic.
9. Para a regra cloud , você também terá que selecionar a conta à qual deseja que a regra seja aplicada.
10. Clique em Save. A regra agora é implantar.

Para obter a lista de funções NRQL suportadas em regras de pipeline, consulte Funções NRQL.

Cuidado

A New Relic não pode garantir que esta funcionalidade resolverá completamente suas preocupações com divulgação de dados. A New Relic não analisa nem monitora a eficácia das regras que você desenvolve. Sempre teste e teste novamente sua consulta e, depois que a regra de descarte for criada, certifique-se de que ela funciona conforme o esperado.

Criar regras sobre dados sensíveis pode vazar informações sobre os tipos de dados que você mantém, incluindo o formato dos seus dados ou sistemas (por exemplo, referenciando endereços de e-mail ou números específicos de cartão de crédito).

Próxima Etapa

• Para regras de nuvem, sua regra agora está implantada e ativa.
• Para configuração do gateway, consulte a documentação do Gateway.
• Para a configuração da infraestrutura de gateway, implemente um balanceador de carga para o seu cluster de gateway](/docs/new-relic-control/pipeline-control/load-balancer-for-gateway).