• 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

Integración en el host: formato de configuración legacy

La integración New Relic Infrastructure en el host puede utilizar uno de dos tipos de formatos de configuración. Este documento explica el formato de configuración legacy más antiguo.

Importante

New Relic recomienda utilizar el nuevo formato de configuración estándar mejorado. Para actualizar su archivo de configuración a este nuevo formato, consulte la sección de actualización

Para obtener una introducción a la configuración, consulte Descripción general de la configuración.

Estructura del archivo de configuración

Una integración en el host que utiliza el formato de configuración estándar requiere dos archivos de configuración:

Archivo de definición

El archivo de definición tiene un formato de nombre como INTEGRATION_NAME-definition.yml. Este archivo proporciona información descriptiva sobre la integración, como por ejemplo: la versión del protocolo JSON que admite, una lista de comandos que puede ejecutar y los argumentos que acepta. Vive en este directorio:

  • Linux:

    /var/db/newrelic-infra/newrelic-integrations
  • Ventanas:

    C:\Program Files\New Relic\newrelic-infra\newrelic-integrations

A continuación se muestra un ejemplo de un archivo de definición de integración NGINX con dos secciones de comando en un sistema Linux:

name: com.myorg.nginx
protocol_version: 2
description: Collect metric and configuration data from NGINX
os: linux
commands:
metrics:
command:
- myorg-nginx
- --metrics
interval: 15
inventory:
command:
- myorg-nginx
- --inventory
interval: 120
prefix: integration/myorg-nginx

Un archivo de definición se puede dividir en dos partes:

Encabezado del archivo de definición

Aquí hay explicaciones de los elementos de encabezado de un archivo de definición:

Campo de encabezado de definición

Descripción

name

Requerido. Un nombre único name para identificar la integración para registro, métrica interna, etc. Cuando el agente carga el archivo de configuración, New Relic usa name para buscar la integración en el registro del agente.

protocol_version

Requerido. El número de versión del protocolo. New Relic utiliza esto para garantizar la compatibilidad entre la integración y el agente. Si el agente no reconoce la versión de una integración, filtrará esa integración y creará un mensaje de registro.

La versión actual del protocolo JSON es 2. Para obtener más información sobre los cambios de protocolo, consulte Cambios en el SDK.

description

Opcional. Explicación amigable para los humanos de lo que hace la integración.

os

Opcional. El sistema operativo donde se ejecuta la integración. New Relic usa esto para filtrar la integración que desea ejecutar solo en un sistema operativo específico.

Predeterminado: ejecute la integración independientemente del valor os .

Para restringir la integración a un sistema operativo específico, utilice cualquiera de estas opciones:

  • linux
  • windows

Comandos de archivos de definición

Después del encabezado hay una lista de comandos. La sección de comandos define:

  • Uno o más modos de funcionamiento independientes para el ejecutable.
  • Los datos de tiempo de ejecución necesarios para que se ejecute.

La sección de comandos es un mapa YAML de definiciones de comandos, donde cada clave es el nombre de alias único del comando en el archivo de configuración de la integración que especifica el ejecutable que se ejecutará.

Comandos de definición

Descripción

command

Requerido. La línea de comando real que se ejecutará como una matriz YAML de partes de comando. Estos se ensamblan para ejecutar el comando real. Para comandos simples, la matriz puede tener un solo elemento.

Las reglas de comando adicionales incluyen:

  • command argumentos: El comando y cualquier argumento de línea de comando que se comparta para todas las instancias de la configuración de integración.

  • command ejecución: el comando se ejecutará en el mismo directorio que el archivo de definición.

  • command ruta: se puede utilizar cualquier comando disponible en el $PATH del host. Los ejecutables ubicados en el mismo directorio que el archivo de definición, o en un subdirectorio del mismo, se pueden ejecutar utilizando una ruta relativa. Por ejemplo:

    • Linux:

      Para ejecutar un ejecutable llamado myorg-nginx en el mismo directorio que el archivo de definición, puede usar myorg-nginx o ./myorg-nginx. Los sistemas Linux ejecutarán myorg-nginx como si el usuario usara ./myorg-nginx.

    • Windows:

      Para ejecutar un ejecutable llamado myorg-nginx.exe en el mismo directorio que el archivo de definición, puede usar \myorg-nginx.exe o .\myorg-nginx.exe. Los sistemas Windows que escriban myorg-nginx.exe se ejecutarán como si indicaran la ruta actual: .\myorg-nginx.exe.

    • Para usar un comando instalado dentro de un directorio en el $PATH del host, simplemente use el nombre del comando. Ejemplo python.

    • Para ejecutar cualquier otro ejecutable que no esté en el $PATH del host ni en el directorio de integración, utilice una ruta absoluta al ejecutable. Ejemplo /opt/jdk/bin/java.

    Si el nombre del ejecutable proporcionado existe dentro del directorio de la integración pero también existe en otra parte del sistema $PATH, la versión en el directorio de la integración tiene prioridad.

