Configurar el agente de infraestructura usando Ansible

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 ayudarle a instalar nuestro agente de monitoreo de infraestructura utilizando el flujo de trabajo y herramientas que son comunes con muchos equipos de operaciones. Este es un rol básico de Ansible y está diseñado para usarse 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 monitoreo 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

Enlace a Galaxy

bash

$ansible-galaxy install newrelic.newrelic_install

Asegúrese de tener ansible.windows y ansible.utils si aún no están instalados:

bash

$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
`targets`	Requerido	Lista de instalaciones de destino para ejecutar en hosts. Las opciones disponibles son: `infrastructure` (Linux y Windows) `logs` (Linux y Windows) `apm-php` (Linux) `apm-nodejs` (Linux) `apm-dotnet` (Linux y Windows) `apm-java` (Linux) `apache` (Linux) `mssql` (Windows) `mysql` (Linux) `nginx` (Linux)
`tags`	Opcional	Valor principales pares de etiquetas pasadas a la instalación.
`install_timeout_seconds`	Opcional	Establece el tiempo de espera para la tarea de instalación. Anula el tiempo de espera predeterminado de 600 segundos.
`verbosity`	Opcional	Las opciones detalladas para la instalación (`debug` o `trace`) escriben la salida detallada en un archivo de registro en el host.

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.

NEW_RELIC_MSSQL_DB_HOSTNAME (opcional) nombre de host o IP donde se está ejecutando el servidor MS SQL. El valor predeterminado es el nombre de host descubierto si no se especifica.
NEW_RELIC_MSSQL_DB_PORT (opcional) Puerto en el que escucha el servidor MS SQL. El valor predeterminado es 1433
NEW_RELIC_MSSQL_DB_USERNAME (opcional) Nombre de usuario para acceder al servidor MS SQL. El valor predeterminado es newrelic. Si utiliza un usuario de dominio, utilice la sintaxis domain\user
NEW_RELIC_MSSQL_DB_PASSWORD (opcional) Contraseña para el usuario de dominio o SQL determinado. Si no se proporciona ninguna contraseña, se generará una contraseña aleatoria.
NEW_RELIC_MSSQL_SQL_USERNAME (opcional) Anulación de credencial opcional pasada a sqlcmd al crear el usuario de SQL especificado por NEW_RELIC_MSSQL_DB_USERNAME. Si se omite, se utilizará el nombre de usuario de inicio de sesión predeterminado.
NEW_RELIC_MSSQL_SQL_PASSWORD (opcional) Anulación de credencial opcional pasada a sqlcmd al crear el usuario de SQL especificado por NEW_RELIC_MSSQL_DB_USERNAME. Si se omite, se utilizará la contraseña de inicio de sesión predeterminada.
NEW_RELIC_MSSQL_ENABLE_BUFFER_METRICS (opcional) Habilitar recopilación de grupo de búferes métrica. El valor predeterminado es verdadero
NEW_RELIC_MSSQL_ENABLE_RESERVE_METRICS (opcional) Habilite la recopilación de espacio de reserva de la partición de la base de datos. El valor predeterminado es verdadero

NEW_RELIC_MYSQL_PORT (opcional) El valor predeterminado es 3306 si no se especifica.
NEW_RELIC_MYSQL_USERNAME (opcional) El valor predeterminado es newrelic si no se especifica ningún otro. Este es el nombre de usuario que la integración mysql configurará y también establecerá en el archivo de configuración de la integración (por ejemplo: mysql-config.yml) para fines de generación de informes de datos. Ver más en IntegraciónMySQL .
NEW_RELIC_MYSQL_PASSWORD (opcional) La contraseña del usuario especificado en NEW_RELIC_MYSQL_USERNAME. Ver más en IntegraciónMySQL .
NEW_RELIC_MYSQL_ROOT_PASSWORD (obligatorio) La integración mysql debe conectarse a mysql para crear las credenciales adecuadas.

Consulte el entorno remoto de ansible para obtener más información.

Nota IMPORTANTE

El objetivo logs requiere infrastructure y se generará un error si se especifica logs sin infrastructure.
La instalación del agente apm-nodejs solo se admite para aplicaciones administradas por PM2. Para instalar el agente utilizando un administrador de paquetes como npm o yarn 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 servicio systemd .
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"

Te ofrecemos esta traducción automática para facilitar la lectura.

Configurar el agente de infraestructura usando Ansible

Importante

Código de muestra

Compatibilidad y requisitos

Configurar New Relic con Ansible

Instalacion

Ansible Galaxy

Manual

Empezando

Variables de configuración de roles

Valores predeterminados

Variables de entorno

APM-php

apache

mssql

mysql

Nota IMPORTANTE

Libro de jugadas de ejemplo adicional

Te ofrecemos esta traducción automática para facilitar la lectura.

Configurar el agente de infraestructura usando Ansible

Importante

Código de muestra .css-21sua1{background:none;border:none;width:0;padding:0;}

Compatibilidad y requisitos

Configurar New Relic con Ansible

Instalacion

Ansible Galaxy

Manual

Empezando

Variables de configuración de roles

Valores predeterminados

Variables de entorno

apache

mssql

mysql

Nota IMPORTANTE

Libro de jugadas de ejemplo adicional

Código de muestra