As regras Pipeline abrangem dois tipos: regras de gateway e regras cloud . Ambos são criados usando o mesmo método. As regras de gateway se aplicam a toda a organização, enquanto as regras cloud são específicas da conta. As regras de gateway podem ter diferenças ou incompatibilidades específicas, principalmente em relação a considerações sobre agentes e tipos de dados.
Você tem duas maneiras de criar regras de pipeline por meio da interface do usuário do New Relic: o método guiado ou escrevendo sua própria consulta NRQL. O método guiado fornece 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 cloud por meio de uma API.
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.
Importante
- As regras de Controle de Pipeline só se aplicam aos dados que chegam a partir do momento em que você cria a regra; elas não excluem dados que já foram ingeridos.
- As regras do gateway exigem a implantação do gateway.
- Ao criar regras, você é responsável por garantir que elas identifiquem e descartem com precisão os dados que atendem às condições que você estabeleceu. Você também é responsável por monitorar a regra, bem como os dados que você divulga à New Relic.
Por meio de método guiado
Siga estas etapas para criar uma regra de gateway de pipeline por meio do método guiado:
No New Relic, acesse o New Relic Control e abra a aba Pipeline Rules .
Clique em Criar uma regra. No assistente que aparece, o método guiado é selecionado por padrão.
Selecione o tipo de dados que deseja filtrar: métrica, evento, logs ou trace e clique em Avançar.
Insira o nome da regra.
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.
Selecione Cloud rule ou Gateway rule dependendo se você deseja implantar a regra na nuvem da New Relic ou no(s) cluster(s) de gateway hospedados em sua própria rede.
Opcionalmente, adicione uma descrição amigável para sua regra.
Para regras cloud , certifique-se de que a conta atual esteja selecionada. Para o gateway, a regra será aplicada a todos os dados enviados por meio do(s) seu(s) gateway(s) em toda a organização.
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áusulaWHERE
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.
Salve a regra. A regra é implantar.
Ao escrever uma consulta NRQL
Siga estas etapas para criar uma regra Pipeline escrevendo sua própria consulta NRQL :
- No New Relic, acesse o New Relic Control e abra a aba Pipeline Rules .
- Clique em Create a rule. O assistente Criar uma nova regra é exibido. O método guiado é selecionado por padrão.
- Selecione Write a NRQL query.
- Insira o nome da regra.
- Para escrever sua própria consulta NRQL para filtrar dados, clique em Write your query. O criador de consulta abre na parte inferior.
- 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. - Quando estiver satisfeito, clique em Save rule. A palavra-chave
SELECT
será substituída pela palavra-chaveDELETE
ao salvar, de modo que a regra descartará os dados que você referenciou usandoSELECT
. - Selecione Cloud rule ou Gateway rule dependendo se você deseja implantar a regra na nuvem da New Relic ou no(s) cluster(s) de gateway hospedados em sua própria rede.
- Para a regra cloud , você também terá que selecionar a conta à qual deseja que a regra seja aplicada.
- Clique em Save. A regra agora é implantar.
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.
A criação de regras sobre dados confidenciais pode vazar informações sobre os tipos de dados que você mantém, incluindo o formato dos seus dados ou sistemas (por exemplo, por meio de referência a endereços de e-mail ou números de cartão de crédito específicos). As regras que você cria, incluindo todas as informações nessas regras, podem ser visualizadas e editadas por qualquer usuário com as permissões de controle de acesso baseadas em função relevantes.
Próxima Etapa
Implemente um balanceador de carga para seu cluster de gateway.