interval

Opcional. El número de segundos entre dos ejecuciones consecutivas del comando, en particular entre el final de la ejecución anterior y el inicio de la siguiente ejecución.

  • Valor predeterminado para sondeo métrico: 30 segundos.
  • Mínimo (piso): 15 segundos.
  • Alertas: Si se utiliza métrica para alertas, utilice un intervalo de 30 segundos o menos.

prefix

Opcional. La categorización del inventario en forma de category/short_integration_name. Ejemplo integration/myorg-nginx.

El prefijo no es una ruta específica de la plataforma. La barra diagonal es el separador correcto entre la categoría y short_integration_name.

El prefijo puede tener un máximo de dos niveles. De lo contrario, no se informará el inventario.

Valor predeterminado si no se establece: integration/integration_name.

Archivo de configuración

El archivo de configuración tiene un formato de nombre como INTEGRATION_NAME-config.yml. Este archivo especifica qué ejecutables ejecutar y el parámetro requerido para ejecutarlos. Vive en este directorio:

  • Linux:

    /etc/newrelic-infra/integrations.d/
  • Ventanas:

    C:\Program Files\New Relic\newrelic-infra\integrations.d

A continuación se muestra un ejemplo de un archivo de configuración con una instancia definida. Las explicaciones de estos campos se explican debajo del ejemplo.

integration_name: com.myorg.nginx
instances:
- name: nginx1.myorg.com-metrics
command: metrics
arguments:
status_url: http://127.0.0.1/status
labels:
environment: production
role: load_balancer

Otro ejemplo de un archivo de configuración con dos instancias definidas.

integration_name: com.myorg.nginx
instances:
- name: nginx1.myorg.com-metrics
command: metrics
arguments:
status_url: http://one.url/status
labels:
environment: production
role: load_balancer
- name: nginx2.myorg.com-metrics
command: metrics
arguments:
status_url: http://another.url/status
labels:
environment: production
role: load_balancer

Definiciones de campos del archivo de configuración

Campo de archivo de configuración

Descripción

integration_name

Requerido. Este es el encabezado y se utiliza para identificar qué ejecutables ejecutar. Este nombre debe coincidir exactamente con el nombre especificado en el archivo de definición de la integración.

Recommendation: Para garantizar nombres únicos, utilice notación de nombre de dominio inversa.

name

Requerido. Este es el nombre de la invocación (instancia) específica de la integración. Esto se utiliza para ayudar a identificar cualquier mensaje de registro generado por esta integración y también es útil para la resolución de problemas.

command

Requerido. Este es el comando a ejecutar. Debe coincidir exactamente con uno de los nombres de alias únicos especificados en el archivo de definición de la integración.

arguments

Opcional. Un objeto YAML donde:

  • Claves: el nombre del argumento. Transformado a mayúsculas cuando se establece como variable de entorno.

  • Valores: los valores del argumento. Pasado tal cual.

    Los argumentos están disponibles para una integración como un conjunto de variables de entorno.

    Los argumentos en el archivo de configuración no pueden escribirse en mayúscula y deben usar guiones bajos para separar las palabras.

labels

Opcional. Un objeto YAML donde:

  • Claves: El nombre de la etiqueta.
  • Valores: el valor de etiqueta definido.

integration_user

Opcional. Cadena con el nombre que utilizará el agente para ejecutar el binario de integración.

Predeterminado: depende del usermode. De forma predeterminada, la integración se ejecuta con el mismo usuario que ejecuta el agente de integración, nri-agente para el modo privilegiado y no privilegiado y el usuario raíz para el modo raíz.

Cuando esté presente, el agente de infraestructura ejecutará el binario de integración como el usuario especificado. Por ejemplo, para ejecutar el binario de integración como usuario root cuando se ejecuta el agente en un usermode diferente de root, simplemente agregue integration_user: root al archivo de configuración.

Copyright © 2024 New Relic Inc.

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