El agente de Java New Relic lee su configuración del archivo newrelic.yml . De forma predeterminada, el agente busca este archivo en el directorio que contiene newrelic.jar. Puede anular la ubicación del archivo de configuración estableciendo la propiedad del sistema newrelic.config.file en un nombre de archivo completo.
Podrás configurar nuestro agente de Java para adaptarlo a tu entorno luego de crear una cuenta New Relic (es gratis, para siempre) e instalar el agente de Java.
Estructura del archivo de configuración
El archivo newrelic.yml tiene secciones separadas para diferentes entornos:
- Prueba
- Desarrollo
- De prueba
- Producción (predeterminado)
New Relic aplica la configuración en la sección common a cada uno de estos entornos. Puede seleccionar otros entornos como predeterminados configurando la propiedad del sistema newrelic.environment en el nombre del entorno.
Sugerencia
Hay una plantillanewrelic.yml disponible.
Si edita newrelic.yml, tenga cuidado de ajustarse al formato YAML. Utilice un validador YAML para asegurarse de que la sintaxis sea precisa antes de usar el archivo con el agente de Java de New Relic y siga estas reglas:
Java agent newrelic.yml | Requirements |
|---|---|
Formato | Los archivos YML distinguen entre mayúsculas y minúsculas. |
Sangrías | Todas las sangrías deben realizarse en incrementos de dos caracteres. Otras sangrías generarán un error
|
Cambios en el archivo | Debe reiniciar su proceso de host JVM para que los cambios surtan efecto. Exception: Los cambios de propiedad en |
Prioridad de los ajustes de configuración
Para anular cualquier configuración en el archivo de configuración, utilice una anulación de propiedad del sistema. En ciertos entornos, las variables de entorno también se pueden usar para anular tanto el archivo de configuración como las propiedades del sistema. Las variables de entorno existen principalmente para admitir Heroku. Cuando se utiliza, la configuración del lado del servidor anula todas las demás configuraciones.
Con el agente de Java, la configuración del lado del servidor anula todas las demás configuraciones. Las variables de entorno anulan las propiedades del sistema Java. Las propiedades de Java anulan los ajustes de configuración del usuario en su archivo newrelic.yml . La configuración del usuario anula la configuración predeterminada newrelic.yml .
Configurar el directorio de extensiones de Java
El agente de Java lee los archivos de configuración al iniciar el proceso. Para identificar el directorio donde se encuentran los archivos, cree un directorio de extensiones nuevo o especifique uno existente:
Índice de configuración
Las siguientes páginas contienen la referencia completa de los ajustes para cada área de configuración:
| Página de configuración | Descripción |
|---|---|
| Configuración general | Configuración principal: clave de licencia, nombre de la aplicación, proxy, alta seguridad, extensiones |
| Configuración del rastreador de transacciones | Rastreo de transacciones, captura de SQL, eventos de transacción, segmentos, rastreador de mensajes |
| Ajustes del recolector de errores | Recopilación de errores, clases y códigos de estado ignorados/esperados, Errors Inbox |
| Configuración del rastreo distribuido | Rastreo distribuido, Infinite Tracing, eventos de span, rastreador multiaplicación |
| Configuración de logs en contexto | Reenvío de logs, métricas de logs, decoración local, configuración de logging |
| Configuración de atributos | Filtrado de atributos, listas de inclusión/exclusión, modo de atributo HTTP |
| Configuraciones de seguridad | Agente de seguridad de IAST, configuración de detección de vulnerabilidades |
| Configuración de monitoreo de IA | Monitoreo de IA y registro de contenido de LLM |
| Monitoreo de la configuración del navegador | Instrumentación automática y configuración de atributos del agente del browser |
| Configuración de instrumentación asíncrona | Configuración de token asíncrono y tiempo de espera de segmento |
| Configuración de OpenTelemetry | Configuración de señales de trazas, métricas y logs de OpenTelemetry |
| Configuración de JFR | Generación de perfiles en tiempo real de Java Flight Recorder |
| Configuración del transformador de clases | Nomenclatura de transacciones de Spring, anotaciones de traza, rastreo de Lambda |
| Configuración de JMX | Monitoreo de JMX y metadatos de vinculación |
| Otros ajustes | Interruptor, configuración de cloud, uso, eventos personalizados, recolector de jar, ofuscación de JVM, generador de perfiles de subprocesos y más |
Importante
Los dos ajustes que debe configurar son el nombre de la aplicación y la clave de licencia —que se establecen mediante app_name y license_key en newrelic.yml (o las variables de entorno NEW_RELIC_APP_NAME y NEW_RELIC_LICENSE_KEY). Todas las demás configuraciones son opcionales.