Puede utilizar la función Ansible de New Relic para ayudarle a escalar sus esfuerzos de observabilidad New Relic utilizando la CLI New Relic y el repositorio de instalación New Relic Open. Para obtener instrucciones sobre cómo utilizar Ansible, consulte la documentación de Ansible. Este es un esfuerzo apoyado por la comunidad .
¿Quiere configurar el agente de infraestructura usando Ansible? ¡ Crea una cuenta New Relic gratis! No se requiere tarjeta de crédito.
Importante
Esta función siempre instalará la última versión lanzada del agente New Relic y no admite la instalación de versiones anteriores.
Código de muestra
New Relic proporciona un código de muestra de gestión de configuración para ayudarlo a instalar nuestro agente de infraestructura empleando flujo de trabajo y herramientas que son comunes entre muchos equipos de operaciones. Esta es una función básica de Ansible y está pensada para emplear como punto de partida para crear su propio flujo de trabajo personalizado.
La configuración depende de su configuración y estándares específicos. Para ver una función de muestra de Ansible y más información de integración, consulte la documentación de Ansible Galaxy.
Compatibilidad y requisitos
La función de Ansible con el agente de infraestructura de New Relic requiere un sistema operativo compatible.
Si necesita ayuda con Ansible para el sistema operativo Windows, consulte Configuración de un host de Windows, en el sitio de documentación de Ansible .
Esta función se prueba con Ansible Core 2.13 y 2.14 y Python 3.10. Las versiones de Ansible Core anteriores a la 2.10 no son compatibles.
Configurar New Relic con Ansible
Instalacion
Ansible Galaxy
$ansible-galaxy install newrelic.newrelic_install
Asegúrese de tener ansible.windows
y ansible.utils
si aún no están instalados:
$ansible-galaxy collection install ansible.windows ansible.utils
Manual
Si desea utilizar una copia local de la función, clone el repositorio y ejecute make
en la raíz del proyecto para copiar este repositorio en ~/.ansible/roles/newrelic.newrelic_install
, permitiendo que la función se comporte como si estuviera instalada desde Galaxy.
Empezando
Para comenzar a utilizar el rol newrelic.newrelic_install
:
- Incluya el papel en su libro de jugadas.
- Personalice las variables requeridas.
Después de la instalación, incluya el rol newrelic.newrelic_install
en un manual de estrategias nuevo o existente. A continuación se muestra un ejemplo de configuración de su función para instalar el agente de infraestructura:
---- name: Install New Relic hosts: all roles: - role: newrelic.newrelic_install vars: targets: - infrastructure - logs tags: foo: bar environment: NEW_RELIC_API_KEY: <API key> NEW_RELIC_ACCOUNT_ID: <Account ID> NEW_RELIC_REGION: <Region>
Variables de configuración de roles
A continuación se muestran variables disponibles para configurar el rol newrelic.newrelic_install
:
Variable | Se requiere | Descripción |
---|---|---|
| Requerido | Lista de instalaciones de destino para ejecutar en hosts. Las opciones disponibles son:
|
| Opcional | Valor principales pares de etiquetas pasadas a la instalación. |
| Opcional | Establece el tiempo de espera para la tarea de instalación. Anula el tiempo de espera predeterminado de 600 segundos. |
| Opcional | Las opciones detalladas para la instalación ( |
Valores predeterminados
Establecer en defaults/main.yml:
cli_install_url
cli_install_download_location
target_name_map
verbosity_on_log_file_path_linux
verbosity_on_log_file_path_windows
default_install_timeout_seconds
Variables de entorno
Los valores se establecen bajo la palabra clave environment
en su libro de estrategias:
NEW_RELIC_API_KEY
(requerido)NEW_RELIC_ACCOUNT_ID
(requerido)NEW_RELIC_REGION
(opcional: 'EE.UU.' o 'UE', por defecto 'EE.UU.')
Además, puede configurar una variable HTTPS_PROXY
opcional para habilitar un proxy para su instalación.
Consulte el entorno remoto de ansible para obtener más información.
Nota IMPORTANTE
El objetivo
logs
requiereinfrastructure
y se generará un error si se especificalogs
sininfrastructure
.La instalación del agente
apm-nodejs
solo se admite para aplicaciones administradas por PM2. Para instalar el agente utilizando un administrador de paquetes comonpm
oyarn
o mediante otras rutas de instalación, consulte nuestros documentos.La instalación del agente
apm-dotnet
para Windows solo se admite para aplicaciones alojadas en IIS. La instalación de Linux solo es compatible con aplicaciones .NET que se ejecutan como un serviciosystemd
.La instalación del agente
apm-java
admite la ejecución de Java en Tomcat, Wildfly/Jboss y Jetty (independiente).Las siguientes integraciones requieren la instalación del agente de infraestructura:
- APM-java
- apache
- mssql
- mysql
- nginx
Libro de jugadas de ejemplo adicional
- name: Install New Relic hosts: all roles: - role: newrelic.newrelic_install vars: targets: - infrastructure - logs - apm-php tags: foo: bar install_timeout_seconds: 1000 verbosity: debug environment: NEW_RELIC_API_KEY: <API key> NEW_RELIC_ACCOUNT_ID: <Account ID> NEW_RELIC_REGION: <Region> NEW_RELIC_APPLICATION_NAME: "My Application" HTTPS_PROXY: "http://my.proxy:8888"