AWS Lambda의 환경 변수

환경 변수는 코드 외부에 설정과 비밀을 저장하는 방법입니다. 다음 표에서는 Lambda 함수를 NEWLick으로 모니터링하기 위해 설정할 수 있는 필수 변수와 런타임별 변수를 표시합니다.

필수 환경 변수

런타임에 관계없이 Lambda 함수를 New Relic으로 모니터링하려면 다음 환경 변수를 설정해야 합니다.

환경 변수	설명
`NEW_RELIC_ACCOUNT_ID`	귀하의 뉴렐릭 계정 ID를 지정합니다
`NEW_RELIC_LAMBDA_HANDLER`	함수의 실제 핸들러를 찾는 데 사용되는 핸들러 래퍼를 지정합니다. Go 런타임의 경우 이 변수는 필수가 아닙니다.
`NEW_RELIC_LICENSE_KEY`	Secrets Manager를 재정의하여 뉴렐릭 수집 키를 지정합니다.
`NEW_RELIC_APM_LAMBDA_MODE`	Lambda 함수에 대한 APM 모니터링을 활성화하려면 `true` 으로 설정하세요.
`NEW_RELIC_TRUSTED_ACCOUNT_KEY`	존재하는 경우 귀하의 뉴렐릭 계정 ID 또는 부모 ID를 지정합니다.

추가 환경 변수

런타임에 따라 다음 환경 변수를 설정하여 NEWLamda Monitoring Lambda 추가로 구성할 수 있습니다.

환경 변수	기본값	옵션	설명
`NEW_RELIC_USE_ESM`	`false`	`true`, `false`	더 이상 사용되지 않음 : 이 기능은 향후 Node.js 람다 계층 버전에서 제거될 예정입니다. 대신 핸들러를 다음으로 설정하세요. `/opt/nodejs/node_modules/newrelic-esm-lambda-wrapper/index.handler`
`NODE_OPTIONS`		`--experimental-loader newrelic/esm-loader.mjs`	필수: ESM이 활성화된 경우 이 환경 변수를 설정하여 ESM 로더를 사용합니다.
`NEW_RELIC_AI_MONITORING_ENABLED`	`false`	`true`, `false`	응답 스트리밍에 필요: 뉴렐릭 UI 에서 AI 모니터링 응답을 활성화하려면 `true` 으로 설정합니다.
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`, `false`	내보내는 추적을 활성화하여 트레이스를 생성합니다.
`NEW_RELIC_NO_CONFIG_FILE`	`false`	`true`, `false`	Lambda에서 환경 변수를 사용하려면 다음을 설정합니다. `true`
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE` 이(가) `true`일 때 뉴렐릭 UI에서 APM 엔티티 이름으로 사용되는 애플리케이션 이름을 설정합니다. 엔티티 그룹화, 다중 리전 보고, 교차 런타임 동작 및 비 Lambda 서비스와의 공유 이름 지정에 대한 자세한 내용은 APM 모드의 Lambda 함수에 대한 NEW_RELIC_APP_NAME 을 참조하세요.
`NEW_RELIC_LOG_ENABLED`	`false`	`true`, `false`	이것을 설정하여 에이전트 로깅을 활성화합니다. `true`
`NEW_RELIC_LOG_LEVEL`	`info`	`fatal`, `error` , `warn` , `info` , `debug` , `trace`	에이전트 로그 레벨 설정
`NEW_RELIC_LOG`	`stdout`	`stdout`	서버리스 모드의 경우 에이전트 로그 경로를 `stdout` 로 설정합니다.
`NEW_RELIC_NATIVE_METRICS_ENABLED`	`true`	`true`, `false`	`false` 로 설정하여 콜드 스타트 기간을 줄이도록 비활성화하지만 VM 메트릭은 수집하지 않습니다.

Node.js 설정 문서 에서 더 많은 환경 변수를 찾을 수 있습니다.

