環境変数

以下の環境変数は、すべてのエージェント（ホスト型およびコンテナ型）で有効です。

環境変数	必須	デフォルト値	説明
JAVA_OPTS	いいえ	なし	ホストエージェントの起動時に渡すことを検討すべき、 Java® の仮想マシンの追加設定。 たとえば、`and-Xmx<value> ` を使用-Xms<value> すると、エージェントが利用可能なヒープの最小容量と最大容量をそれぞれ設定できます。
ENABLE_AGENT_SOCKET	いいえ	true	Instana エージェントとJVMとの通信方向を決定する変数。 エージェントへの通信を許可するには、この変数を次のように設定してくださいtrue。 JVM への通信を行うには、この変数を次のように設定してくださいfalse。
INSTANA_AGENT_MAX_MEM	いいえ	なし	エージェントが使用できるメモリの上限を設定します。 デフォルトでは、メモリ制限はコンテナのリソース制限に基づいて自動的に決定されます。INSTANA_AGENT_MAX_MEM がに設定されている場合INSTANA_AGENT_USE_MEMORY_CALCULATORfalse 、は無視されます。
INSTANA_AGENT_TLS_1_0	いいえ	false	TLS を有効にする v1.0.
INSTANA_AGENT_TLS_1_1	いいえ	false	TLS を有効にする v1.1.
INSTANA_AGENT_USE_MEMORY_CALCULATOR	いいえ	true	エージェントが、組み込みのメモリ計算機能を使用して、エージェントのメモリ制限を自動的に決定しようとするかどうかを制御します。
INSTANA_JVM_BYTEBUDDY_ATTACHMENT_ENABLED	いいえ	true	この変数は、Byte Buddy を使用した JVM の添付機能を有効または無効にします。
INSTANA_JVM_HANDLING_REQUIRE_ATTACH_FILES	いいえ	false	エージェントが、有効なアタッチファイルを持つJVMにのみアタッチするかどうかを制御します。 エージェントがプロセス遷移の際にJVMと誤認する可能性のある、 Java 以外のプロセスへのアタッチを防ぐように設定しますtrue 。 デフォルトでは、既存の添付ファイルの動作が維持されますfalse 。
INSTANA_AGENT_OTEL_GRPC	いいえ	false	OTEL GRPCサーバーを有効にする。
INSTANA_AGENT_OTEL_HTTP	いいえ	false	OTELを有効にする HTTP -server.
INSTANA_AGENT_OTEL_GRPC_PORT	いいえ	4317	OTELのGRPCポート番号を上書きします。
INSTANA_AGENT_OTEL_HTTP_PORT	いいえ	4318	OTEL HTTP -ポート番号を上書きします。
INSTANA_AGENT_OTEL_GRPC_LEGACY_PORT_ENABLED	いいえ	true 1.310.0 より以前のエージェントバージョンについては false 1.310.0 以降のバージョン	レガシー OTLP ポート（ gRPC ）を有効または無効にします（55680）。
INSTANA_APPEND_FQDN_TO_AGENT_ID	いいえ	false	同一のホスト間での一意性を確保するため、エージェントIDにホスト名を付加します。 詳細については、 「MACアドレスの重複によるエージェントIDの競合」 を参照してください
IN_MEMORY_CLASSLOADER	いいえ	false	ファイルベースのJARの代わりに、 JVM Java エージェントをin-memory-classloader コンテナ内に読み込むために使用します。 この機能を有効にすると、必要な空きストレージ容量は 3.5 MBに減少しますが、その代わりにヒープの使用量が増加します。
INSTANA_GIT_REMOTE_REPOSITORY	いいえ	なし	Git エージェントが Git ベースの構成管理に使用するリモート URL。 が設定されている場合INSTANA_GIT_REMOTE_BRANCH 、変数も設定する必要があります。
INSTANA_GIT_REMOTE_BRANCH	いいえ	なし	Git Git ベースの構成管理において、エージェントが追跡するリモートブランチ。 が設定されている場合INSTANA_GIT_REMOTE_REPOSITORY 、変数も設定する必要があります。
INSTANA_GIT_REMOTE_USERNAME	いいえ	なし	（任意）： Git 操作のベーシック認証で使用するユーザー名またはアクセストークン。
INSTANA_GIT_REMOTE_PASSWORD	いいえ	なし	オプション： Git の操作における基本認証で使用するパスワード。
INSTANA_AGENT_UPDATES_VERSION	いいえ	なし	センサーのバージョンを特定のSHAに固定します。 Agent Bootstrap からは1.2.49、この環境変数を使用してエージェントのバージョンを設定することも可能です。

以下の環境変数は、コンテナ化されたエージェントに固有のものです。

