Mettre en place et déployer le gateway Contrôle de pipeline

Configurez et déployez le gateway Contrôle de pipeline pour gérer le flux de données de votre entité de monitoring vers New Relic.

Considérations relatives à l'utilisation du gateway

Lorsque vous intégrez et utilisez le composant de gateway, voici quelques considérations importantes à garder à l’esprit :

Gestion des attributs et des données

• Prise en charge des attributs : Le gateway utilise les conventions sémantiques OpenTelemetry pour les attributs. Consultez la documentation du gateway pour plus de détails sur les attributs pris en charge.
• Gestion des données/attributs : Le gateway transmet vos requests de suppression de données ou d'attributs pour les données métriques de tranche horaire, de trace et de trace directement à New Relic sans modification.

Analyse et intégration des données

• Analyse des logs : Le gateway n'inclut pas l'analyse Grok pour les logs. Grok analyse est une méthode utilisée pour extraire des données structurées à partir de messages de log non structurés en utilisant des modèles prédéfinis et des expressions régulières. Vous aurez peut-être besoin de méthodes alternatives pour structurer les données log à des fins d’interrogation et de visualisation.
• IntégrationPrometheus : le gateway ne prend pas en charge l'écriture à distance Prometheus pour les métriques, ce qui peut affecter votre intégration avec le système basé sur Prometheus .

Licences et conformité

• Gestion des clés de licence : le gateway ne prend pas en charge plusieurs clés de licence provenant de sources natives du protocole OpenTelemetry (OTLP), telles que les collecteurs d'agents ou les SDK APM. Tenez-en compte lors de la gestion de vos licences.
• Normes de conformité : le gateway n'est pas conforme à FedRAMP, ce qui peut affecter votre utilisation si vous devez respecter les normes de sécurité fédérales.

Prérequis

• Permissions Kubernetes : ce mode d'installation nécessite des permissions cluster-admin pour les contrôleurs Flux afin de gérer le cycle de vie du gateway (installation, mises à niveau, mise à l'échelle).

• Outils requis :

  • Helm v3.x ou version ultérieure (vérifier avec helm version)
  • kubectl CLI avec accès à votre cluster Kubernetes

• Agent New Relic Infrastructure (facultatif) : le gateway Contrôle de pipeline n'inclut plus l'agent New Relic Infrastructure. Pour afficher les métriques de santé du cluster (utilisation du CPU, mémoire et région) dans le dashboard de santé du gateway, installez l'agent d'infrastructure séparément. Reportez-vous à Installer l'intégration Kubernetes pour les instructions d'installation.

Ce qui se passe sans l'agent d'infrastructure :

• Le tableau d'état de santé du gateway affichera "N/A" pour : l'utilisation du CPU, l'utilisation de la mémoire et la région.
• La configuration du Pipeline et le traitement des données continuent de fonctionner normalement.

Mettre en place le gateway Contrôle de pipeline

Pour configurer le gateway :

1. Dans votre compte New Relic, dans Intégration et Agents, cliquez sur Set up Pipeline Control ou recherchez gateway et sélectionnez Pipeline Control gateway.

2. Assurez-vous que le compte sélectionné est celui que vous souhaitez utiliser pour Contrôle de pipeline. Sinon, cliquez sur Select an account, sélectionnez le compte de votre choix, puis cliquez sur Continue.

3. Pour saisir vos informations d'identification, fournissez une clé de licence existante ou créez une nouvelle clé. Si vous créez une nouvelle clé, copiez la clé. Ensuite, cliquez sur Continue.

4. Sélectionner ou créer une flotte de gateways :

   • Sélectionnez une flotte existante si vous souhaitez que votre nouvelle gateway partage une configuration existante (règles d'échantillonnage, de filtrage et de transformation) avec d'autres gateways de votre organisation.
   • Saisissez un nom de flotte de gateways unique si vous avez besoin d'une nouvelle configuration isolée pour un environnement ou une unité commerciale spécifique.

5. Sélectionnez Full management (with Flux).

6. Configurez le gateway :

   • Entrez le nom de votre cluster.
   • Saisissez l'espace de nommage Kubernetes dédié où résideront l'infrastructure principale du gateway et les services de gestion. La valeur par défaut est newrelic-agent-control.
   • Saisissez l'espace de nommage spécifique où les agents de collecte individuels s'exécuteront. La valeur par défaut est newrelic.

7. Téléchargez le fichier de configuration, values-newrelic-gateway.yaml dans un répertoire.

8. Exécutez la commande d’installation affichée à l’écran :

   bash

   Copier

   $
   helm repo add newrelic https://helm-charts.newrelic.com && helm repo update && helm upgrade --install agent-control-bootstrap -n newrelic-agent-control newrelic/agent-control-bootstrap --create-namespace --values values-newrelic-gateway.yaml

   Conseil

   L'assistant de l'interface utilisateur fournit le fichier de valeurs complet, values-newrelic-gateway.yaml, avec votre configuration spécifique. Téléchargez le fichier et utilisez-le avec la commande Helm.

9. Cliquez sur Continue.

10. Cliquez sur Test connection et attendez une connexion réussie.

Pour afficher les détails de la configuration de votre gateway, accédez à New Relic Control et cliquez sur Gateway.

Pourquoi utiliser plusieurs flottes ?

Imaginez qu’une entreprise (The Corp) possède deux divisions : OrgA (nécessite 100 % des données pour des raisons d’audit) et OrgB (nécessite un échantillonnage de 1 % pour contrôler les coûts liés aux volumes élevés).

Avec une seule flotte, The Corp est bloqué. Si OrgB applique un échantillonnage de 1 % pour faire des économies, OrgA perd 99 % de ses données de performance. Le contrôle des coûts d’une équipe compromet le monitoring critique de l’autre équipe.

En utilisant plusieurs flottes, The Corp peut séparer ses "cerveaux" :

• Flotte critique: OrgA rejoint cette flotte pour obtenir 100 % de rétention des données.
• Flotte à volume élevé: OrgB rejoint cette flotte pour un échantillonnage à 1 % et le masquage des données personnelles.

Par conséquent, des équipes distinctes peuvent désormais gérer des règles d'échantillonnage, de sécurité et de conformité uniques sans affecter le reste de l'organisation.

Ajouter plus de clusters

Pour ajouter un nouveau cluster à votre configuration de gateway,

1. Ouvrez New Relic Control, puis sélectionnez Gateway.
2. Dans la table des clusters, cliquez sur Ajouter un cluster.
3. Suivez les instructions de configuration du gateway.
4. Revenez à la page récapitulative du gateway. Vous devriez voir votre cluster nouvellement ajouté.

Une fois vos clusters de gateways créés, configurez le traitement du pipeline à l'aide de la configuration YAML. Consultez la configuration du gateway.