Gestionar la instrumentación existente con Agent Control

Migración de Kubernetes

Si su clúster de Kubernetes ya está instrumentado con New Relic, puede realizar la transición de sus agentes para que sean administrados por Agent Control y utilizar sus funciones de administración. El proceso de migración elimina las instalaciones de agentes existentes y las reemplaza con instalaciones gestionadas por Agent Control, configuradas centralmente a través de Fleet Control.

Paso 1. Recupere su configuración existente

Primero, identifique cuáles de sus agentes existentes pueden ser gestionados por Agente Control.

Agent Control puede desplegar y administrar los siguientes agentes del chart de Helm nri-bundle, asignados a los tipos de agente de Agent Control:

• newrelic-infrastructure, nri-kube-events, kube-state-metrics y nri-kube-events: Administrados como el tipo de agente de New Relic Infrastructure
• newrelic-prometheus-configurator: Administrado como el tipo de agente Prometheus de New Relic
• newrelic-logging: Gestionado como el tipo de agente Fluent Bit
• nr-k8s-otel-collector: Administrado como el tipo de agente New Relic OpenTelemetry Collector

Si instaló el agente usando Helm, recupere su configuración de instalación del clúster ejecutando el siguiente comando:

$
# 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 tiene el archivo de configuración original guardado de la instalación, puede utilizarlo directamente. Si instrumentó el clúster mediante manifiestos de Kubernetes (kubectl o Kustomize), tome nota de las opciones establecidas para cada agente: las recreará como configuraciones remotas de Fleet Control.

Paso 2. Desinstale sus agentes antiguos

Antes de instalar Agent Control, elimine los agentes antiguos de su clúster.

Para una instalación de Helm, use el comando helm uninstall:

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

Por ejemplo, para desinstalar el nri-bundle:

$
$ helm uninstall nri-bundle -n newrelic

Paso 3. Instalar Agent Control

Inicie la instalación guiada de Agent Control y descargue el values.yaml generado. Este archivo contiene solo la configuración del supervisor de Agent Control (credenciales, ID de flota y qué tipos de agentes administrar) — no agregue valores de chart específicos del agente aquí. Esos pertenecen a la configuración remota de Fleet Control.

Para una instalación de Helm, normalmente ejecutarías:

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

Paso 4. Vuelva a crear la configuración de su agente en Fleet Control

Después de que Agent Control esté instalado y conectado a Fleet Control, despliegue sus agentes creando o actualizando la configuración remota de la flota con sus ajustes anteriores. Este es el lugar autorizado para toda la configuración del agente.

Ejemplo: Migración de una instalación de nri-bundle

A continuación, se muestra cómo traducir los valores de Helm existentes de nri-bundle a una configuración remota de Fleet Control.

Configuración nri-bundle existente:

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

Configuración remota equivalente de Fleet Control:

Establezca esto como la configuración remota para su flota en Fleet Control. Agent Control lo aplicará automáticamente.

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"

Migración de Linux

Para migrar de una instalación independiente del Agente de infraestructura en Linux a Agent Control:

1. Tome nota de su configuración existente. Antes de desinstalar, guarde una copia de la configuración de su agente en /etc/newrelic-infra/newrelic-infra.yml y cualquier configuración de integración en el host en /etc/newrelic-infra/integrations.d/. Deberá volver a crearlas como configuraciones remotas de Fleet Control después de instalar Agent Control.

2. Desinstale el Agente de infraestructura existente. Siga los pasos de desinstalación para su distribución:

   Debian, Ubuntu SLES Amazon Linux, CentOS, RHEL

   bash

   Copia

   $
   sudo apt-get remove newrelic-infra -y

   bash

   Copia

   $
   sudo zypper -n remove newrelic-infra

   bash

   Copia

   $
   sudo yum remove newrelic-infra -y

3. Instale Agent Control. Sigue los pasos de instalación de Linux usando la instalación guiada, asegurándote de seleccionar o crear una flota de tipo "Host - Linux".

4. Vuelva a crear la configuración de su agente en Fleet Control. Una vez que Agent Control esté instalado y conectado, despliegue el Agente de infraestructura a través de Fleet Control y aplique su configuración anterior mediante una configuración remota. Consulta Configuración de Linux para obtener orientación sobre el formato de configuración.

Los dashboards personalizados y las alertas que hacen referencia a datos del Agente de infraestructura seguirán funcionando siempre que utilice la misma cuenta y el mismo nombre de host.

Migración de Windows

Para migrar de una instalación independiente del agente de infraestructura en Windows a Agent Control:

1. Desinstala el agente de infraestructura existente. Abra Add or Remove Programs (o use PowerShell) y desinstale el agente de infraestructura de New Relic. Alternativamente, ejecute su desinstalador:

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

   Copia

2. Tome nota de su configuración existente. Antes de desinstalar, guarde una copia de la configuración de su agente (generalmente en C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml) y cualquier configuración de integraciones en el host en C:\Program Files\New Relic\newrelic-infra\integrations.d\. Deberá volver a crearlas como configuraciones remotas de Fleet Control después de instalar Agent Control.

3. Instale Agent Control. Sigue los pasos de instalación de Windows usando la instalación guiada, asegurándote de seleccionar o crear una flota de tipo "Host - Windows".

4. Vuelva a crear la configuración de su agente en Fleet Control. Una vez que Agent Control esté instalado y conectado, despliegue el Infrastructure Agent a través de Fleet Control y aplique su configuración anterior mediante una configuración remota. Consulte Configuración de Windows para obtener orientación sobre el formato de configuración.

Los dashboards personalizados y las alertas que hacen referencia a datos del Agente de infraestructura seguirán funcionando siempre que utilice la misma cuenta y el mismo nombre de host.