環境変数	必須	デフォルト値	説明
INSTANA_AGENT_BACKCHANNEL_ENABLED	いいえ	なし	エージェントが、 Instana のUIから送信されるコマンド（エージェントの再起動やエージェントからのログのダウンロードなど）を処理できるようにします。
INSTANA_AGENT_HTTP_LISTEN	いいえ	なし	エージェントが監視対象のアプリケーションからの着信トラフィックを待機するネットワークインターフェースのIPアドレスを設定します。 詳細については、 「ネットワークリファレンス」 を参照してください。
INSTANA_AGENT_HTTP_THREADS	いいえ	なし	監視対象のアプリケーションからのデータを含む、 HTTP への着信トラフィックを処理するスレッド数を設定します。
INSTANA_LOG_LEVEL	はい	INFO	com.instana パッケージのログレベルを制御します。 取り得る値：INFO,DEBUG,TRACE,WARN,ERROR, またはOFF。
INSTANA_ROOT_LOGGER_LOG_LEVEL	いいえ	INFO	によって対象とされていない、その他のINSTANA_LOG_LEVELすべてのパッケージのログレベルを制御します。 取り得る値：INFO,DEBUG,TRACE,WARN,ERROR, またはOFF。
INSTANA_ROOT_LOGGER_CONSOLE_APPENDER_LOG_LEVEL	いいえ	INFO	コンソール（stdout）に出力され、コンテナのロギング機能によって収集されるログレベルを定義します。 取り得る値：INFO,DEBUG,TRACE,WARN,ERROR, またはOFF。
INSTANA_AGENT_KEY	はい	なし	Instana のエージェントキー。
INSTANA_AGENT_ENDPOINT	いいえ	なし	ホストエージェントのエンドポイント。
INSTANA_AGENT_ENDPOINT_PORT	いいえ	なし	ホストエージェントのエンドポイントポート。
INSTANA_AGENT_ZONE	いいえ	なし	ホストエージェントを配置するゾーン。
INSTANA_AGENT_TAGS	いいえ	なし	エージェントを実行するホストに関連付けられたタグのカンマ区切りリスト。例：my_tag=myvalue,my_other_tag
INSTANA_AGENT_MAX_MEM	いいえ	なし	エージェントが使用できるメモリの上限を設定します。 デフォルトでは、メモリ制限はコンテナのリソース制限に基づいて自動的に決定されます。INSTANA_AGENT_MAX_MEM がに設定されている場合INSTANA_AGENT_USE_MEMORY_CALCULATORfalse 、は無視されます。
INSTANA_AGENT_MODE	いいえ	APM	エージェントモード。 指定可能な値は、INFRASTRUCTURE...AWS、またはOFFAPM...です。
INSTANA_DOWNLOAD_KEY	いいえ	なし	Instana のダウンロードキーです。
INSTANA_AGENT_MODE_WEB_OVERRIDE_ALLOWED	いいえ	なし	Instana のUIからエージェントモードを変更できます。
INSTANA_AGENT_SCHEDULER_THREADS	いいえ	なし	エージェントが実行する各種のスケジュールされたタスクや非同期タスクに使用可能なスレッド数を設定します。
INSTANA_AGENT_SOURCE_DOWNLOAD_ENABLED	いいえ	なし	エージェントが監視対象プロセスのソースコードを Instana にアップロードできるようにし、そのソースコードをトレースデータと関連付けられるようにします。
INSTANA_AGENT_UNIQUE_AGENT_ID	いいえ	なし	静的なエージェントIDを設定します。 詳細については、 「MACアドレスの重複によるエージェントIDの競合」 を参照してください。
INSTANA_AGENT_USE_CLOUD_PROVIDER_ID	いいえ	なし	エージェントに対し、クラウドプロバイダーIDをエージェントIDとして使用するよう指示します。
INSTANA_AGENT_USE_MEMORY_CALCULATOR	いいえ	なし	エージェントが、組み込みのメモリ計算機能を使用して、エージェントのメモリ制限を自動的に決定しようとするかどうかを制御します。
INSTANA_AGENT_UPDATES_FREQUENCY	いいえ	日	センサーの更新情報を取得する頻度を制御します。 詳細については、 「更新プログラムとバージョンの固定」 を参照してください。
INSTANA_AGENT_UPDATES_TIME	いいえ	04:30	センサーの更新データを取得するタイミングを制御します。 詳細については、 「更新プログラムとバージョンの固定」 を参照してください。
INSTANA_AGENT_PROXY_HOST	いいえ	なし	プロキシのホスト名またはアドレス。
INSTANA_AGENT_PROXY_PORT	いいえ	なし	プロキシのポート。
INSTANA_AGENT_PROXY_PROTOCOL	いいえ	なし	httpプロキシプロトコルなど。
INSTANA_AGENT_PROXY_USER	いいえ	なし	プロキシ認証のユーザー名。
INSTANA_AGENT_PROXY_PASSWORD	いいえ	なし	プロキシ認証のパスワード。
INSTANA_AGENT_PROXY_USE_DNS	いいえ	いいえ	プロキシが DNS も使用しているかどうかを示すブール値。
INSTANA_REPOSITORY_PROXY_ENABLED	いいえ	なし	センサーの更新に限り、プロキシ設定を上書きできるようにします。
INSTANA_REPOSITORY_PROXY_HOST	いいえ	なし	Maven センサーリポジトリのプロキシのホスト名またはアドレス。
INSTANA_REPOSITORY_PROXY_PORT	いいえ	なし	Maven センサーリポジトリのプロキシのポート。
INSTANA_REPOSITORY_PROXY_PROTOCOL	いいえ	なし	Maven センサーリポジトリのプロキシプロトコル。
INSTANA_REPOSITORY_PROXY_USER	いいえ	なし	Maven センサーリポジトリのプロキシ認証用のユーザー名。
INSTANA_REPOSITORY_PROXY_PASSWORD	いいえ	なし	Maven センサーリポジトリのプロキシ認証用のパスワード。
INSTANA_MVN_REPOSITORY_URL	いいえ	なし	動的エージェントおよびセンサーバンドルのダウンロード用 Maven リポジトリのホスト名。 詳細については、 「エージェントリポジトリのミラーの設定」 を参照してください。
INSTANA_MVN_REPOSITORY_FEATURES_PATH	いいえ	なし	機能アップデートの Maven リポジトリのパス。 これは旧来の機能です。 詳細については、 「エージェントリポジトリのミラーの設定」 を参照してください。
INSTANA_MVN_REPOSITORY_SHARED_PATH	いいえ	なし	動的なエージェントおよびセンサーバンドルの更新用の Maven リポジトリのパス。 詳細については、 「エージェントリポジトリのミラーの設定」 を参照してください。
AGENT_RELEASE_REPOSITORY_MIRROR_URL	いいえ	なし	エージェントリリースリポジトリのミラーである URL。 これは旧来の機能です。 詳細については、 「 Maven のレガシーリポジトリ設定」 を参照してください。
AGENT_RELEASE_REPOSITORY_MIRROR_USERNAME	いいえ	なし	エージェント・リリース・リポジトリのミラーにアクセスするためのユーザー名。 これは旧来の機能です。 詳細については、 「 Maven のレガシーリポジトリ設定」 を参照してください。
AGENT_RELEASE_REPOSITORY_MIRROR_PASSWORD	いいえ	なし	エージェント・リリース・リポジトリのミラーにアクセスするためのパスワード。 これは旧来の機能です。 詳細については、 「 Maven のレガシーリポジトリ設定」 を参照してください。
INSTANA_SHARED_REPOSITORY_MIRROR_URL	いいえ	なし	共有リポジトリミラーの URL。 詳細については、 「 Maven リポジトリのミラーの設定」 を参照してください。
INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME	いいえ	なし	共有リポジトリのミラーにアクセスするためのユーザー名。 詳細については、 「 Maven リポジトリのミラーの設定」 を参照してください。
INSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD	いいえ	なし	共有リポジトリのミラーにアクセスするためのパスワード。 詳細については、 「 Maven リポジトリのミラーの設定」 を参照してください。