환경 변수	기본값	옵션	설명
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`, `false`	내보내는 추적을 활성화하여 트레이스를 생성합니다.
`NEW_RELIC_NO_CONFIG_FILE`	`false`	`true`, `false`	Lambda에서 환경 변수를 사용하려면 다음을 설정합니다. `true`
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE` 이(가) `true`일 때 뉴렐릭 UI에서 APM 엔티티 이름으로 사용되는 애플리케이션 이름을 설정합니다. 엔티티 그룹화, 다중 리전 보고, 교차 런타임 동작 및 비 Lambda 서비스와의 공유 이름 지정에 대한 자세한 내용은 APM 모드의 Lambda 함수에 대한 NEW_RELIC_APP_NAME 을 참조하세요.
`NEW_RELIC_LOG`	`stderr`	`stderr`	서버리스 모드의 경우 에이전트 로그 경로를 `stderr` 로 설정합니다.
`NEW_RELIC_LOG_LEVEL`	`info`	`critical`, `error` , `warning` , `info` , `debug`	에이전트 로그 레벨 설정
`NEW_RELIC_SERVERLESS_MODE_ENABLED`	`false`	`true`, `false`	이것을 설정하여 서버리스 모드를 활성화하세요. `true`
`NEW_RELIC_PACKAGE_REPORTING_ENABLED`	`true`	`true`, `false`	이것을 설정하여 콜드 스타트 시간을 개선하십시오. `false`

끌어서 설정 문서 에서 더 많은 환경 변수를 찾을 수 있습니다.

중요

새로운 자바 에이전트 계층은 자바 17 이상이 필요합니다. 이것은 구형 자바 솔루션과는 별개의 솔루션입니다. 2026년 4월 10일 이전에 애플리케이션에 서버리스 모니터링을 사용 중이거나 자바 8 또는 11을 사용 중인 경우, Open Tracing을 기반으로 하는 구형 솔루션을 계속 사용하십시오.

환경 변수	기본값	옵션	설명
`AWS_LAMBDA_EXEC_WRAPPER`		`/opt/newrelic-java-handler`	필수: 뉴렐릭 에이전트 레이어 사용 시 `/opt/newrelic-java-handler` 로 설정해야 합니다. 이는 AWS Lambda가 레이어에 포함된 에이전트 래퍼 스크립트를 가리키도록 합니다.
`NEW_RELIC_SERVERLESS_MODE_ENABLED`	`true` (레이어에 미리 설정됨)	`true`, `false`	서버리스 모드를 활성화합니다. `AWS_LAMBDA_FUNCTION_NAME` 이 존재할 때 자동으로 감지됩니다. 레이어에서 `true` 로 사전 구성되어 있습니다.
`NEW_RELIC_LOG_FILE_PATH`	`/tmp/logs/` (레이어에 미리 설정됨)	`/tmp/logs/`	기본적으로 중력 에이전트 로그 파일이 절대 경로에 있도록 설정됩니다. `/tmp/logs/newrelic_agent.log`
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`, `false`	내보내는 추적을 활성화하여 트레이스를 생성합니다.
`NEW_RELIC_PRIMARY_APPLICATION_ID`			뉴렐릭 계정 ID를 설정하세요
`NEW_RELIC_DEBUG`	`false`	`true`, `false`	이 값을 설정하여 디버그 로깅을 활성화하십시오. `true`
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE` 이(가) `true`일 때 뉴렐릭 UI에서 APM 엔티티 이름으로 사용되는 애플리케이션 이름을 설정합니다. 엔티티 그룹화, 다중 리전 보고, 교차 런타임 동작 및 비 Lambda 서비스와의 공유 이름 지정에 대한 자세한 내용은 APM 모드의 Lambda 함수에 대한 NEW_RELIC_APP_NAME 을 참조하세요.

지속 저항 설정 문서 및 지속 서버 모니터링 에서 더 많은 환경 변수를 찾을 수 있습니다.

