Gérez l'instrumentation existante avec Agent Control

Migration Kubernetes

Si votre cluster Kubernetes est déjà instrumenté avec New Relic, vous pouvez passer vos agents sous la gestion d'Agent Control pour utiliser ses fonctionnalités de gestion. Le processus de migration supprime les installations d'agents existantes et les remplace par des installations gérées par Agent Control, configurées de manière centralisée via Fleet Control.

Étape 1. Récupérer votre configuration existante

Tout d’abord, identifiez lesquels de vos agents existants peuvent être gérés par Agent Control.

Agent Control peut déployer et gérer les agents suivants à partir du chart Helm nri-bundle, mappés aux types d'agents Agent Control :

• newrelic-infrastructure, nri-kube-events, kube-state-metrics et nri-kube-events: Gérés comme le type d'agent New Relic Infrastructure
• newrelic-prometheus-configurator: Géré en tant que type d'agent Prometheus New Relic
• newrelic-logging: Géré en tant que type d'agent Fluent Bit
• nr-k8s-otel-collector: Géré en tant que type d'agent New Relic OpenTelemetry Collector

Si vous avez installé des agents à l’aide de Helm, récupérez votre configuration d’installation à partir du cluster en exécutant la commande suivante :

$
# Find releases in a namespace (adjust as needed)
$
helm list --namespace <namespace-name>
$

$
# Get the values for a specific release
$
$ helm get values <release-name> --namespace <namespace-name>

Si vous disposez du fichier de configuration d'origine sauvegardé lors de l'installation, vous pouvez l'utiliser directement. Si vous avez instrumenté le cluster via des manifestes Kubernetes (kubectl ou Kustomize), notez les options définies pour chaque agent : vous les recréerez sous forme de configurations à distance Fleet Control.

Étape 2. Désinstallez vos anciens agents

Avant d'installer Agent Control, supprimez les anciens agents de votre cluster.

Pour une installation Helm, utilisez la commande helm uninstall :

$
$ helm uninstall <release-name> -n <namespace>

Par exemple, pour désinstaller le nri-bundle:

$
$ helm uninstall nri-bundle -n newrelic

Étape 3. Installer Agent Control

