使用Python配置OpenTelemetry时无法设置RoleName和RoleInstance

核心问题定位 #

Azure Monitor里的Cloud Role Name对应OpenTelemetry的service.name，Cloud Role Instance对应service.instance.id，但日志模块的资源属性需要和日志提供者（LoggerProvider）绑定，仅靠环境变量或Span属性无法直接生效：

• 环境变量需要在OpenTelemetry组件初始化前设置，否则不会被读取
• Span属性属于追踪链路范畴，不会同步到日志的资源元数据中

可行解决方案 #

方案1：确保环境变量在OTel初始化前设置

如果坚持用环境变量，必须在导入任何OpenTelemetry模块之前设置：

import os

# 必须放在所有OTel导入之前
os.environ["OTEL_RESOURCE_ATTRIBUTES"] = "service.name=my-service,service.instance.id=my-instance,service.namespace=my-namespace"
os.environ["OTEL_SERVICE_NAME"] = "my-service"

# 之后再导入并初始化OTel日志组件
from opentelemetry.sdk._logs import LoggerProvider
from opentelemetry.exporter.azure.monitor import AzureMonitorLogExporter
from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
import logging

logger_provider = LoggerProvider()
exporter = AzureMonitorLogExporter(connection_string="YOUR_CONNECTION_STRING")
logger_provider.add_log_record_processor(BatchLogRecordProcessor(exporter))

handler = logging.handlers.OpenTelemetryHandler(logger_provider=logger_provider)
logging.getLogger().addHandler(handler)

方案2：显式创建资源并绑定到日志提供者（推荐）

这种方式更可控，避免环境变量的时机问题：

from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk._logs import LoggerProvider
from opentelemetry.exporter.azure.monitor import AzureMonitorLogExporter
from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
import logging

# 定义包含角色属性的资源
resource = Resource(
    attributes={
        "service.name": "my-service",       # 映射到Cloud Role Name
        "service.instance.id": "my-instance", # 映射到Cloud Role Instance
        "service.namespace": "my-namespace"
    }
)

# 创建日志提供者并关联资源
logger_provider = LoggerProvider(resource=resource)
exporter = AzureMonitorLogExporter(connection_string="YOUR_CONNECTION_STRING")
logger_provider.add_log_record_processor(BatchLogRecordProcessor(exporter))

# 配置日志处理器并添加到根日志
handler = logging.handlers.OpenTelemetryHandler(logger_provider=logger_provider)
logging.getLogger().addHandler(handler)

# 测试日志输出
logging.info("This log will have the correct role attributes in Azure Monitor")

验证方法 #

在Azure Monitor的日志查询中，使用以下语句验证是否生效：

AppLogs
| where CloudRoleName == "my-service" and CloudRoleInstance == "my-instance"

内容的提问来源于stack exchange，提问作者Naga