环境变量

对于在可选地配置主要 Instana 组件时使用的各种环境变量，请参阅以下信息。

主机代理的环境变量

表 1：主机代理的环境变量
环境变量 必需 缺省值 描述
INSTANA_AGENT_KEY 是 不适用 您的 Instana 代理密钥。
INSTANA_AGENT_ENDPOINT 是 不适用 主机代理端点。
INSTANA_AGENT_ENDPOINT_PORT 是 不适用 主机代理端点端口。
INSTANA_AGENT_ZONE False 不适用 放置主机代理的区域。
INSTANA_AGENT_TAGS False 不适用 以逗号分隔的与运行代理的主机相关联的标记列表，如 my_tag=myvalue,my_other_tag。
INSTANA_AGENT_MODE False APM 代理模式。 可用值为 APM, INFRASTRUCTURE, AWS 或 OFF。
INSTANA_DOWNLOAD_KEY False 不适用 您的 Instana 下载密钥。
INSTANA_AGENT_UPDATES_VERSION False 不适用 将传感器版本固定在特定的 SHA 上。
INSTANA_AGENT_UPDATES_FREQUENCY False 日班 控制获取传感器更新的频率。 更多信息，请参阅更新和版本固定。
INSTANA_AGENT_UPDATES_TIME False 04:30 控制获取传感器更新的时间。 更多信息，请参阅更新和版本固定。
INSTANA_AGENT_PROXY_HOST False 不适用 代理的主机名/地址。
INSTANA_AGENT_PROXY_PORT False 不适用 代理的端口。
INSTANA_AGENT_PROXY_PROTOCOL False 不适用 代理协议，如 http。
INSTANA_AGENT_PROXY_USER False 不适用 代理认证的用户名。
INSTANA_AGENT_PROXY_PASSWORD False 不适用 代理验证密码。
INSTANA_AGENT_PROXY_USE_DNS False 否 布尔值，表示代理是否也使用 DNS。
INSTANA_GIT_REMOTE_REPOSITORY False 不适用 Git 远程 URL ，供主机代理用于基于 Git 的配置管理。 如果设置了 INSTANA_GIT_REMOTE_BRANCH ，则必须设置该变量。
INSTANA_GIT_REMOTE_BRANCH False 不适用 Git 基于 Git 的配置管理，主机代理可跟踪远程分支。 如果设置了 INSTANA_GIT_REMOTE_REPOSITORY ，则必须设置该变量。
INSTANA_REPOSITORY_PROXY_ENABLED False 不适用 启用专门用于传感器更新的覆盖代理设置。
INSTANA_REPOSITORY_PROXY_HOST False 不适用 Maven 传感器存储库代理的主机名/地址。
INSTANA_REPOSITORY_PROXY_PORT False 不适用 Maven 传感器资源库代理的端口。
INSTANA_REPOSITORY_PROXY_PROTOCOL False 不适用 Maven 传感器存储库的代理协议。
INSTANA_REPOSITORY_PROXY_USER False 不适用 Maven 传感器存储库代理认证的用户名。
INSTANA_REPOSITORY_PROXY_PASSWORD False 不适用 Maven 传感器存储库的代理认证密码。
INSTANA_MVN_REPOSITORY_URL False 不适用 用于下载动态代理和传感器捆绑包的 Maven 资源库的主机名。 更多信息，请参阅配置代理版本库镜像。
INSTANA_MVN_REPOSITORY_FEATURES_PATH False 不适用 功能更新的 Maven 资源库路径。 更多信息，请参阅配置代理版本库镜像。
INSTANA_MVN_REPOSITORY_SHARED_PATH False 不适用 用于代理和传感器捆绑包更新的 Maven 资源库路径。 更多信息，请参阅配置代理版本库镜像。
INSTANA_LOG_LEVEL False 信息 INFO, DEBUG, TRACE, WARN, ERROR, 或 OFF。
AGENT_RELEASE_REPOSITORY_MIRROR_URL False 不适用 代理版本库镜像的 URL。 更多信息，请参阅将代理存储库配置为镜像。
AGENT_RELEASE_REPOSITORY_MIRROR_USERNAME False 不适用 访问代理版本库镜像的用户名。 更多信息，请参阅将代理存储库配置为镜像。
AGENT_RELEASE_REPOSITORY_MIRROR_PASSWORD False 不适用 访问代理版本库镜像的密码。 更多信息，请参阅将代理存储库配置为镜像。
INSTANA_SHARED_REPOSITORY_MIRROR_URL False 不适用 共享版本库镜像的 URL。 更多信息，请参阅将代理存储库配置为镜像。
INSTANA_SHARED_REPOSITORY_MIRROR_USERNAME False 不适用 访问共享版本库镜像的用户名。 更多信息，请参阅将代理存储库配置为镜像。
INSTANA_SHARED_REPOSITORY_MIRROR_PASSWORD False 不适用 访问代理功能库镜像的密码。 更多信息，请参阅将代理存储库配置为镜像。
JAVA_OPTS 不适用 您可能希望传递给主机代理启动程序的其他 Java® 虚拟机配置。 例如，可以使用 -Xms<value> 和 -Xmx<value> 分别设置代理可用堆的最小值和最大值。
ENABLE_AGENT_SOCKET 不适用 决定 Instana 代理与 JVM 通信方向的变量。 若要将通信导向代理，请将此变量设为 true。 要直接与 JVM 通信，请将此变量设置为 false。 缺省值为 true。
INSTANA_AGENT_TLS_1_0 启用 TLS v1.0. 缺省值： false
INSTANA_AGENT_TLS_1_1 启用 TLS v1.1. 缺省值： false
INSTANA_JVM_BYTEBUDDY_ATTACHMENT_ENABLED False true 该变量通过使用 bytebuddy 启用或禁用 JVM 附加功能。
INSTANA_AGENT_OTEL_GRPC False false 启用 OTEL GRPC-服务器。
INSTANA_AGENT_OTEL_HTTP False false 启用 OTEL HTTP -server。
INSTANA_AGENT_OTEL_GRPC_PORT False 4317 覆盖 OTEL GRPC 端口号。
INSTANA_AGENT_OTEL_HTTP_PORT False 4318 覆盖 OTEL HTTP -端口号。
INSTANA_APPEND_FQDN_TO_AGENT_ID False false 将主机名添加到代理 ID 中，以确保相同主机间的唯一性。 更多信息，请参阅 " 由于相同的 MAC 地址导致代理 ID 冲突"。