Lancez l'installation guidée d'Agent Control et téléchargez le values.yaml généré. Ce fichier contient uniquement la configuration du superviseur Agent Control (identifiants, ID de flotte et types d'agents à gérer) — n'ajoutez pas de valeurs de chart spécifiques à l'agent ici. Ceux-ci appartiennent à la configuration à distance de Fleet Control.

Pour une installation Helm, vous exécuterez généralement :

$
$ helm upgrade --install agent-control-bootstrap -n newrelic newrelic/agent-control-bootstrap --create-namespace --values my_values.yaml

Étape 4. Recréez la configuration de votre agent dans Fleet Control

Une fois Agent Control installé et connecté à Fleet Control, déployez vos agents en créant ou en mettant à jour la configuration à distance de la flotte avec vos paramètres précédents. Il s'agit de l'emplacement de référence pour toute la configuration de l'agent.

Exemple : Migration d'une installation nri-bundle

Ce qui suit montre comment traduire les valeurs Helm nri-bundle existantes en une configuration à distance Fleet Control.

configuration nri-bundle existante :

global:
  cluster: test-migration
  licenseKey: ***
kube-state-metrics:
  enabled: false
newrelic-prometheus-agent:
  enabled: true
newrelic-infrastructure:
  enabled: true
  kubelet:
    tolerations:
      - operator: "Exists"
        effect: "NoSchedule"
      - operator: "Exists"
        effect: "NoExecute"
      - operator: "Exists"
        key: "MyToleration"
  ksm:
    enabled: false
  common:
    config:
      interval: 29s
newrelic-logging:
  enabled: true
  image:
    tag: "latest"
  resources:
    limits:
      cpu: 200m
    requests:
      cpu: 200m
nri-kube-events:
  enabled: true
  customAttributes:
    test_tag_label: test_tag_value

Configuration à distance Fleet Control équivalente :

Définissez ceci comme la configuration à distance de votre flotte dans Fleet Control. Agent Control l'appliquera automatiquement.

logs:
  chart_version: "1.25.1"
  chart_values:
    newrelic-logging:
      image:
        tag: "latest"
      resources:
        limits:
          cpu: 200m
        requests:
          cpu: 200m
infrastructure:
  chart_version: "5.0.109"
  chart_values:
    newrelic-infrastructure:
      kubelet:
        tolerations:
          - operator: "Exists"
            effect: "NoSchedule"
          - operator: "Exists"
            effect: "NoExecute"
          - operator: "Exists"
            key: "MyToleration"
      ksm:
        enabled: false
      common:
        config:
          interval: 29s
    nri-kube-events:
      customAttributes:
        test_tag_label: test_tag_value
prometheus:
  chart_version: "1.15.4"

Migration Linux

Pour migrer d'une installation autonome de l'Agent d'infrastructure sous Linux vers Agent Control :

1. Notez votre configuration existante. Avant de désinstaller, sauvegardez une copie de la configuration de votre agent à l'emplacement /etc/newrelic-infra/newrelic-infra.yml et de toutes les configurations d'intégration sur l'hôte dans /etc/newrelic-infra/integrations.d/. Vous devrez les recréer en tant que configurations à distance Fleet Control après avoir installé Agent Control.

2. Désinstallez l'agent d'infrastructure existant. Suivez les étapes de désinstallation pour votre distribution :

   Debian, Ubuntu SLES Amazon Linux, CentOS, RHEL

   bash

   Copier

   $
   sudo apt-get remove newrelic-infra -y

   bash

   Copier

   $
   sudo zypper -n remove newrelic-infra

   bash

   Copier

   $
   sudo yum remove newrelic-infra -y

3. Installer Agent Control. Suivez les étapes d'installation Linux à l'aide de l'installation guidée, en veillant à sélectionner ou créer une flotte de type "Host - Linux".

4. Recréez la configuration de votre agent dans Fleet Control. Une fois Agent Control installé et connecté, déployez l'Agent d'infrastructure via Fleet Control et appliquez vos paramètres précédents via une configuration à distance. Consultez Configuration Linux pour obtenir des conseils sur le format de configuration.

Les dashboards personnalisés et les alertes faisant référence aux données de l'agent d'infrastructure continueront de fonctionner tant que vous utilisez le même compte et le même nom d'hôte.

Migration Windows

Pour migrer d'une installation autonome de l'Agent d'infrastructure sous Windows vers Agent Control :

1. Désinstallez l'agent d'infrastructure existant. Ouvrez Add or Remove Programs (ou utilisez PowerShell) et désinstallez l'agent d'infrastructure New Relic. Sinon, exécutez son désinstalleur :

   # Example using the MSI uninstaller
   msiexec /x {PRODUCT_CODE} /quiet

   Copier

2. Notez votre configuration existante. Avant de désinstaller, sauvegardez une copie de la configuration de votre agent (généralement dans C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml) et de toutes les configurations d'intégration sur l'hôte dans C:\Program Files\New Relic\newrelic-infra\integrations.d\. Vous devrez les recréer en tant que configurations à distance Fleet Control après avoir installé Agent Control.

3. Installer Agent Control. Suivez les étapes d'installation Windows à l'aide de l'installation guidée, en veillant à sélectionner ou créer une flotte de type "Host - Windows".

4. Recréez la configuration de votre agent dans Fleet Control. Une fois Agent Control installé et connecté, déployez l'Agent d'infrastructure via Fleet Control et appliquez vos paramètres précédents via une configuration à distance. Consultez Configuration Windows pour obtenir des conseils sur le format de configuration.

Les dashboards personnalisés et les alertes faisant référence aux données de l'agent d'infrastructure continueront de fonctionner tant que vous utilisez le même compte et le même nom d'hôte.