詳細については、 エージェントの設定ドキュメントおよび git ベースのエージェント設定ドキュメントを参照してください。

環境変数	値	説明
INSTANA_ENDPOINT_URL	ストリング	サーバーレスエージェントが接続する Instana のバックエンドエンドポイント。 これは、ご使用のリージョンによって異なり、ホスト・エージェントのバックエンド・エンドポイントとは異なります。 それは、次のようにhttps://serverless-始まります。
INSTANA_AGENT_KEY	ストリング	Instana のエージェントキー。 ホスト・エージェントとサーバーレス・モニタリングに同じエージェント・キーを使用できます。
INSTANA_TIMEOUT	整数	HTTP が Instana バックエンドにデータを報告するリクエストのタイムアウト（ミリ秒単位）。
INSTANA_ENDPOINT_PROXY	URL	この変数をにhttp://my-proxy.tld 設定すると、http://user:password@my-proxy.tldHTTP (S) プロキシを経由して、 Instana バックエンドへデータが送信されるようになります。
INSTANA_EXTRA_HTTP_HEADERS	ストリング、セミコロン区切り	収集する HTTP ヘッダーのセミコロン区切りのリスト。
INSTANA_SERVICE_NAME	ストリング	カスタム・サービスの名前。
INSTANA_LOG_LEVEL	debug……infowarnあるいはerror	Instana パッケージのログレベル。 デフォルトでは、それは……ですinfo。
INSTANA_LOG_SPANS	true orfalse	この変数を設定するとtrue 、 Instana の計測によって生成されたスパンを取得できます。これらは標準出力にダンプされます。 この設定は SDK および自動インスツルメンテーションの問題のデバッグに利用できます。
INSTANA_DEBUG	ストリング	この変数に任意の値を指定すると、ログレベルがその値に設定されますdebug。
INSTANA_DISABLE_CA_CHECK	true orfalse	この変数を設定するとtrue 、 Instana バックエンドに接続する際、Lambdaランタイムに組み込まれているCAリストに対するサーバー証明書の検証が無効になります。 この機能を有効にすると、この接続に対する MITM 攻撃に対してラムダが脆弱になります。 この設定は、 Instana をセルフホストで利用しており、既知のルートCAを持つ証明書で Instana バックエンドを動作させることができない場合にのみ使用してください。
INSTANA_SECRETS	ストリング	値は次のように構成する必要があります。<matcher>:<secret>[,<secret>]例えばcontains-ignore-case:key,password,secret： マッチャーの詳細については、 『Secrets 』のドキュメントを参照してください。
INSTANA_TAGS	ストリング、コンマ区切り	監視対象のコンポーネントに関連付けられたタグの一覧（カンマ区切り）。my_tag=myvalue,my_other_tag例：
INSTANA_ZONE	ストリング	この管理対象コンポーネントの配置先のゾーン。
INSTANA_DISABLE_USE_OPENTELEMETRY	true orfalse	この変数をにtrue 設定すると、opentelemetryの統合が無効になります。 デフォルト値はfalseです。
INSTANA_STACK_TRACE	all、errorまたはnone	この変数を にerror 設定すると、エラーが発生したスパンについてのみスタックトレースを取得するようになります。また、 にnone 設定すると、スタックトレースの取得が無効になります。 デフォルト値はall。
INSTANA_STACK_TRACE_LENGTH	整数	スパン内のキャプチャーされたスタック・トレース・フレームの数を制限するには、この変数を設定します。

