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

• Kubernetes permissions: This installation mode requires cluster-admin permissions for Flux controllers to manage gateway lifecycle (installation, upgrades, scaling).

• Required tools:

  • Helm v3.x or higher (verify with helm version)
  • kubectl CLI with access to your Kubernetes cluster

• New Relic infrastructure agent (optional): Pipeline Control gateway no longer bundles the New Relic infrastructure agent. To view cluster health metrics (CPU usage, memory, and region) in the gateway health dashboard, install the infrastructure agent separately. Refer to Install the Kubernetes integration for installation instructions.

What happens without infrastructure agent:

• Gateway health table will show "N/A" for: CPU usage, memory usage, and region.
• Pipeline configuration and data processing continues to work normally.

Mettre en place le gateway Contrôle de pipeline

To set up 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. Select Full management (with Flux).

6. Configure the gateway:

   • Enter your cluster name.
   • Enter the dedicated Kubernetes namespace where the core gateway infrastructure and manager services will reside. Default is newrelic-agent-control.
   • Enter the specific namespace where individual collection agents will run. Default is 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

   The UI wizard provides the complete value file, values-newrelic-gateway.yaml, with your specific configuration. Download the file and use it with the Helm command.

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 ?

Imagine a corporation (The Corp) has two divisions: OrgA (needs 100% of data for audit reasons) and OrgB (needs 1% sampling to control high-volume costs).

With only one fleet, The Corp is stuck. If OrgB applies 1% sampling to save money, OrgA loses 99% of its performance data. One team's cost-control breaks the other team's mission-critical monitoring.

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.
• High-volume fleet: OrgB joins this fleet for 1% sampling and personal data redaction.

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.