JavaScript 配置说明
SDK 和导出器配置
SDK 资源探测器配置
默认情况下,该模块将启用所有的 SDK 资源探测器。您可以使用 OTEL_NODE_RESOURCE_DETECTORS
环境变量来仅启用某些资源探测器,也可以完全禁用所有资源探测器。
资源探测器 | 描述 |
---|---|
env | 从环境变量中探测资源 |
host | 从主机资源中探测资源 |
os | 从操作系统资源中探测资源 |
process | 从进程资源中探测资源 |
serviceinstance | 从服务实例资源中探测资源 |
container | 从容器资源中探测资源 |
alibaba | 从 Alibaba 资源中探测资源 |
aws | 从 AWS 资源中探测资源 |
azure | 从 Azure 资源中探测资源 |
gcp | 从 GCP 资源中探测资源 |
all | 从所有资源中探测资源 |
none | 不从任何资源中探测资源 |
例如,仅启用 env
和 host
资源探测器:
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
。
所以如果两个列表中都包含相同的插桩,则该插桩会被禁用。