Instana が提供する動的言語センサーは、環境変数の共通セットに従います。 次の表は、この共通セットを説明しています。

Java、 Scala、.NET、.NET Core、または PHP に関する詳細については、それぞれのドキュメントページを参照してください。

環境変数	値	説明
INSTANA_AGENT_HOST	IP アドレスまたは DNS 名	Instana ホスト・エージェントの場所をユーザーが手動で指定できるようにします。
INSTANA_AGENT_PORT	ポート番号	Instana ホスト・エージェントのポートを手動で指定します。
INSTANA_DISABLE_AUTO_INSTR	true orfalse	自動インスツルメンテーションを無効にします。
INSTANA_SERVICE_NAME	ストリング	アプリケーション全体のサービス名を設定します。
INSTANA_PROCESS_NAME	ストリング	そのランタイムを表すインフラストラクチャ・エンティティに、カスタムラベルを設定します。 [1]
INSTANA_DEBUG	任意の値	デバッグログの記録を有効にします。 オーバーヘッドやログのスパムを避けるため、使用期間は限定してください。
INSTANA_DISABLE_USE_OPENTELEMETRY	true orfalse	この変数をにtrue 設定すると、opentelemetryの統合が無効になります。 デフォルト値はfalseです。
INSTANA_STACK_TRACE	all、errorまたはnone	この変数を にerror 設定すると、エラーが発生したスパンについてのみスタックトレースを取得するようになります。また、 にnone 設定すると、スタックトレースの取得が無効になります。 デフォルト値はall。
INSTANA_STACK_TRACE_LENGTH	整数	スパン内のキャプチャーされたスタック・トレース・フレームの数を制限するには、この変数を設定します。

Java、 Scala、 .NET、 .NET Core、または PHPについては、対応する資料ページを参照してください。

言語	Crystal	Go	Haskell	NGINX	Node.js	PHP	Python	Ruby	.NET Core	.NET
INSTANA_AGENT_HOST	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_AGENT_PORT	✅	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_AUTO_INSTR	該当なし	該当なし	該当なし	該当なし	✅	❌	✅	✅	❌	❌
INSTANA_SERVICE_NAME	❌	✅	✅	✅	✅	✅	✅	✅	✅	✅
INSTANA_PROCESS_NAME	✅	✅	✅	✅	✅	✅	✅	✅	❌	❌
INSTANA_DEBUG	✅	✅	❌	✅	✅	✅	✅	✅	✅	✅
INSTANA_DISABLE_USE_OPENTELEMETRY	❌	❌	❌	❌	✅	❌	❌	❌	❌	❌
INSTANA_STACK_TRACE	❌	❌	❌	❌	✅	✅	✅	✅	❌	❌
INSTANA_STACK_TRACE_LENGTH	❌	❌	❌	❌	✅	✅	✅	✅	❌	❌