Installer le gateway Contrôle de pipeline sans Flux

En installant le gateway Contrôle de pipeline en mode configuration uniquement, vous pouvez continuer à gérer le cycle de vie de la configuration de votre pipeline (échantillonnage, filtrage, transformations) via l'UI de New Relic tout en gérant l'infrastructure du gateway (mise à l'échelle, versions) à l'aide des commandes Kubernetes et Helm.

Quand utiliser ce mode d'installation

Choisissez ce mode d'installation si :

• Vos politiques de sécurité restreignent l’accès cluster-admin.
• Vous avez besoin d'un contrôle direct sur la mise à l'échelle et les mises à niveau de l'infrastructure.
• Vous êtes à l'aise pour gérer les ressources Kubernetes à l'aide des commandes kubectl et Helm.
• Vous déployez dans des environnements soumis à des exigences de conformité.

Ce que vous obtenez :

• Gestion de la configuration de votre pipeline (échantillonnage, filtrage, transformations) via l'interface utilisateur.
• Exigences réduites en matière d'autorisations. New Relic n'a besoin que d'un accès ConfigMap (et non cluster-admin) pour déployer les configurations de pipeline.
• Contrôle direct de la mise à l'échelle et des versions du gateway.

Ce que vous gérez vous-même :

• Mise à l'échelle de l'infrastructure de gateway via l'autoscaler horizontal de pods Kubernetes (HPA)
• Mises à niveau de la version du gateway via les commandes Helm

Considérations relatives à l'utilisation du gateway

Lorsque vous intégrez et utilisez le composant de gateway, gardez ces considérations à 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. Vous aurez peut-être besoin de méthodes alternatives pour structurer les données log à des fins d’interrogation et de visualisation.
• Intégration Prometheus : le gateway ne prend pas en charge l'écriture à distance Prometheus pour les métriques.

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.
• 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 uniquement les permissions CREATE/UPDATE pour ConfigMap (et non cluster-admin).

• 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.

Installer le gateway Contrôle de pipeline

Pour installer le gateway Contrôle de pipeline sans Flux :

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 Configuration only (without Flux).

6. Configurez le gateway :

   • Entrez le nom de votre cluster.
   • Saisissez un espace de nommage pour les installations du gateway et d'Agent Control. La valeur par défaut est newrelic.

7. Installer Agent Control :

   bash

   Copier

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

   Conseil

   L'assistant de l'interface utilisateur fournit le fichier de valeurs complet (agent-control-deployment-values.yaml) avec votre configuration spécifique. Téléchargez ce fichier et utilisez-le avec la commande Helm.

8. Vérifiez l’installation d’Agent Control, puis cliquez sur Continue.

9. Configurer les paramètres du gateway (réplicas minimum, réplicas maximum, seuil de CPU). Ces paramètres créent la configuration HPA Kubernetes initiale. Après l'installation, les modifications apportées à ces paramètres via l'interface utilisateur ne sont pas appliquées. Vous devez gérer directement la mise à l'échelle via HPA.

10. Installer le gateway :

    bash

    Copier

    $
    helm upgrade --install newrelic-pcg newrelic/pipeline-control-gateway -n newrelic --create-namespace --values pipeline-control-gateway-values.yaml

    Conseil

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

11. Cliquez sur Continue.

12. 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.

Gérer le gateway après l'installation

Après l'installation, la page des paramètres du gateway dans l'UI de New Relic affiche :

• Version de gateway - Affichée en lecture seule

• Deux boutons à bascule modifiables :

  • Collecter des logs de diagnostic sur le gateway - activer/désactiver le logging de diagnostic
  • Contourner les règles du gateway si votre CPU disponible devient faible – Activer ou désactiver le contournement des règles en cas de contraintes de ressources

Pour gérer l'infrastructure du gateway (mise à l'échelle et versions), utilisez ces approches :

Modifier les paramètres de mise à l'échelle du gateway

Pour modifier le nombre minimum/maximum de réplicas ou les seuils de CPU, mettez à jour votre HPA Kubernetes :

Option 1 : modifier HPA directement Utilisez cette option pour des tests rapides ou des ajustements temporaires, une réponse immédiate aux problèmes de mise à l'échelle, ou lorsqu'aucune mise à niveau Helm n'est nécessaire.

1. Afficher l'HPA actuel :

   bash

   Copier

   $
   kubectl get hpa -n newrelic

   Cet exemple suppose que l'espace de nommage est newrelic. Si vous utilisez un espace de nommage différent, modifiez-le en conséquence ici et dans les commandes suivantes.

2. Modifier HPA directement :

   bash

   Copier

   $
   kubectl edit hpa pipeline-control-gateway-hpa -n newrelic

   Ici, pipeline-control-gateway-hpa est le HPA que vous modifiez. Remplacez-le par le nom de votre HPA.

   Dans l'éditeur, modifiez les champs dont vous avez besoin, puis enregistrez et quittez. Vos modifications s'appliquent immédiatement.

3. Vérifiez vos modifications :

   bash

   Copier

   $
   kubectl get hpa pipeline-control-gateway-hpa -n newrelic

   Confirmez que vos modifications ont été appliquées en vérifiant que la sortie affiche vos nouvelles valeurs pour les paramètres que vous avez modifiés.

Option 2 : mise à jour via Helm

1. Modifiez votre fichier pipeline-control-gateway-values.yaml .

2. Exécutez :

   bash

   Copier

   $
   helm upgrade newrelic-pcg newrelic/pipeline-control-gateway -n newrelic --values pipeline-control-gateway-values.yaml

3. Vérifiez vos modifications :

   bash

   Copier

   $
   kubectl get hpa -n newrelic

Mettre à niveau la version du gateway

Pour mettre à niveau la version du gateway Contrôle de pipeline :

1. Mettez à jour la version du chart dans votre commande Helm :

   bash

   Copier

   $
   helm upgrade newrelic-pcg newrelic/pipeline-control-gateway --namespace newrelic --version <NEW_VERSION> --values pipeline-control-gateway-values.yaml

2. Vérifiez la mise à niveau :

   bash

   Copier

   $
   helm list -n newrelic
   $
   kubectl get pods -n newrelic

Modifications de configuration du Pipeline

Ceux-ci sont gérés via l'interface utilisateur :

• Règles d'échantillonnage
• Filtres de suppression
• Règles de transformation
• Échantillonnage conditionnel

Les modifications de la configuration du pipeline se déploient automatiquement via les mises à jour de ConfigMap, même dans ce mode.

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 d'installation ci-dessus.
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.