환경 변수	기본값	옵션	설명
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`, `false`	내보내는 추적을 활성화하여 트레이스를 생성합니다.
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE` 이(가) `true`일 때 뉴렐릭 UI에서 APM 엔티티 이름으로 사용되는 애플리케이션 이름을 설정합니다. 엔티티 그룹화, 다중 리전 보고, 교차 런타임 동작 및 비 Lambda 서비스와의 공유 이름 지정에 대한 자세한 내용은 APM 모드의 Lambda 함수에 대한 NEW_RELIC_APP_NAME 을 참조하세요.
`NEW_RELIC_LOG`	`stdout`	`stdout`	서버리스 모드의 경우 에이전트 로그 경로를 `stdout` 로 설정합니다.
`NEW_RELIC_LOG_LEVEL`		`debug` 디버그용 또는 정보용 (비워두면)	에이전트 로그 레벨 설정

환경 변수	기본값	옵션	설명
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`, `false`	내보내는 추적을 활성화하여 트레이스를 생성합니다.
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE` 이(가) `true`일 때 뉴렐릭 UI에서 APM 엔티티 이름으로 사용되는 애플리케이션 이름을 설정합니다. 엔티티 그룹화, 다중 리전 보고, 교차 런타임 동작 및 비 Lambda 서비스와의 공유 이름 지정에 대한 자세한 내용은 APM 모드의 Lambda 함수에 대한 NEW_RELIC_APP_NAME 을 참조하세요.

환경 변수	기본값	옵션	설명
`CORECLR_ENABLE_PROFILING`	`0`	`0`, `1`	필수: 이것을 설정하여 프로파일링을 활성화합니다. `1`
`CORECLR_PROFILER`		`{36032161-FFC0-4B61-B559-F6C5D41BAE5A}`	필수: .NET 에이전트를 활성화하려면 이것을 `{36032161-FFC0-4B61-B559-F6C5D41BAE5A}` 으로 설정하세요.
`CORECLR_NEWRELIC_HOME`		`/opt/lib/newrelic-dotnet-agent`	필수: .NET 에이전트를 활성화하려면 이것을 `/opt/lib/newrelic-dotnet-agent` 으로 설정하세요.
`CORECLR_PROFILER_PATH`		`/opt/lib/newrelic-dotnet-agent/libNewRelicProfiler.so`	필수: .NET 에이전트를 활성화하려면 이것을 `/opt/lib/newrelic-dotnet-agent/libNewRelicProfiler.so` 으로 설정하세요.
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`, `false`	내보내는 추적을 활성화하여 트레이스를 생성합니다.
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE` 이(가) `true`일 때 뉴렐릭 UI에서 APM 엔티티 이름으로 사용되는 애플리케이션 이름을 설정합니다. 엔티티 그룹화, 다중 리전 보고, 교차 런타임 동작 및 비 Lambda 서비스와의 공유 이름 지정에 대한 자세한 내용은 APM 모드의 Lambda 함수에 대한 NEW_RELIC_APP_NAME 을 참조하세요.
`NEW_RELIC_LOG_ENABLED`	`1`	`1`, `0`	이것을 설정하여 에이전트 로깅을 비활성화합니다. `0`
`NEW_RELIC_LOG_CONSOLE`	`0`	`1`, `0`	CloudWatch에 로그를 출력하려면 이것을 `1` 으로 설정합니다.
`NEW_RELIC_LOG_LEVEL`	`info`	`info`, `debug` , `finest`	에이전트 로그 레벨 설정

.NET 설정 문서 및 레이어 없는 HTML 메서드에서 더 많은 환경 변수를 찾을 수 있습니다.

