• /
  • EnglishEspañolFrançais日本語한국어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

Variables de entorno para AWS Lambda

|View as Markdown (English)

Las variables de entorno son una forma de almacenar configuraciones y secretos fuera de su código. Las siguientes tablas muestran las variables obligatorias y las variables específicas de tiempo de ejecución que puede configurar para monitorear su función Lambda con New Relic.

Variables de entorno obligatorias

Independientemente de su entorno de ejecución, debe configurar las siguientes variables de entorno para monitorear su función Lambda con New Relic:

Variable ambiental

Descripción

NEW_RELIC_ACCOUNT_ID

Especifica el ID de tu cuenta de New Relic

NEW_RELIC_LAMBDA_HANDLER

Especifica el envoltorio del manejador utilizado para encontrar el manejador real de tu función. Para los tiempos de ejecución de Go, esta variable no es requerida.

NEW_RELIC_LICENSE_KEY

Especifica su clave de ingesta de New Relic, anulando Secrets Manager

NEW_RELIC_APM_LAMBDA_MODE

Establezca en true para habilitar el monitoreo APM para su función Lambda

NEW_RELIC_TRUSTED_ACCOUNT_KEY

Especifica el ID de tu cuenta de New Relic o el ID principal, si existe

Variables de entorno adicionales

En función de su entorno de ejecución, puede configurar las siguientes variables de entorno para configurar aún más el monitoreo Lambda de New Relic:

Variable ambiental

Valor por defecto

Opciones

Descripción

NEW_RELIC_USE_ESM

false

true, false

OBSOLETO : Esto se eliminará de las futuras versiones de la capa lambda de Node.js. En su lugar, configure su controlador en /opt/nodejs/node_modules/newrelic-esm-lambda-wrapper/index.handler

NODE_OPTIONS

--experimental-loader newrelic/esm-loader.mjs

Obligatorio: si ESM está habilitado, configure esta variable de entorno para usar nuestro cargador ESM

NEW_RELIC_AI_MONITORING_ENABLED

false

true, false

Obligatorio para la transmisión de respuestas: configúrelo true en para habilitar el monitoreo de respuestas New Relic UI de IA en .

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

true, false

Generar traza habilitando rastreo distribución

NEW_RELIC_NO_CONFIG_FILE

false

true, false

Emplee variables de entorno en Lambda configurando esto en true

NEW_RELIC_APP_NAME

Establece el nombre de la aplicación utilizado como nombre de la entidad de APM en la UI de New Relic cuando NEW_RELIC_APM_LAMBDA_MODE es true. Consulte NEW_RELIC_APP_NAME para funciones Lambda en modo APM para obtener detalles sobre la agrupación de entidades, los informes de múltiples regiones, el comportamiento entre entornos de ejecución y la nomenclatura compartida con servicios que no son de Lambda.

NEW_RELIC_LOG_ENABLED

false

true, false

Habilite el logging del agente configurando esto en true

NEW_RELIC_LOG_LEVEL

info

fatal, error, warn, info, debug, trace

Establecer el nivel de log del agente

NEW_RELIC_LOG

stdout

stdout

Establezca la ruta del log del agente en stdout para el modo sin servidor

NEW_RELIC_NATIVE_METRICS_ENABLED

true

true, false

Deshabilite la reducción de la duración del inicio en frío estableciendo esto en false, aunque no recopilará métricas de VM

Puede encontrar más variables de entorno en nuestra documentación de configuración de Node.js.

Variable ambiental

Valor por defecto

Opciones

Descripción

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

true, false

Generar traza habilitando rastreo distribución

NEW_RELIC_NO_CONFIG_FILE

false

true, false

Emplee variables de entorno en Lambda configurando esto en true

NEW_RELIC_APP_NAME

Establece el nombre de la aplicación utilizado como nombre de la entidad de APM en la UI de New Relic cuando NEW_RELIC_APM_LAMBDA_MODE es true. Consulte NEW_RELIC_APP_NAME para funciones Lambda en modo APM para obtener detalles sobre la agrupación de entidades, los informes de múltiples regiones, el comportamiento entre entornos de ejecución y la nomenclatura compartida con servicios que no son de Lambda.

NEW_RELIC_LOG

stderr

stderr

Establezca la ruta del log del agente en stderr para el modo sin servidor

NEW_RELIC_LOG_LEVEL

info

critical, error, warning, info, debug

Establecer el nivel de log del agente

