• /
  • EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

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

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

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 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

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:

  1. Incluya el papel en su libro de jugadas.
  2. 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: &apos;EE.UU.&apos; o &apos;UE&apos;, por defecto &apos;EE.UU.&apos;)

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 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"
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.