Les règles cloud Pipeline Control s'exécutent dans l'infrastructure de New Relic et traitent les données après qu'elles ont atteint les endpoints de New Relic. Utilisez des règles cloud pour supprimer les données ou attributs indésirables sans gérer d'infrastructure.
Les règles cloud sont spécifiques au compte, créées à l'aide de NRQL et gérées via l'interface utilisateur New Relic ou l'API NerdGraph. Pour traiter les données avant qu'elles ne quittent votre réseau, consultez Pipeline Control gateway.
Pour savoir quand utiliser les règles cloud ou le gateway, consultez la vue d'ensemble de Pipeline Control.
Vous avez deux façons de créer des règles cloud via l'interface utilisateur New Relic : la méthode guidée ou en écrivant votre propre requête NRQL. La méthode guidée propose un assistant pas à pas pour vous aider à configurer des règles, tandis que l'option de requête NRQL permet de créer des requêtes personnalisées pour filtrer les données avec précision. Vous pouvez également gérer les règles cloud via une API. Pour la configuration du gateway, consultez la documentation du gateway.
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.
Important
- Les règles de contrôle de pipeline s'appliquent uniquement aux données qui arrivent à partir du moment où vous créez la règle, elles ne suppriment pas les données qui ont déjà été ingérées.
- Les règles de gateway nécessitent le déploiement du gateway.
- Vous devez disposer des capacités de contrôle d'accès basé sur les rôles (RBAC) appropriées pour créer une règle. Pour plus de détails, veuillez vous référer aux prérequis. 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 RBAC appropriées.
- Lors de la création de règles, vous êtes responsable de vous assurer que les règles identifient et suppriment avec précision les données qui répondent aux conditions que vous avez établies. Vous êtes également responsable du monitoring de la règle, ainsi que des données que vous divulguez à New Relic.
Par méthode guidée
Suivez ces étapes pour créer une règle cloud via la méthode guidée :
Dans New Relic, accédez à New Relic Control et ouvrez l’onglet Pipeline Rules.
Cliquez sur Create a rule. Dans l'assistant qui apparaît, la méthode guidée est sélectionnée par défaut.
Sélectionnez le type de données que vous souhaitez filtrer : métriques, événements, logs ou traces, puis cliquez sur Next.
Entrez le nom de la règle.
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.
Sélectionnez Cloud rule pour déployer la règle sur l'infrastructure de New Relic.
Vous pouvez également ajouter une description conviviale pour votre règle.
Pour les règles cloud, assurez-vous que le compte actuel est sélectionné.
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
WHEREpour définir la portée des données de requête. La clauseWHEREvous 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
WHEREpour 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
WHEREpour 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
WHEREpour 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.
Sauvegarder la règle. La règle est
En écrivant une requête NRQL
Suivez ces étapes pour créer une règle cloud en rédigeant votre propre requête NRQL :
- Dans New Relic, accédez à New Relic Control et ouvrez l’onglet Pipeline Rules.
- 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.
- Sélectionnez Write a NRQL query.
- Entrez le nom de la règle.
- 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.
- Écrivez votre requête en utilisant le mot-clé
SELECTet 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. - Lorsque vous êtes satisfait, cliquez sur Save rule. Le mot-clé
SELECTsera remplacé par le mot-cléDELETElors de l'enregistrement, de sorte que la règle supprimera les données que vous avez référencées à l'aide deSELECT. - Sélectionnez Cloud rule pour déployer la règle sur l'infrastructure cloud de New Relic.
- Pour la règle cloud, vous devrez également sélectionner le compte auquel vous souhaitez que la règle s'applique.
- Cliquez sur Save. La règle est désormais déployée.
Pour obtenir la liste des fonctions NRQL prises en charge dans les règles de pipeline, reportez-vous à Fonctions NRQL.
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.
L'établissement de règles concernant les données sensibles peut entraîner la divulgation d'informations sur les types de données que vous conservez, notamment le format de vos données ou de votre système (par exemple, en faisant référence à des adresses électroniques ou à des numéros de carte de crédit spécifiques).
Prochaine étape
- Pour les règles cloud, votre règle est désormais déployée et active.
- Pour la configuration du gateway, consultez la documentation du gateway.
- Pour la configuration de l'infrastructure du gateway, implémentez un équilibreur de charge pour votre cluster de gateways](/docs/new-relic-control/pipeline-control/load-balancer-for-gateway).