Créer des règles de pipeline

Les règles Pipeline englobent deux types : les règles de gateway et les règles cloud . Les deux sont rédigés selon la même méthode. Les règles de gateway s'appliquent à l'échelle de l'organisation, tandis que les règles cloud sont spécifiques au compte. Les règles de gateway peuvent présenter des différences ou des incompatibilités spécifiques, notamment en ce qui concerne les considérations relatives aux agents et aux types de données.

Vous avez deux manières de créer des règles pipeline via l'interface utilisateur de New Relic : la méthode guidée ou en écrivant votre propre requête NRQL. La méthode guidée fournit un assistant étape par étape pour vous aider à configurer les règles, tandis que l'option de requête NRQL permet la création de requêtes personnalisées pour filtrer les données avec précision. Vous pouvez également gérer les règles du cloud via une API.

Lors de la création d'une règle à l'aide de la méthode guidée, vous pouvez spécifier le type de données que vous souhaitez filtrer, notamment les métriques, les événements, les logs ou les traces. De plus, vous pouvez décider où déployer la règle en tant que règle cloud exécutée dans l'infrastructure de New Relic ou en tant que règle de gateway exécutée dans votre environnement.

Par méthode guidée

Suivez ces étapes pour créer une règle de gateway de pipeline via la méthode guidée :

1. Dans New Relic, accédez à New Relic Control et ouvrez l’onglet Pipeline Rules.

2. Cliquez sur Create a rule. Dans l'assistant qui apparaît, la méthode guidée est sélectionnée par défaut.

3. Sélectionnez le type de données que vous souhaitez filtrer : métriques, événements, logs ou traces, puis cliquez sur Next.

4. Entrez le nom de la règle.

5. Sélectionnez si vous souhaitez supprimer des données ou des attributs. Si vous souhaitez supprimer des enregistrements entiers, sélectionnez Drop data. Si vous souhaitez supprimer un attribut ou des propriétés spécifiques sur des données qui sont autrement conservées, sélectionnez Drop attributes.

6. Sélectionnez Cloud rule ou Gateway rule selon que vous souhaitez déployer la règle sur cloud de New Relic ou sur le(s) cluster(s) de gateway hébergé(s) sur votre propre réseau.

7. Vous pouvez également ajouter une description conviviale pour votre règle.

8. Pour les règles cloud, assurez-vous que le compte actuel est sélectionné. Pour le gateway, la règle s'appliquera à toutes les données envoyées via votre/vos gateway(s) dans l'ensemble de l'organisation.

9. En fonction du type de données télémétriques que vous avez sélectionné précédemment, effectuez l'action suivante : Pour les métriques :

   • Sélectionnez la métrique pour laquelle vous souhaitez supprimer des données.
   • Filtrez les données à l'aide de la clause NRQL WHERE pour définir la portée des données de requête. La clause WHERE vous permet d’ajouter un filtrage conditionnel sur différents types de données.
   • Si vous supprimez un attribut, utilisez le menu déroulant pour spécifier l'attribut métrique. Pour l'événement :
   • Sélectionnez l’événement pour lequel vous souhaitez supprimer des données.
   • Filtrez les données à l'aide de la clause NRQL WHERE pour définir la portée des données de requête.
   • Si vous supprimez un attribut, utilisez le menu déroulant pour spécifier l'attribut événement. Pour les logs :
   • Sélectionnez la partition pour laquelle vous souhaitez supprimer les données.
   • Filtrez les données à l'aide de la clause NRQL WHERE pour définir la portée des données de requête. Exemple de filtrage log : level = 'INFO' Cela vous permet de restreindre votre requête à des conditions spécifiques, telles que le filtrage des logs par leur niveau de log, leurs types d'erreur ou tout autre attribut pertinent.
   • Si vous supprimez un attribut, utilisez le menu déroulant pour spécifier l'attribut. Pour les traces :
   • Filtrez les données à l'aide de la clause NRQL WHERE pour définir la portée des données de requête.
   • Si vous supprimez un attribut, utilisez le menu déroulant pour spécifier l'attribut.

10. Sauvegarder la règle. La règle est

En écrivant une requête NRQL

Suivez ces étapes pour créer une règle Pipeline en écrivant votre propre requête NRQL :

1. Dans New Relic, accédez à New Relic Control et ouvrez l’onglet Pipeline Rules.
2. Cliquez sur Créer une règle. L'assistant Créer une nouvelle règle apparaît. La méthode guidée est sélectionnée par défaut.
3. Sélectionnez Write a NRQL query.
4. Entrez le nom de la règle.
5. Pour écrire votre propre requête NRQL pour filtrer les données, cliquez sur Write your query. Le générateur de requêtes s'ouvre en bas.
6. Écrivez votre requête en utilisant le mot-clé SELECT et testez-la en cliquant sur Run. Cela vous montrera un exemple des données qui seront impactées par cette règle à l'avenir lorsqu'elles seront ingérées. Cependant, les données au repos ne seront pas affectées par la règle que vous avez créée.
7. Lorsque vous êtes satisfait, cliquez sur Save rule. Le mot-clé SELECT sera remplacé par le mot-clé DELETE lors de l'enregistrement, de sorte que la règle supprimera les données que vous avez référencées à l'aide de SELECT.
8. Sélectionnez Cloud rule ou Gateway rule selon que vous souhaitez déployer la règle sur cloud de New Relic ou sur le(s) cluster(s) de gateway hébergé(s) sur votre propre réseau.
9. Pour la règle cloud, vous devrez également sélectionner le compte auquel vous souhaitez que la règle s'applique.
10. Cliquez sur Save. La règle est désormais déployée.

Prudence

New Relic ne peut pas garantir que cette fonctionnalité résoudra complètement les problèmes de divulgation de données que vous pourriez avoir. New Relic ne révise pas et ne monitore pas l'efficacité des règles que vous développez. Testez et retestez toujours votre requête et, une fois la règle de suppression créée, assurez-vous qu'elle fonctionne comme prévu.

La création de règles sur les données sensibles peut entraîner une fuite d'informations sur les types de données que vous conservez, y compris le format de vos données ou de votre système (par exemple, en référençant des adresses e-mail ou des numéros de carte de crédit spécifiques). Les règles que vous créez, y compris toutes les informations qu'elles contiennent, peuvent être consultées et modifiées par tout utilisateur disposant des autorisations de contrôle d'accès basées sur les rôles appropriées.

Prochaine étape

Implémentez un équilibreur de charge pour votre cluster de gateway.