Instrumente un sistema limpio
Sugerencia
Agent Control es un servicio supervisor, no recopila ni envía telemetría por sí mismo. Para ver datos en New Relic, debe desplegar agentes (como el agente de infraestructura o NRDOT) a través de control de flota después de instalar Agent Control.
Kubernetes
Cree una flota de tipo clúster de Kubernetes en el control de flota. Consulte Crear su primera flota para obtener pasos detallados.
Instale Agent Control. Siga la guía de instalación de Kubernetes y seleccione la flota que creó en el Paso 1.
Cree la configuración en el control de flota para cada uno de los agentes. Después de que Agent Control se conecte al control de flota, cree la configuración para cada uno de sus agentes. El control de flota es la fuente autorizada para toda la configuración del agente; no agregue valores específicos del agente al
values.yamllocal.
Ejemplo de cómo agregar el agente de infraestructura, Fluent Bit, Prometheus y NRDOT con ajustes personalizados, cada configuración debe crearse como una configuración remota independiente en el control de flota:
Cree un nuevo despliegue agregando las configuraciones remotas recién creadas a su flota. Agent Control aplicará automáticamente la nueva configuración a su clúster. Siga estos pasos en crear y ejecutar su primer despliegue.
Verifique que los datos estén fluyendo. Vaya a Infrastructure > Kubernetes en la UI de New Relic. El clúster debería aparecer en 1-2 minutos después de aplicar la configuración remota. Si no aparece, consulte la resolución de problemas de Agent Control.
Linux
Cree una flota de tipo Linux Host en el control de flota. Consulte Crear su primera flota para obtener pasos detallados.
Instale Agent Control. Siga la guía de instalación de Linux y seleccione la flota que creó en el Paso 1.
Cree la configuración en el control de flota para cada uno de los agentes. Después de que Agent Control se conecte al control de flota, cree la configuración para cada uno de los agentes.
Ejemplo que agrega el agente de infraestructura, nri-MySQL, nri-flex, fluentbit y nrdot, cada una de estas configuraciones debe crearse como una configuración remota independiente en el control de flota:
Cree un nuevo despliegue para agregar la configuración remota recién creada a la flota. El control del agente aplicará automáticamente la nueva configuración al host, descargará e instalará los paquetes de OCI para cada agente. Siga estos pasos en Crear y ejecutar el primer despliegue.
Verifique que los datos estén fluyendo. Vaya a Infrastructure > Hosts en la UI de New Relic. Su host debería aparecer en 1-2 minutos. Si no aparece, consulte la resolución de problemas de Agent Control.
Windows
Cree una flota de tipo Windows Host en el control de flota. Consulte Crear su primera flota para obtener pasos detallados.
Instale Agent Control. Siga la guía de instalación de Windows y seleccione la flota que creó en el paso 1.
Cree la configuración en el control de flota para cada uno de los agentes. Después de que Agent Control se conecte al control de flota, cree la configuración para cada uno de los agentes.
Ejemplo que agrega el agente de infraestructura, nri-MySQL, nri-flex, fluentbit y nrdot, cada una de estas configuraciones debe crearse como una configuración remota independiente en el control de flota:
Cree un nuevo despliegue para agregar la configuración remota recién creada a la flota. El control del agente aplicará automáticamente la nueva configuración al host, descargará e instalará los paquetes de OCI para cada agente. Siga estos pasos en Crear y ejecutar el primer despliegue.
Verifique que los datos estén fluyendo. Vaya a Infrastructure > Hosts en la UI de New Relic. Su host debería aparecer en 1-2 minutos. Si no aparece, consulte la resolución de problemas de Agent Control.
Migrar un sistema previamente instrumentado
Importante
Agent Control no admite la migración automática de agentes existentes. La migración siempre es un proceso manual: desinstale el agente existente, instale Agent Control y, a continuación, vuelva a crear la configuración como una configuración remota de control de flota.
Proceso general de migración
Independientemente de la plataforma, la migración sigue estos cuatro pasos:
- Tome nota de su configuración existente. Guarde una copia de todos los archivos de configuración del agente y las configuraciones de integración antes de desinstalar nada. Las recreará como configuraciones remotas de Fleet Control.
- Desinstale el agente existente. Agent Control no puede coexistir con una instalación de agente independiente del mismo tipo.
- Instale Agent Control y conéctese a una flota. Siga la guía de instalación específica de la plataforma y seleccione una flota existente o cree una nueva.
- Vuelva a crear la configuración en Fleet Control. Cree una configuración remota para la flota con los ajustes anteriores. Agent Control lo aplicará automáticamente.
La configuración remota siempre gana
Fleet Control es la fuente autorizada para la configuración del agente. Cualquier configuración del agente, versiones, valores de charts y límites de recursos, debe definirse en la configuración remota de Fleet Control, no en el archivo de instalación local. Si ambos existen, la configuración remota tiene prioridad y sobrescribirá cualquier valor local.
Mejores practicas
Para garantizar la continuidad de los datos, use el mismo nombre de entidad (nombre de clúster o nombre de host) y la misma cuenta de New Relic durante la instalación de Agent Control. Puede dejar en su lugar cualquier agente o componente que aún no sea compatible con Agent Control hasta que el soporte esté disponible.
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. 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 control de flota.
Agent Control puede desplegar y administrar los siguientes agentes del chart de Helm nri-bundle:
newrelic-infrastructure,nri-kube-eventsykube-state-metrics: administrados como el tipo agente de infraestructuranewrelic-prometheus-configurator: administrado como el tipo de agente Prometheusnewrelic-logging: gestionado como el tipo de agente Fluent Bitnr-k8s-otel-collector: administrado como el tipo de agente OpenTelemetry Collector
- Recupere su configuración existente. Si instaló agentes usando Helm, recupere la configuración de instalación del clúster:
$# Find releases in the namespace$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, utilícelo 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.
- Desinstale sus agentes antiguos. Antes de instalar Agent Control, elimine los agentes antiguos de su clúster. Para una instalación de Helm:
$helm uninstall <release-name> -n <namespace>Por ejemplo, para desinstalar el nri-bundle:
$helm uninstall nri-bundle -n newrelic- Instale Agent Control. Inicie la instalación guiada de Agent Control y descargue el
values.yamlgenerado. 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 control de flota.
$helm upgrade --install agent-control-bootstrap -n newrelic newrelic/agent-control-bootstrap --create-namespace --values my_values.yamlVuelva a crear la configuración de su agente en Fleet Control. Después de que Agent Control se conecte a Fleet Control, cree la configuración para cada uno de los agentes antiguos con los ajustes anteriores.
Cree un nuevo despliegue agregando las configuraciones remotas recién creadas a su flota. Agent Control aplicará automáticamente la nueva configuración a su clúster. Siga estos pasos en crear y ejecutar su primer despliegue.
Verifique que los datos estén fluyendo. Vaya a Infrastructure > Kubernetes en la UI de New Relic. El clúster debería aparecer en 1-2 minutos después de aplicar la configuración remota. Si no aparece, consulte la resolución de problemas de Agent Control.
Linux
Importante
Agent Control no admite la migración automática de agentes existentes en Linux. Si ya tiene el New Relic Infrastructure Agent instalado en su host Linux, debe desinstalarlo manualmente antes de instalar Agent Control. Agent Control distribuye agentes mediante paquetes compatibles con OCI a través de Fleet Control — no reemplaza ni hereda la instalación existente del paquete newrelic-infra.
- Tome nota de su configuración existente
Antes de desinstalar, guarde una copia de:
- Configuración del agente:
/etc/newrelic-infra/newrelic-infra.yml - Cualquier configuración de integración en el host:
/etc/newrelic-infra/integrations.d/
Volverá a crearlas como configuraciones remotas de control de flota en el paso 4.
- Desinstale el agente de infraestructura existente
$sudo apt-get remove newrelic-infra -y$sudo zypper -n remove newrelic-infra$sudo yum remove newrelic-infra -yInstale Agent Control. Siga la guía de instalación de Linux. Asegúrese de seleccionar o crear una flota de tipo Host - Linux.
Vuelva a crear la configuración de su agente en Fleet Control. Después de que Agent Control se conecte al control de flota, cree la configuración para cada uno de los agentes antiguos con los ajustes anteriores. Utilice los archivos de configuración guardados del Paso 1 como referencia.
Cree un nuevo despliegue para agregar la configuración remota recién creada a la flota. El control del agente aplicará automáticamente la nueva configuración al host, descargará e instalará los paquetes de OCI para cada agente. Siga estos pasos en Crear y ejecutar el primer despliegue.
Verifique que los datos estén fluyendo. Vaya a Infrastructure > Hosts en la UI de New Relic. Su host debería aparecer en 1-2 minutos. Si no aparece, consulte la resolución de problemas de Agent Control.
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.
Windows
Importante
Agent Control no admite la migración automática de agentes existentes en Windows. Si ya tiene instalado el agente de infraestructura de New Relic en su host de Windows, debe desinstalarlo manualmente antes de instalar Agent Control. Los agentes de APM no son administrados por Agent Control y pueden permanecer instalados.
- Tome nota de su configuración existente
Antes de desinstalar, guarde una copia de:
- Configuración del agente:
C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml - Cualquier configuración de integración en el host:
C:\Program Files\New Relic\newrelic-infra\integrations.d\
Volverá a crearlas como configuraciones remotas de control de flota en el paso 4.
- Desinstale el agente de infraestructura existente
Abra Add or Remove Programs y desinstale el agente de infraestructura de New Relic. Alternativamente, use el desinstalador MSI desde PowerShell:
# Replace {PRODUCT_CODE} with the GUID from Add/Remove Programsmsiexec /x {PRODUCT_CODE} /quietInstale Agent Control. Siga la guía de instalación de Windows. Asegúrese de seleccionar o crear una flota de tipo Host - Windows.
Vuelva a crear la configuración de su agente en Fleet Control. Después de que Agent Control se conecte al control de flota, cree la configuración para cada uno de los agentes antiguos con los ajustes anteriores. Utilice los archivos de configuración guardados del Paso 1 como referencia.
Cree un nuevo despliegue para agregar la configuración remota recién creada a la flota. El control del agente aplicará automáticamente la nueva configuración al host, descargará e instalará los paquetes de OCI para cada agente. Siga estos pasos en Crear y ejecutar el primer despliegue.
Verifique que los datos estén fluyendo. Vaya a Infrastructure > Hosts en la UI de New Relic. Su host debería aparecer en 1-2 minutos. Si no aparece, consulte la resolución de problemas de Agent Control.
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.