환경 변수	기본값	옵션	설명
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE` 이(가) `true`일 때, 익스텐션은 콜드 스타트 연결 호출 중에 이 값을 APM 엔티티 이름으로 사용합니다. 엔티티 그룹화, 다중 리전 보고, 교차 런타임 동작 및 비 Lambda 서비스와의 공유 이름 지정에 대한 자세한 내용은 APM 모드의 Lambda 함수에 대한 NEW_RELIC_APP_NAME 을 참조하십시오.
`NEW_RELIC_LAMBDA_EXTENSION_ENABLED`	`true`	`true`, `false`	이것을 설정하여 확장 기능을 비활성화합니다. `false`
`NEW_RELIC_LICENSE_KEY_SECRET`	`NEW_RELIC_LICENSE_KEY`		AWS Secrets Manager에서 사용자 정의 비밀 이름 설정
`NEW_RELIC_DATA_COLLECTION_TIMEOUT`	설정되지 않음	기간, 예: `500ms`, `30s` 또는 `2m`	서버리스 모드에만 적용됩니다. 이 설정을 사용하여 텔레메트리 및 로그 전송을 위한 총 재시도 예산을 정의하십시오. 이 변수를 설정하지 않으면 확장 프로그램은 짧은 고정 재시도를 사용합니다. 이를 설정하면 확장 프로그램은 예산이 소진되거나 20회 시도에 도달할 때까지 점진적인 백오프 — 200ms, 3회 시도마다 두 배로 증가, 최대 3s — 로 재시도합니다. `15`과(와) 같이 단위가 없는 값은 10초로 처리됩니다. 값이 짧을수록 재시도 횟수와 `Telemetry client error` 이전의 대기 시간이 모두 줄어듭니다.
`NEW_RELIC_EXTENSION_SYNCHRONOUS_FLUSH`	`false`	`true`, `false`	서버리스 모드에만 적용됩니다. `true`인 경우, 익스텐션은 에이전트 페이로드를 수신하는 즉시 동일한 호출 내에서 전송합니다. 기본적으로 익스텐션은 해당 호출에 대한 플랫폼 보고서가 도착할 때까지 페이로드를 보관한 다음, 일괄적으로 또는 종료 시 페이로드를 전송합니다. 데이터가 더 빨리 도착해야 하는 경우 트래픽이 적은 함수에 대해 이 값을 `true` (으)로 설정하십시오. 이 설정에는 최신 익스텐션 버전이 필요합니다.
`NEW_RELIC_EXTENSION_PIPELINE_FLUSH`	`false`	`true`, `false`	`true`일 때, 익스텐션은 호출이 완료된 직후 다음 Lambda 이벤트를 requests하고 백그라운드에서 텔레메트리를 전송합니다. 이를 통해 전송 시간이 청구 기간 외부로 이동하여 일반적으로 호출당 50～200ms가 절약됩니다. 익스텐션은 다음 호출이 시작될 때 또는 종료 중에 백그라운드 전송을 기다립니다. 환경이 동결되고 연결이 끊어진 경우, 익스텐션은 지수 백오프를 사용하여 재시도합니다. 환경이 종료될 때 아직 전송 중인 텔레메트리는 전달되지 않을 수 있습니다. 함수가 자주 실행되고 청구 기간이 중요한 경우 이 설정을 사용하십시오. 또한 `NEW_RELIC_EXTENSION_SYNCHRONOUS_FLUSH`을(를) `true`(으)로 설정하는 경우 즉시 전송을 트리거하는 호출에서 우선순위를 가지며, 익스텐션은 시작 시 경고 로그를 기록하여 충돌을 표시합니다. 이 설정에는 최신 익스텐션 버전이 필요합니다.
`NEW_RELIC_EXTENSION_LOGS_ENABLED`	`true`	`true`, `false`	이것을 설정하여 `[NR_EXT]` 로그 줄을 비활성화합니다. `false`
`NEW_RELIC_EXTENSION_LOG_LEVEL`	`INFO`	`INFO`, `DEBUG` , `TRACE` , `ERROR` , `WARN` , `ALL`	`NR_EXT` 로그인 라인에 대한 로그인 레벨 설정
`NEW_RELIC_EXTENSION_SEND_FUNCTION_LOGS`	`false`	`true`, `false`	이것을 설정하여 기능 로그를 보내세요 `true`
`NEW_RELIC_EXTENSION_SEND_EXTENSION_LOGS`	`false`	`true`, `false`	이것을 설정하여 확장 로그를 보내세요 `true`
`NEW_RELIC_EXTENSION_SEND_PLATFORM_LOGS`	`false`	`true`, `false`	이 값을 설정하여 플랫폼 로그를 전송합니다. `true`
`NEW_RELIC_EXTENSION_SEND_LOGS`		`platform`, `extension` , `function` , `all`	보낼 로그를 결정합니다. `all` 또는 `function`, `extension` 및 `platform` 로그로 설정하거나 쉼표로 구분된 목록을 사용하십시오(예를 들어: `platform,extension`). 이 변수는 개별 로그 유형 변수보다 우선합니다.
`NEW_RELIC_LOG_ENDPOINT`	`https://log-api.newrelic.com/log/v1`		로그 엔드포인트를 설정합니다. 지역에 따라 URL을 선택합니다: 미국 지역(기본값): `https://log-api.newrelic.com/log/v1` EU 지역: `https://log-api.eu.newrelic.com/log/v1` JP 지역: `https://log-api.jp.nr-data.net/log/v1`
`NEW_RELIC_TELEMETRY_ENDPOINT`	`https://cloud-collector.newrelic.com/aws/lambda/v1`		텔레메트리 엔드포인트를 설정합니다. 지역에 따라 URL을 선택합니다: 미국 지역(기본값): `https://cloud-collector.newrelic.com/aws/lambda/v1` EU 데이터센터: `https://cloud-collector.eu01.nr-data.net/aws/lambda/v1` JP 데이터센터: `https://cloud-collector.jp.nr-data.net/aws/lambda/v1`
`NEW_RELIC_IGNORE_EXTENSION_CHECKS`			더 이상 사용되지 않습니다. 문자열 내에서 쉼표로 구분된 값을 제공하여 검사를 우회합니다. `handler`, `agent`, `sanity`, `vendor` 또는 `all` 문자열 값을 사용하세요.
`NEW_RELIC_LICENSE_KEY_SECRET`			뉴렐릭 라이선스 키가 포함된 AWS Secrets Manager 보안 암호의 이름 또는 ARN을 지정하십시오. 참고: `NEW_RELIC_LICENSE_KEY` 이 설정되지 않은 경우에만 사용됩니다. 비밀번호는 Lambda 함수와 동일한 AWS 지역에 있어야 합니다. Lambda 함수의 실행 역할에는 이 비밀에 대한 `secretsmanager:GetSecretValue` 권한이 필요합니다.
`NEW_RELIC_LICENSE_KEY_SSM_PARAMETER_NAME`			뉴렐릭 라이선스 키가 포함된 AWS Systems Manager Parameter Store 파라미터의 이름 또는 ARN을 지정하십시오. 참고: `NEW_RELIC_LICENSE_KEY` 이 설정되지 않은 경우에만 사용됩니다. SSM 참가자는 Lambda 함수와 동일한 AWS 지역에 있어야 합니다. 귀하의 Lambda 함수 실행 역할에는 이 보고서에 대한 `ssm:GetParameter` 권한이 필요합니다.
`NEW_RELIC_CLOUD_AWS_ACCOUNT_ID`			뉴렐릭가 모니터 부분 간의 관계를 올바르게 매핑하고 표시할 수 있도록 하려면 데이터베이스 및 Lambda 함수와 같은 모니터 리소스가 있는 AWS 계정 ID를 제공하세요.
`NEW_RELIC_LAMBDA_EXTENSION_PROXY`			익스텐션의 아웃바운드 트래픽에 대한 프록시를 구성하며 Lambda 함수 트래픽에는 영향을 주지 않습니다. 지원: `http://`, `https://`, `socks5://` 스킴 인증: `user:pass` 지원(로그에서 마스킹됨) 폴백: 설정되지 않은 경우 `HTTPS_PROXY` 또는 `HTTP_PROXY` 을(를) 사용합니다. 메모 Localhost 트래픽은 절대 프록시 처리되지 않습니다.

설명서 에서 뉴렐릭 확장에 대한 더 많은 환경 변수를 확인하세요.

다음 단계

Lambda 모니터링 설치 및 구성

Lambda 함수에 대한 측정, 로그 및 설정 시작하기

데이터 및 UI

뉴렐릭을 사용하여 AWS Lambda 함수를 모니터링하는 방법을 알아보세요.

사용자의 편의를 위해 제공되는 기계 번역입니다.

필수 환경 변수.css-21sua1{background:none;border:none;width:0;padding:0;}

추가 환경 변수

중요

메모

다음 단계

Lambda 모니터링 설치 및 구성

데이터 및 UI

필수 환경 변수