AWS Lambdaの環境変数

環境変数を使用することで、設定情報や機密情報をコードの外部に保存できます。以下の表は、New Relicを使用してLambda関数を監視するために設定できる必須変数とランタイム固有の変数を示しています。

必須の環境変数

ランタイムに関係なく、New RelicでLambda関数を監視するには次の環境変数を設定する必要があります。

環境変数	説明
`NEW_RELIC_ACCOUNT_ID`	New RelicアカウントIDを指定します。
`NEW_RELIC_LAMBDA_HANDLER`	関数の実際のハンドラを見つけるために使用されるハンドララッパーを指定します。Goランタイムの場合は、この変数は必須ではありません。
`NEW_RELIC_LICENSE_KEY`	New Relicのインジェストキーを指定し、Secrets Managerの設定を上書きします。
`NEW_RELIC_APM_LAMBDA_MODE`	Lambda関数のAPM監視を有効にするには、`true`に設定します。
`NEW_RELIC_TRUSTED_ACCOUNT_KEY`	New RelicアカウントIDまたは親ID（存在する場合）を指定します。

追加の環境変数

ランタイムに応じて、以下の環境変数を設定することで、New Relic Lambdaの監視をさらに詳細に設定できます。

、、、、、、

環境変数	デフォルト値	オプション	説明
`NEW_RELIC_USE_ESM`	`false`	`true`、 `false`	非推奨：今後のNode.js Lambdaレイヤーのバージョンで削除されます。代わりにハンドラーを次のように設定します。 `/opt/nodejs/node_modules/newrelic-esm-lambda-wrapper/index.handler`
`NODE_OPTIONS`		`--experimental-loader newrelic/esm-loader.mjs`	必須：ESMが有効になっている場合は、この環境変数を設定して、New RelicのESMローダーを使用してください。
`NEW_RELIC_AI_MONITORING_ENABLED`	`false`	`true`、 `false`	レスポンスストリーミングに必須：New Relic 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`の場合に、New Relic 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`の場合に、New Relic 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`

環境変数の詳細についてはPythonの設定に関するドキュメントをご覧ください。

重要

新しいJavaエージェントレイヤーにはJava 17以降が必要です。これは、レガシーのJavaソリューションとは別のソリューションです。2026年4月10日より前にアプリケーションでサーバーレス監視を使用している場合、またはJava 8や11を使用している場合は、Open Tracingに基づくレガシーソリューションを引き続き使用してください。

環境変数	デフォルト値	オプション	説明
`AWS_LAMBDA_EXEC_WRAPPER`		`/opt/newrelic-java-handler`	必須：New Relic Javaエージェントレイヤーを使用する場合は、`/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/`	デフォルトでは、Javaエージェントのログファイルを絶対パスに設定します。 `/tmp/logs/newrelic_agent.log`
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`、 `false`	ディストリビューティッド（分散）トレーシングを有効にしてトレースを生成します。
`NEW_RELIC_PRIMARY_APPLICATION_ID`			New RelicアカウントIDを設定します。
`NEW_RELIC_DEBUG`	`false`	`true`、 `false`	デバッグロギングを有効にするには、次の値に設定します。 `true`
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE`が`true`の場合に、New Relic UIでAPMエンティティ名として使用されるアプリケーション名を設定します。エンティティのグループ化、マルチリージョンレポート、ランタイム間の動作、非Lambdaサービスとの命名の共有については、APMモードのLambda関数のNEW_RELIC_APP_NAMEを参照してください。

他の環境変数の詳細については、Javaエージェントの設定に関するドキュメントおよびJavaサーバーレス監視を参照してください。

環境変数	デフォルト値	オプション	説明
`NEW_RELIC_DISTRIBUTED_TRACING_ENABLED`	`true`	`true`、 `false`	ディストリビューティッド（分散）トレーシングを有効にしてトレースを生成します。
`NEW_RELIC_APP_NAME`			`NEW_RELIC_APM_LAMBDA_MODE`が`true`の場合に、New Relic 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`の場合に、New Relic 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`の場合に、New Relic 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の設定に関するドキュメントおよびレイヤーレス計装の説明を参照してください。

環境変数	デフォルト値	オプション	説明
`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`	10s		次のタイムアウト期間を設定します。 `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_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を選択してください。 USリージョン（デフォルト）： `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を選択してください。 USリージョン（デフォルト）： `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`			New Relicライセンスキーを含むAWS Secrets Manager内のシークレットの名前またはARNを指定します。メモ： `NEW_RELIC_LICENSE_KEY`が設定されていない場合にのみ使用します。シークレットはLambda関数と同じAWSリージョンにある必要があります。 Lambda関数の実行ロールには、このシークレットに対する`secretsmanager:GetSecretValue`権限が必要です。
`NEW_RELIC_LICENSE_KEY_SSM_PARAMETER_NAME`			New Relicライセンスキーを含むAWS Systems Manager Parameter Store内のパラメーターの名前またはARNを指定します。メモ： `NEW_RELIC_LICENSE_KEY`が設定されていない場合にのみ使用します。 SSMはLambda関数と同じAWSリージョンにある必要があります。 Lambda関数の実行ロールには、このパラメーターに対する`ssm:GetParameter`権限が必要です。
`NEW_RELIC_CLOUD_AWS_ACCOUNT_ID`			New Relicがモニター対象エンティティ間の関係を正しくマッピングして表示できるようにするには、データベースやLambda関数などの監視対象リソースが存在するAWSアカウントIDを指定します。
`NEW_RELIC_LAMBDA_EXTENSION_PROXY`			拡張機能のアウトバウンドトラフィック用のプロキシを設定しますが、Lambda関数のトラフィックには影響ありません。サポート：`http://`、`https://`、および`socks5://`スキーム認証：`user:pass`をサポート（ログではマスクされます）フォールバック：未設定の場合、`HTTPS_PROXY`または`HTTP_PROXY`を使用注意 Localhostトラフィックはプロキシ経由にはなりません。

New Relic拡張機能の環境変数に関する詳細は、New Relicのドキュメントをご覧ください。

必須の環境変数

追加の環境変数

重要

注意

次のステップ

Lambda監視のインストールと設定

データとUI

AWS Lambdaの環境変数

必須の環境変数.css-21sua1{background:none;border:none;width:0;padding:0;}

追加の環境変数

重要

注意

次のステップ

Lambda監視のインストールと設定

データとUI

必須の環境変数