AWS Lambda의 환경 변수

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

필수 환경 변수

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

환경 변수	설명
`NEW_RELIC_ACCOUNT_ID`	귀하의 뉴렐릭 계정 ID를 지정합니다
`NEW_RELIC_LAMBDA_HANDLER`	Specifies the handler wrapper used to find your function's actual handler. For Go runtimes, this variable isn't required.
`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`			뉴렐릭 UI에서는 사용되지 않는 기능 이름을 설정합니다.
`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`			뉴렐릭 UI에서는 사용되지 않는 기능 이름을 설정합니다.
`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`

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

중요

The New Relic Java agent layer requires Java 17 or later.

환경 변수	기본값	옵션	설명
`AWS_LAMBDA_EXEC_WRAPPER`		`/opt/newrelic-java-handler`	Required : Must be set to `/opt/newrelic-java-handler` when using the New Relic Java agent layer. This points AWS Lambda to the agent wrapper script bundled in the layer.
`NEW_RELIC_SERVERLESS_MODE_ENABLED`	`true` (pre-set in layer)	`true` , `false`	Enables serverless mode. Automatically detected when `AWS_LAMBDA_FUNCTION_NAME` is present. Pre-configured to `true` in the layer.
`NEW_RELIC_LOG_FILE_PATH`	`/tmp/logs/` (pre-set in layer)	`/tmp/logs/`	By default sets up the Java agent log file to be in the absolute path `/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`	Enable debug logging by setting this to `true`

You can find more environment variables in our Java agent configuration documentation and Java serverless monitoring.

환경 변수	기본값	옵션	설명
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true` , `false`	내보내는 추적을 활성화하여 트레이스를 생성합니다.
`NEW_RELIC_APP_NAME`			뉴렐릭 UI에서는 사용되지 않는 기능 이름을 설정합니다.
`NEW_RELIC_LOG`	`stdout`	`stdout`	서버리스 모드의 경우 에이전트 로그 경로를 `stdout` 로 설정합니다.
`NEW_RELIC_LOG_LEVEL`		`debug` 디버그용 또는 정보용 (비워두면)	에이전트 로그 레벨 설정

환경 변수

기본값

옵션

설명

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

false

내보내는 추적을 활성화하여 트레이스를 생성합니다.

환경 변수	기본값	옵션	설명
`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`			뉴렐릭 UI에서는 사용되지 않는 기능 이름을 설정합니다.
`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_LAMBDA_EXTENSION_ENABLED`	`true`	`true` , `false`	이것을 설정하여 확장 기능을 비활성화합니다. `false`
`NEW_RELIC_LICENSE_KEY_SECRET`	`NEW_RELIC_LICENSE_KEY`		AWS Secrets Manager에서 사용자 정의 비밀 이름 설정
`NEW_RELIC_DATA_COLLECTION_TIMEOUT`	10초		시간 초과 기간을 설정합니다. `Telemetry client error`
`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_LOG_ENDPOINT`	`https://log-api.newrelic.com/log/v1`	`https://log-api.newrelic.com/log/v1` , `https://log-api.eu.newrelic.com/log/v1`	로그 엔드포인트 설정
`NEW_RELIC_TELEMETRY_ENDPOINT`	`https://cloud-collector.newrelic.com/aws/lambda/v1`	`https://cloud-collector.newrelic.com/aws/lambda/v1` , `https://cloud-collector.eu01.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 레지스트리 스토어에서 시위의 이름 또는 ARN을 지정합니다. 메모: `NEW_RELIC_LICENSE_KEY` 이 설정되지 않은 경우에만 사용됩니다. SSM 참가자는 Lambda 함수와 동일한 AWS 지역에 있어야 합니다. 귀하의 Lambda 함수 실행 역할에는 이 보고서에 대한 `ssm:GetParameter` 권한이 필요합니다.
`NEW_RELIC_CLOUD_AWS_ACCOUNT_ID`			To help New Relic correctly map and display relationships between your monitored entities, provide the AWS Account ID where your monitored resources, such as databases and Lambda functions, reside.

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

다음 단계

Lambda 모니터링 설치 및 구성

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

데이터 및 UI

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

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

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

추가 환경 변수

중요

다음 단계

Lambda 모니터링 설치 및 구성

데이터 및 UI

필수 환경 변수