NEW_RELIC_SERVERLESS_MODE_ENABLED

false

true, false

Habilite el modo sin servidor configurando esto en true

NEW_RELIC_PACKAGE_REPORTING_ENABLED

true

true, false

Mejore los tiempos de arranque en frío configurando esto en false

Puede encontrar más variables de entorno en nuestra documentación de configuración de Python.

Importante

La nueva capa del agente de Java requiere Java 17 o posterior. Esta es una solución independiente de la solución de Java legacy. Si está utilizando el monitoreo sin servidor para su aplicación antes del 10 de abril de 2026 o está en Java 8 u 11, por favor continúe usando la solución legacy que se basa en Open Tracing.

Variable ambiental

Valor por defecto

Opciones

Descripción

AWS_LAMBDA_EXEC_WRAPPER

/opt/newrelic-java-handler

Requerido: Debe establecerse en /opt/newrelic-java-handler al usar la capa del agente de Java de New Relic. Esto apunta AWS Lambda al script contenedor del agente empaquetado en la capa.

NEW_RELIC_SERVERLESS_MODE_ENABLED

true (preconfigurado en la capa)

true, false

Habilita el modo serverless. Detectado automáticamente cuando AWS_LAMBDA_FUNCTION_NAME está presente. Preconfigurado para true en la capa.

NEW_RELIC_LOG_FILE_PATH

/tmp/logs/ (preconfigurado en la capa)

/tmp/logs/

Por defecto, configura el archivo de log del agente de Java para que esté en la ruta absoluta /tmp/logs/newrelic_agent.log

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

true, false

Generar traza habilitando rastreo distribución

NEW_RELIC_PRIMARY_APPLICATION_ID

Establezca su ID de cuenta de New Relic

NEW_RELIC_DEBUG

false

true, false

Habilite el logging de depuración estableciendo esto en true

NEW_RELIC_APP_NAME

Establece el nombre de la aplicación utilizado como nombre de la entidad de APM en la UI de New Relic cuando NEW_RELIC_APM_LAMBDA_MODE es true. Consulte NEW_RELIC_APP_NAME para funciones Lambda en modo APM para obtener detalles sobre la agrupación de entidades, los informes de múltiples regiones, el comportamiento entre entornos de ejecución y la nomenclatura compartida con servicios que no son de Lambda.

Puede encontrar más variables de entorno en nuestra documentación de configuración del agente de Java y en el monitoreo sin servidor de Java.

Variable ambiental

Valor por defecto

Opciones

Descripción

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

true, false

Generar traza habilitando rastreo distribución

NEW_RELIC_APP_NAME

Establece el nombre de la aplicación utilizado como nombre de la entidad de APM en la UI de New Relic cuando NEW_RELIC_APM_LAMBDA_MODE es true. Consulte NEW_RELIC_APP_NAME para funciones Lambda en modo APM para obtener detalles sobre la agrupación de entidades, los informes de múltiples regiones, el comportamiento entre entornos de ejecución y la nomenclatura compartida con servicios que no son de Lambda.

NEW_RELIC_LOG

stdout

stdout

Establezca la ruta del log del agente en stdout para el modo sin servidor

NEW_RELIC_LOG_LEVEL

debug para depurar, o vacío para información

Establecer el nivel de log del agente

Variable ambiental

Valor por defecto

Opciones

Descripción

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

true, false

Generar traza habilitando rastreo distribución

NEW_RELIC_APP_NAME

Establece el nombre de la aplicación utilizado como nombre de la entidad de APM en la UI de New Relic cuando NEW_RELIC_APM_LAMBDA_MODE es true. Consulte NEW_RELIC_APP_NAME para funciones Lambda en modo APM para obtener detalles sobre la agrupación de entidades, los informes de múltiples regiones, el comportamiento entre entornos de ejecución y la nomenclatura compartida con servicios que no son de Lambda.

Variable ambiental

Valor por defecto

Opciones

Descripción

CORECLR_ENABLE_PROFILING

0

0, 1

Obligatorio: habilite la creación de perfiles configurando esto en 1

CORECLR_PROFILER

{36032161-FFC0-4B61-B559-F6C5D41BAE5A}

Obligatorio: Establezca esto en {36032161-FFC0-4B61-B559-F6C5D41BAE5A} para habilitar el agente .NET

CORECLR_NEWRELIC_HOME

/opt/lib/newrelic-dotnet-agent