更多信息，请参阅代理配置文档和基于 git 的代理配置文档。

无服务器监控的环境变量

表 2：无服务器监控的环境变量
环境变量 值 描述
INSTANA_ENDPOINT_URL 字符串 无服务器代理连接的 Instana 后端端点。 它取决于您的区域，并且与主机代理程序后端端点不同。 从 https://serverless- 开始。
INSTANA_AGENT_KEY 字符串 您的 Instana Agent 密钥。 相同的代理程序密钥可以用于主机代理程序和无服务器监视。
INSTANA_TIMEOUT 整数 HTTP 请求向 Instana 后台报告数据的超时（毫秒）。
INSTANA_ENDPOINT_PROXY URL 将此变量设为 http://my-proxy.tld 或 http://user:password@my-proxy.tld ，以便通过 HTTP (S) 代理向 Instana 后端报告数据。
INSTANA_EXTRA_HTTP_HEADERS 字符串，分号分隔 以分号分隔的 HTTP 标头列表。
INSTANA_SERVICE_NAME 字符串 自定义服务名称。
INSTANA_LOG_LEVEL debug, info, warn, 或 error Instana 软件包的日志级别。 默认情况下，它是 info。
INSTANA_LOG_SPANS true 或 false 将此变量设为 true ，以获得由 Instana 仪器生成的跨度，并将其转储为标准输出。 此设置对于调试 SDK 和自动检测问题很有用。
INSTANA_DEBUG 字符串 将此变量设置为任意值，可将日志级别设置为 debug。
INSTANA_DISABLE_CA_CHECK true 或 false 将此变量设为 true ，可在 Lambda 运行时连接 Instana 后端时，禁用根据内置 CA 列表验证服务器证书。 启用此功能使 lambda 容易受到此连接的 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 或 false 将此变量设为 true 可禁用开放式遥测集成。 缺省值为 false。
INSTANA_STACK_TRACE_LENGTH 整数 设置此变量可限制跨度内捕获的堆栈跟踪帧数。

AWS 支持 Lambda

