• /
  • EnglishEspañolFrançais日本語한국어Português
  • ログイン今すぐ開始

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 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

アプリケーション名を設定してください。ただし、New Relic 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

環境変数の詳細については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

サーバーレスモードを有効にします。

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

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

環境変数

デフォルト値

オプション

説明

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

true

false

ディストリビューティッド(分散)トレーシングを有効にしてトレースを生成します。

NEW_RELIC_APP_NAME

アプリケーション名を設定してください。ただし、New Relic UIでは使用されません。

NEW_RELIC_LOG

stdout

stdout

サーバーレスモードの場合は、エージェントログパスを

stdout

に設定します。

NEW_RELIC_LOG_LEVEL

debug

デバッグ用の場合。情報用の場合は空欄。

エージェントのログレベルを設定します。

環境変数

デフォルト値

オプション

説明

NEW_RELIC_DISTRIBUTED_TRACING_ENABLED

true

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

アプリケーション名を設定してください。ただし、New Relic 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の設定に関するドキュメントおよびレイヤーレス計装の説明を参照してください。

環境変数

デフォルト値

オプション

説明

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_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

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

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監視のインストールと設定

Lambda関数の計装と設定を始める

データとUI

New Relicを使用してAWS Lambda関数を監視する方法を説明します

Copyright © 2026 New Relic株式会社。

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