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

Configuración del agente Ruby

Puede configurar el agente New Relic Ruby con configuraciones en un archivo de configuración, variables de entorno o mediante programación con configuración del lado del servidor. Este documento resume las opciones de configuración disponibles para el agente Ruby.

Si el valor predeterminado para una opción de configuración es (Dynamic), esto significa que el agente Ruby calcula el valor predeterminado en tiempo de ejecución. El valor de la configuración es el valor predeterminado de otra configuración, según corresponda.

Métodos de configuración y precedencia.

El método principal (predeterminado) para configurar el agente Ruby es a través del archivo de configuración (newrelic.yml) en el subdirectorio config . Para establecer valores de configuración utilizando variables de entorno:

  1. Agregue el prefijo NEW_RELIC_ al nombre de la configuración.
  2. Reemplace los puntos . con guiones bajos _.

También puede configurar algunos valores en la UI mediante la configuración del lado del servidor.

El agente Ruby sigue este orden de precedencia para la configuración:

  1. Variables de entorno
  2. Configuración del lado del servidor
  3. Archivo de configuración (newrelic.yml)
  4. Ajustes de configuración predeterminados

En otras palabras, las variables de entorno anulan todas las demás configuraciones e información de configuración, la configuración del lado del servidor anula el archivo de configuración y las configuraciones predeterminadas, y así sucesivamente.

Ver y editar opciones de archivos de configuración

El newrelic.yml del agente Ruby es un archivo de configuración YAML estándar. Por lo general, incluye una sección Defaults en la parte superior, además de secciones a continuación para cada entorno de aplicación; por ejemplo, Development, Testing y Production.