表 3： AWS Lambda 的环境变量
环境变量 执行 Java Node.js Python
INSTANA_ENDPOINT_URL ✅ ✅ ✅ ✅
INSTANA_AGENT_KEY ✅ ✅ ✅ ✅
INSTANA_TIMEOUT ✅ ❌ ✅ ✅
INSTANA_ENDPOINT_PROXY ✅ ✅ ✅ ✅
INSTANA_EXTRA_HTTP_HEADERS ✅ ✅ ✅ ✅
INSTANA_SERVICE_NAME ✅ ✅ ✅ ✅
INSTANA_LOG_LEVEL ✅ ✅ ✅ ✅
INSTANA_LOG_SPANS ❌ ✅ ❌ ❌
INSTANA_DEBUG ✅ ✅ ✅ ✅
INSTANA_DISABLE_CA_CHECK ❌ ✅ ✅ ✅
INSTANA_SECRETS ✅ ✅ ✅ ✅
INSTANA_TAGS ❌ ✅ ❌ ❌
INSTANA_ZONE ✅ ✅ ✅ ✅
INSTANA_SSM_PARAM_NAME ❌ ❌ ✅ ❌
INSTANA_SSM_DECRYPTION ❌ ❌ ✅ ❌
INSTANA_DISABLE_USE_OPENTELEMETRY ❌ ❌ ✅ ❌

AWS Fargate 支持

表 4： AWS Fargate 的环境变量
环境变量 .NET Core 执行 Java Node.js Python PHP
INSTANA_ENDPOINT_URL ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_AGENT_KEY ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_TIMEOUT ✅ ✅ ❌ ✅ ✅ ✅
INSTANA_ENDPOINT_PROXY ✅ ✅ ✅ ✅ ✅ ❌
INSTANA_EXTRA_HTTP_HEADERS ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_SERVICE_NAME ❌ ✅ ✅ ✅ ✅ ✅
INSTANA_LOG_LEVEL ❌ ✅ ✅ ✅ ✅ ✅
INSTANA_LOG_SPANS ❌ ❌ ✅ ❌ ❌ ❌
INSTANA_DEBUG ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_DISABLE_CA_CHECK ❌ ❌ ✅ ✅ ✅ ❌
INSTANA_SECRETS ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_TAGS ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_ZONE ✅ ✅ ✅ ✅ ✅ ✅
INSTANA_DISABLE_USE_OPENTELEMETRY ❌ ❌ ❌ ✅ ❌ ❌

Google Cloud 运行支持

表 5： Google Cloud 运行的环境变量
环境变量 执行 Node.js
INSTANA_ENDPOINT_URL ✅ ✅
INSTANA_AGENT_KEY ✅ ✅
INSTANA_TIMEOUT ✅ ✅
INSTANA_ENDPOINT_PROXY ✅ ✅
INSTANA_EXTRA_HTTP_HEADERS ✅ ✅
INSTANA_SERVICE_NAME ✅ ✅
INSTANA_LOG_LEVEL ✅ ✅
INSTANA_LOG_SPANS ❌ ❌
INSTANA_DEBUG ✅ ✅
INSTANA_DISABLE_CA_CHECK ❌ ✅
INSTANA_SECRETS ✅ ✅
INSTANA_TAGS ✅ ✅
INSTANA_ZONE ✅ ✅
INSTANA_DISABLE_USE_OPENTELEMETRY ❌ ✅

动态语言传感器的环境变量

由 Instana 提供的动态语言传感器考虑了一组常用环境变量。 下表描述了此公共集。

有关 Java、.NET、.NET Core 或 PHP 的更多信息，请参阅相应的文档页面、 Scala、.NET、. NET Core 或 PHP 的信息，请参见相应的文档页面。

表 6：动态语言传感器的环境变量
环境变量 值 描述
INSTANA_AGENT_HOST IP 地址或 DNS 名称 允许用户手动指定 Instana 主机代理的位置。
INSTANA_AGENT_PORT 端口号 手动指定 Instana 主机代理的端口。
INSTANA_DISABLE_AUTO_INSTR true 或 false 禁用自动仪器。
INSTANA_SERVICE_NAME 字符串 设置全应用程序服务名称。
INSTANA_PROCESS_NAME 字符串 为代表该运行时的基础架构实体设置自定义标签 [1]
INSTANA_DEBUG 任何值 启用调试日志。 仅在有限的时间内使用，以避免开销和垃圾日志。
INSTANA_DISABLE_USE_OPENTELEMETRY true 或 false 将此变量设为 true 可禁用开放式遥测集成。 缺省值为 false。
INSTANA_STACK_TRACE_LENGTH 整数 设置此变量可限制跨度内捕获的堆栈跟踪帧数。

有关 Java、Scala、.NET、.NET Core 或 PHP 的信息，请参阅相应的文档页面。

表 7：语言传感器支持的环境变量
语言 Crystal 执行 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_LENGTH ❌ ❌ ❌ ❌ ✅ ✅ ❌ ❌ ❌

  1. 如果在任何警报规则中使用了默认实体名称（例如系统规则 > 主机 ，但没有在其上运行的匹配实体），则使用此功能更改实体名称会触发这些警报。 ︎