Skip to main content

JavaScript 配置说明

SDK 和导出器配置

SDK 配置

导出器配置

SDK 资源探测器配置

默认情况下,该模块将启用所有的 SDK 资源探测器。您可以使用 OTEL_NODE_RESOURCE_DETECTORS 环境变量来仅启用某些资源探测器,也可以完全禁用所有资源探测器。

资源探测器描述
env从环境变量中探测资源
host从主机资源中探测资源
os从操作系统资源中探测资源
process从进程资源中探测资源
serviceinstance从服务实例资源中探测资源
container从容器资源中探测资源
alibaba从 Alibaba 资源中探测资源
aws从 AWS 资源中探测资源
azure从 Azure 资源中探测资源
gcp从 GCP 资源中探测资源
all从所有资源中探测资源
none不从任何资源中探测资源

例如,仅启用 envhost 资源探测器:

OTEL_NODE_RESOURCE_DETECTORS=env,host

排除插桩库

默认情况下,所有受支持的插桩库都是启用的。您可以使用环境变量来启用或禁用某些插桩。

启用特定的插桩

您可以使用环境变量 OTEL_NODE_ENABLED_INSTRUMENTATIONS 来启用特定的插桩。这个环境变量允许您通过逗号分隔的列表来指定需要启用的插桩名称,但需要注意的是,这些名称不应包含 @opentelemetry/instrumentation- 前缀。

例如,仅启用 @opentelemetry/instrumentation-http@opentelemetry/instrumentation-express 插桩:

OTEL_NODE_ENABLED_INSTRUMENTATIONS="http,express"

禁用特定的插桩

您可以使用环境变量 OTEL_NODE_DISABLED_INSTRUMENTATIONS 来禁用特定的插桩。这个环境变量允许您通过逗号分隔的列表来指定需要禁用的插桩名称,但需要注意的是,这些名称不应包含 @opentelemetry/instrumentation- 前缀。

例如,仅禁用 @opentelemetry/Instrumentation-fs@opentelemetry/instrumentation-grpc 插桩:

OTEL_NODE_DISABLED_INSTRUMENTATIONS="fs,grpc"
注意

如果同时设置了两个环境变量,则首先应用 OTEL_NODE_ENABLED_INSTRUMENTATIONS,其次应用 OTEL_NODE_DISABLED_INSTRUMENTATIONS。 所以如果两个列表中都包含相同的插桩,则该插桩会被禁用。