Rol de Ansible para el agente de infraestructura de New Relic

Este rol instala y configura el agente de infraestructura de New Relic.

Ten en cuenta que este es un rol simple y está destinado a ser un punto de partida para tu propio flujo de trabajo personalizado.

Instalación y uso del rol de Ansible

Lo que afecta newrelic-infra

• Agrega la fuente del repositorio de paquetes de New Relic.
• Instala y configura el agente de infraestructura de New Relic.

Comenzando con el rol

Empieza incluyendo el rol en tu playbook y personaliza las variables necesarias.

Todas las interacciones típicas con newrelic-infra se realizan a través de la configuración del rol.

Instala el agente de infraestructura usando el rol

Usa el siguiente fragmento para instalar el agente.

---
- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_config:
          license_key: TU_CLAVE_DE_LICENCIA
          log_file: /var/log/nr-infra.log
          log_to_stdout: false

Referencia

Configuración del rol

Variables

nrinfragent_config (Requerido)

Se utiliza para completar la configuración del agente. Como mínimo, debes proporcionar license_key. Para las opciones de configuración actuales, consulta la documentación de New Relic.

nrinfragent_state (Opcional)

Describe lo que quieres hacer con el agente:

• 'latest' - [predeterminado] instala la versión más reciente del agente. También present.
• 'absent' - Desinstalar el agente.

nrinfragent_os_name (Opcional)

Especifica el sistema operativo en el que se instalará el agente de infraestructura. Por defecto es ansible_os_family. Para una lista de sistemas operativos compatibles, consulta el archivo meta/main.yml.

nrinfragent_os_version (Opcional)

Especifica la versión del sistema operativo del paquete instalador necesario para esta máquina. Por defecto es ansible_lsb.major_release. Se utiliza principalmente para sistemas operativos de la familia RedHat. Para una lista de sistemas operativos compatibles, consulta el archivo meta/main.yml.

nrinfragent_os_codename (Opcional)

Especifica el nombre en clave del sistema operativo del paquete instalador necesario para esta máquina. Por defecto es ansible_lsb.codename. Se utiliza principalmente para sistemas operativos de la familia Debian. Para una lista de sistemas operativos compatibles, consulta el archivo meta/main.yml.

nrinfragent_choco_version (Opcional)

Especifica la versión del paquete Chocolatey para instalar newrelic-infra en Windows. Se puede usar para fijar la versión o actualizar el agente.

nrinfragent_service_state (Opcional)

Especifica el estado del servicio newrelic-infra después de la instalación. Por defecto es started, lo que garantiza que el servicio estará en ejecución. Puedes cambiarlo a stopped para solo instalarlo, sin iniciarlo de inmediato.

nrinfragent_service_enabled (Opcional)

Especifica si el servicio se iniciará durante el arranque. Por defecto es yes; cámbialo a no para evitar que el servicio se inicie automáticamente al arrancar.

nrinfragent_integrations (Opcional)

Especifica las integraciones de infraestructura que se instalarán. La lista de integraciones disponibles se puede encontrar aquí.

Cada paquete debería proporcionar su name y state. El nombre del paquete de integraciones se encuentra en la sección Instalar y activar de la documentación de integraciones individuales. Como convención, su nombre es el nombre del servicio con el prefijo nri- (nri-apache, nri-redis, etc.).

Por defecto, el estado es absent, que no instala el paquete; puedes cambiarlo a latest o present. Por ejemplo:

nrinfragent_integrations:
  - { name: nri-nginx, state: "latest" }
  - { name: nri-mysql, state: "absent" }

El código fuente para cada integración está disponible en la organización de GitHub de newrelic.

Eliminación del paquete newrelic-infra-integrations y sus integraciones incluidas

Esto solo se aplica si tienes instalado el paquete newrelic-infra-integrations

Si deseas eliminar el paquete newrelic-infra-integrations o alguna de las integraciones incluidas (nri-redis, nri-cassandra, nri-apache, nri-nginx, nri-mysql), añade newrelic-infra-integrations como el primer elemento de nrinfragent_integrations con el estado absent.