El agente Ruby determina desde qué sección del archivo de configuración newrelic.yml leer observando ciertas variables de entorno para derivar el entorno de la aplicación. Esto puede ser útil, por ejemplo, cuando desea utilizar info para la configuración log_level en su entorno de producción y desea configuraciones de configuración log_level más detalladas (como debug en su entorno de desarrollo.

A continuación se muestra un archivo de configuración newrelic.yml de ejemplo:

common: &default_settings
license_key: 'YOUR_LICENSE_KEY'
app_name: 'My Application Name'
production:
<<: *default_settings
log_level: info
development:
<<: *default_settings
log_level: debug

Para aplicaciones que no son Rails, el agente Ruby busca las siguientes variables de entorno, en este orden, para determinar el entorno de la aplicación:

  1. NEW_RELIC_ENV
  2. RUBY_ENV
  3. RAILS_ENV
  4. APP_ENV
  5. RACK_ENV

Si el agente Ruby no detecta valores para ninguna de esas variables de entorno, establecerá de forma predeterminada el entorno de la aplicación en development y leerá desde la sección development del archivo de configuración newrelic.yml .

Al ejecutar el agente Ruby en una aplicación Rails, el agente primero busca la variable de entorno NEW_RELIC_ENV para determinar el entorno de la aplicación y qué sección de newrelic.yml usar. Si NEW_RELIC_ENV no está presente, el agente utiliza el entorno Rails (RAILS_ENV o RAILS.env, según la versión de Rails).

Cuando edite el archivo de configuración, asegúrese de:

  • Sangría sólo con dos espacios.

  • Sangra solo cuando sea relevante, en secciones como

    error_collector

    .

Si no aplica la sangría correctamente, el agente puede generar un error Unable to parse configuration file al iniciar.

Para ver la lista más actualizada de opciones de configuración del agente Ruby disponibles, utilice el comando rake newrelic:config:docs . Este documento describe las opciones más comunes.

Actualizar el archivo de configuración

Esta documentación se aplica a la última versión del agente Ruby. Para obtener detalles sobre versiones anteriores, consulte los comentarios en el propio newrelic.yml .

Para actualizar el archivo newrelic.yml después de una nueva versión, utilice la plantilla en el directorio base de la gema del agente. Cuando actualice a nuevas versiones de gemas, examine o diferencie config/newrelic.yml y newrelic.yml en el directorio de instalación para aprovechar las nuevas opciones de configuración.

Importante

La actualización de la gema no actualiza automáticamente config/newrelic.yml.

General

Estas configuraciones están disponibles para la configuración del agente. Algunas configuraciones dependen de su nivel de suscripción a New Relic.

Rastreador de transacciones

La traza de la transacción característica recopila información detallada de una selección de transacciones, incluido un resumen de la secuencia de llamadas, un desglose del tiempo invertido y una lista de consultas SQL y sus planes de consulta (en MySQL y postgresql). La característica disponible depende de su nivel de suscripción a New Relic.

Recolector de errores

El agente recopila e informa todas las excepciones no detectadas de forma predeterminada. Estas opciones de configuración le permiten personalizar la recopilación de errores.

Para obtener información sobre errores ignorados y esperados, consulte esta página sobre Análisis de errores en APM. Para configurar el error esperado mediante el método Ruby NewRelic::Agent.notice_error , consulte la API del agente Ruby.

Monitoreo de IA

Esta sección incluye la configuración del agente Ruby para configurar el monitoreo de IA.

Importante

Debe habilitar rastreo distribuido para capturar datos de traza y retroalimentación. Está activado de forma predeterminada en Ruby agente 8.0.0 y superiores.

Monitoreo del navegador

La característicade tiempo de carga de la página (a veces denominada monitoreo de usuarios reales o RUM) le brinda información valiosa sobre el rendimiento que los usuarios reales están experimentando con su sitio web. Esto se logra midiendo el tiempo que le toma al navegador de su usuario descargar y representar sus páginas web inyectando una pequeña cantidad de código JavaScript en el encabezado y pie de página de cada página.

Evento de transacción

Registro de aplicaciones

El agente Ruby admite el logs en el contexto de APM. Para obtener algunos consejos sobre cómo configurar el registro para el agente Ruby, consulte Configurar el logs en el contexto de Ruby.

Las opciones de configuración disponibles relacionadas con el registro incluyen:

Monitoreo de IA

Esta sección incluye la configuración del agente Ruby para configurar el monitoreo de IA. rastreo distribuido debe estar habilitado para capturar datos de traza y retroalimentación. Está activado de forma predeterminada en Ruby agente 8.0.0 y superiores.

Atributo

Los atributos son pares de valores principales que contienen información que determina las propiedades de un evento o transacción. Estos pares de valores principales se pueden ver dentro de la traza de la transacción en APM, errores de traza en APM, evento de transacción en el tablero y vistas de página en el tablero. Puedes personalizar exactamente qué atributo se enviará a cada uno de estos destinos.

Log de auditoría

Autoencendido

Un nivel de código métrico

Configuración Errors Inbox

Configurar una de las siguientes etiquetas le ayudará a identificar qué versiones de su software están produciendo los errores.

  • NEW_RELIC_METADATA_SERVICE_VERSION creará tags.service.version en los datos del evento que contienen la versión de su código que se desplegará, en muchos casos una versión semántica como 1.2.3, pero no siempre.
  • NEW_RELIC_METADATA_RELEASE_TAG creará tags.releaseTag en los datos del evento que contienen la etiqueta de lanzamiento (como v0.1.209 o release-209).
  • NEW_RELIC_METADATA_COMMIT creará tags.commit on event data containing the commit sha. Se puede utilizar el sha completo o sólo los primeros siete caracteres (por ejemplo, 734713b).

Una próxima versión de Errors Inbox rastreará automáticamente qué versiones de su software están produciendo errores. Todos los datos de la versión también se mostrarán en CodeStream.

Rastreador multiaplicación

Atributo personalizado

Evento personalizado

Almacenamiento de datos rastreador

Deshabilitar

Utilice esta configuración para alternar tipos de instrumentación durante el inicio del agente.

Rastreo distribuido

Elasticsearch

Heroku

Rastreo infinito

Instrumentación

Rastreador de mensajes

Mongo

Anfitrión del proceso

Rastrillo

Normas

Sidekiq

SQL lento

Evento de duración

Eliminar mensajes de excepción

Raya

Hilo generador de perfiles

Utilización

Copyright © 2024 New Relic Inc.

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