Obligatorio: Establezca esto en /opt/lib/newrelic-dotnet-agent para habilitar el agente .NET

CORECLR_PROFILER_PATH

/opt/lib/newrelic-dotnet-agent/libNewRelicProfiler.so

Obligatorio: Establezca esto en /opt/lib/newrelic-dotnet-agent/libNewRelicProfiler.so para habilitar el agente .NET

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

true, false

Generar traza habilitando rastreo distribución

NEW_RELIC_APP_NAME

Establece el nombre de la aplicación utilizado como nombre de la entidad de APM en la UI de New Relic cuando NEW_RELIC_APM_LAMBDA_MODE es true. Consulte NEW_RELIC_APP_NAME para funciones Lambda en modo APM para obtener detalles sobre la agrupación de entidades, los informes de múltiples regiones, el comportamiento entre entornos de ejecución y la nomenclatura compartida con servicios que no son de Lambda.

NEW_RELIC_LOG_ENABLED

1

1, 0

Deshabilite el logging del agente configurando esto en 0

NEW_RELIC_LOG_CONSOLE

0

1, 0

Establezca esto en 1 para enviar logs a CloudWatch

NEW_RELIC_LOG_LEVEL

info

info, debug, finest

Establecer el nivel de log del agente

Puede encontrar más variables de entorno en nuestra documentación de configuración de .NET y en el método de instrumentación sin capas .

Variable ambiental

Valor por defecto

Opciones

Descripción

NEW_RELIC_APP_NAME

Cuando NEW_RELIC_APM_LAMBDA_MODE es true, la extensión usa este valor como el nombre de la entidad de APM durante la llamada de conexión de inicio en frío. Consulta NEW_RELIC_APP_NAME para funciones Lambda en modo APM para obtener detalles sobre la agrupación de entidades, los informes multirregión, el comportamiento entre tiempos de ejecución y la nomenclatura compartida con servicios que no son de Lambda.

NEW_RELIC_LAMBDA_EXTENSION_ENABLED

true

true, false

Deshabilite la extensión configurando esto en false

NEW_RELIC_LICENSE_KEY_SECRET

NEW_RELIC_LICENSE_KEY

Establecer un nombre secreto personalizado en AWS Secrets Manager

NEW_RELIC_DATA_COLLECTION_TIMEOUT

Sin establecer

Una duración, como 500ms, 30s o 2m

Se aplica solo al modo serverless. Utilice esta configuración para definir un presupuesto total de reintentos para enviar telemetría y logs. Si no configura esta variable, la extensión utiliza un reintento corto y fijo. Cuando la configura, la extensión vuelve a intentarlo con un retraso creciente —200 ms, que se duplica cada tres intentos, hasta 3 s— hasta que se agote el presupuesto o alcance los 20 intentos. Un valor sin unidad, como 15, se trata como 10 segundos. Un valor menor reduce tanto la cantidad de reintentos como el tiempo de espera antes de un Telemetry client error.

NEW_RELIC_EXTENSION_SYNCHRONOUS_FLUSH

false

true, false

Se aplica solo al modo serverless. Cuando se establece en true, la extensión envía la carga del agente en cuanto la recibe, dentro de la misma invocación. De forma predeterminada, la extensión retiene la carga hasta que llega el informe de la plataforma para la invocación; luego, envía la carga en lotes o durante el cierre. Establézcalo en true para las funciones con tráfico escaso si necesita que los datos lleguen antes. Esta configuración requiere una versión reciente de la extensión.

NEW_RELIC_EXTENSION_PIPELINE_FLUSH

false

true, false

Cuando true, la extensión hace requests del siguiente evento de Lambda inmediatamente después de que se completa una invocación y envía telemetría en segundo plano. Esto mueve el tiempo de envío fuera de la duración facturada, lo que generalmente ahorra 50-200 ms por invocación. La extensión espera el envío en segundo plano al inicio de la siguiente invocación o durante el apagado. Si el entorno se congeló y la conexión se interrumpió, la extensión lo reintenta con un retroceso exponencial. La telemetría que aún está en tránsito cuando el entorno se apaga podría no entregarse. Utilice esta configuración si la función se ejecuta con frecuencia y la duración facturada es importante. Si también establece NEW_RELIC_EXTENSION_SYNCHRONOUS_FLUSH en true, tiene prioridad en las invocaciones en las que desencadena un envío inmediato; la extensión registra una advertencia al inicio para señalar el conflicto. Esta configuración requiere una versión reciente de la extensión.