nrinfragent_integrations:
  - { name: newrelic-infra-integrations, state: "absent" }

Obsoleto

Puedes especificar la clave de licencia para compatibilidad hacia atrás. Recomendamos usar license_key en nrinfragent_config en su lugar. Si ambos están especificados, el de nrinfragent_config tiene prioridad.

Compatibilidad

Plataformas

• RHEL/CentOS
  • RHEL/CentOS 8
  • RHEL/CentOS 7
  • RHEL/CentOS 6
  • RHEL/CentOS 5
• Ubuntu
  • 18 Bionic
  • 16 Xenial
  • 14 Trusty
  • 12 Precise
• Debian
  • 10 Buster
  • 9 Stretch
  • 8 Jessie
  • 7 Wheezy
• SUSE Linux Enterprise
  • 12
• Windows
  • Todos
  • Descargo de responsabilidad: El soporte de Windows depende del paquete de terceros de Chocolatey newrelic-infra, que es mantenido por @ripclawffb y @xandrellas. Se distribuye sin ninguna garantía ni soporte de New Relic.

Lanzamiento en Ansible Galaxy

Para lanzar una nueva versión en Ansible Galaxy, sigue estos pasos:

• Actualiza el CHANGELOG.md
• Crea una nueva versión en GitHub.
• Asegúrate de que la versión esté importada en Ansible Galaxy; si hay algún problema, pregunta a uno de los propietarios del proyecto.

Soporte

Si necesitas asistencia con los productos de New Relic, estás en buenas manos con varias herramientas de diagnóstico y canales de soporte.

Si el problema ha sido confirmado como un error o es una solicitud de función, presenta un problema en GitHub.

Canales de soporte

• Documentación de New Relic: Guía completa para usar nuestra plataforma
• Comunidad de New Relic: El mejor lugar para resolver preguntas de problemas
• Desarrollador de New Relic: Recursos para construir aplicaciones personalizadas de observabilidad
• Universidad de New Relic: Una variedad de capacitación en línea para usuarios de New Relic de todos los niveles
• Soporte Técnico de New Relic Soporte técnico 24/7/365 con tickets. Lee más sobre nuestras Ofertas de Soporte Técnico.

Privacidad

En New Relic, tomamos en serio tu privacidad y la seguridad de tu información, y estamos comprometidos a proteger tus datos. Debemos enfatizar la importancia de no compartir datos personales en foros públicos, y pedimos a todos los usuarios que eliminen información confidencial de los registros y la información de diagnóstico, ya sea personal, propietaria u otra.

Definimos "Datos Personales" como cualquier información relacionada con una persona identificada o identificable, incluyendo, por ejemplo, tu nombre, número de teléfono, código postal, ID de dispositivo, dirección IP y dirección de correo electrónico.

Para más información, consulta el Aviso de Privacidad General de New Relic.

Contribuir

¡Te animamos a contribuir para mejorar este proyecto! Ten en cuenta que cuando envíes tu solicitud de extracción, deberás firmar el CLA a través del clic mediante CLA-Assistant. Solo tienes que firmar el CLA una vez por proyecto.

Si tienes alguna pregunta, o para ejecutar nuestro CLA corporativo (que se requiere si tu contribución es en nombre de una empresa), envíanos un correo a opensource@newrelic.com.

Una nota sobre vulnerabilidades

Como se menciona en nuestra política de seguridad, New Relic se compromete a la privacidad y seguridad de nuestros clientes y sus datos. Creemos que proporcionar divulgación coordinada por parte de investigadores de seguridad y colaborar con la comunidad de seguridad son medios importantes para lograr nuestros objetivos de seguridad.

Si crees que has encontrado una vulnerabilidad de seguridad en este proyecto o en cualquiera de los productos o sitios web de New Relic, te invitamos y agradecemos que lo informes a New Relic a través de HackerOne.

Si deseas contribuir a este proyecto, revisa estas pautas.

¡A todos los colaboradores, les agradecemos! Sin tu contribución, este proyecto no sería lo que es hoy.

Licencia

infrastructure-agent-ansible está licenciado bajo la Licencia Apache 2.0.