NEW_RELIC_EXTENSION_LOGS_ENABLED

true

true, false

Deshabilite [NR_EXT] líneas de log configurando esto en false

NEW_RELIC_EXTENSION_LOG_LEVEL

INFO

INFO, DEBUG, TRACE, ERROR, WARN, ALL

Establezca el nivel de logs para NR_EXT líneas de log

NEW_RELIC_EXTENSION_SEND_FUNCTION_LOGS

false

true, false

Envíe logs de funciones configurando esto en true

NEW_RELIC_EXTENSION_SEND_EXTENSION_LOGS

false

true, false

Envíe logs de extensión configurando esto en true

NEW_RELIC_EXTENSION_SEND_PLATFORM_LOGS

false

true, false

Envíe logs de plataforma configurando esto en true

NEW_RELIC_EXTENSION_SEND_LOGS

platform, extension, function, all

Determina qué logs enviar. Establezca en all o function, extension y platform logs, o use una lista separada por comas (por ejemplo: platform,extension). Esta variable tiene prioridad sobre las variables individuales de tipo de log.

NEW_RELIC_LOG_ENDPOINT

https://log-api.newrelic.com/log/v1

Establecer los logs extremos. Seleccione la URL según su región:

  • Región de EE. UU. (predeterminado):
    https://log-api.newrelic.com/log/v1
  • Región de la UE:
    https://log-api.eu.newrelic.com/log/v1
  • Región de JP:
    https://log-api.jp.nr-data.net/log/v1

NEW_RELIC_TELEMETRY_ENDPOINT

https://cloud-collector.newrelic.com/aws/lambda/v1

Establezca el extremo de telemetría. Seleccione la URL según su región:

  • Región de EE. UU. (predeterminado):
    https://cloud-collector.newrelic.com/aws/lambda/v1
  • Centro de datos de la UE:
    https://cloud-collector.eu01.nr-data.net/aws/lambda/v1
  • Centro de datos de JP:
    https://cloud-collector.jp.nr-data.net/aws/lambda/v1

NEW_RELIC_IGNORE_EXTENSION_CHECKS

OBSOLETO Omite las comprobaciones suministrándolas como valores separados por comas dentro de una cadena. Emplee valores de cadena handler, agent, sanity, vendor o all

NEW_RELIC_LICENSE_KEY_SECRET

Especifique el nombre o ARN del secreto de AWS Secrets Manager que contiene su clave de licencia de New Relic.



Notas:

  • Esto sólo se emplea si `NEW_RELIC_LICENSE_KEY` no está configurado.
  • El secreto debe estar en la misma región de AWS que su función Lambda.
  • El rol de ejecución de su función Lambda necesita la licencia `secretsmanager:GetSecretValue` para este secreto.

NEW_RELIC_LICENSE_KEY_SSM_PARAMETER_NAME

Especifique el nombre o ARN del parámetro del almacén de parámetros de AWS Systems Manager que contiene su clave de licencia de New Relic.



Notas:

  • Esto sólo se emplea si `NEW_RELIC_LICENSE_KEY` no está configurado.
  • El parámetro SSM debe estar en la misma región de AWS que su función Lambda.
  • La función de ejecución de su función Lambda necesita la licencia `ssm:GetParameter` para este parámetro.

NEW_RELIC_CLOUD_AWS_ACCOUNT_ID

Para ayudar a New Relic a mapear y mostrar correctamente las relaciones entre sus entidades monitoreadas, proporcione el ID de la cuenta de AWS donde residen sus recursos monitoreados, como base de datos y función Lambda.

NEW_RELIC_LAMBDA_EXTENSION_PROXY

Configura un proxy para el tráfico saliente de la extensión y no afecta el tráfico de la función Lambda.



  • Admite: esquemas http://, https:// y socks5://
  • Autenticación: soporta user:pass (enmascarado en los logs)
  • Respaldo: usa HTTPS_PROXY o HTTP_PROXY si está sin establecer

nota

El tráfico de localhost nunca pasa por un proxy.

Vea más variables de entorno para la extensión New Relic en nuestra documentación.

Próximos pasos

Instalar y configurar el monitoreo de Lambda

Comience con la instrumentación y configuración de su función Lambda

Datos e UI

Aprenda a usar New Relic para monitorear su función Lambda AWS

Copyright © 2026 New Relic Inc.

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