Azure / Azure/azure-functions-python-worker

[Bug] context.thread_local_storage.invocation_id does not correlate thread logs in Application Insights on Python 3.13

未关闭
#1,860 0 条评论 1 个 reaction 已指派 0 人 在 GitHub 查看
bug python
主要语言
Python
星标
357
派生
116
平均合并
32 分钟
30 天内合并 PR
1

描述

### Expected Behavior

According to the docs, setting context.thread_local_storage.invocation_id
inside a background thread enables log correlation for that thread:
https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-python#log-custom-telemetry

After calling:
context.thread_local_storage.invocation_id = context.invocation_id

...all logging.info() calls from that thread should appear in Application
Insights correlated to the function invocation (same InvocationId).

### Actual Behavior

On Python 3.13, [THREAD] logs are completely absent from Application Insights.
[MAIN] logs appear correctly. The identical code works on Python 3.12.

Python 3.12 ✅
"Logging from main handler" → appears, InvocationId=37b57bfd-...
"Logging from a background thread" → appears, InvocationId=37b57bfd-...

Python 3.13 ❌
"Logging from main handler" → appears, InvocationId=48b27079-...
"Logging from a background thread" → ABSENT from App Insights entirely

### Steps to Reproduce

1. Deploy Azure Function App with Python 3.13, Azure Functions Runtime v4, Dedicated plan
2. Use the code below (async HTTP trigger + asyncio.to_thread)
3. Trigger the function via HTTP
4. Check Application Insights traces — background thread log is missing
5. Redeploy the same code with Python 3.12 — background thread log appears correctly

### Relevant code being tried

```shell
import azure.functions as func
import logging
import asyncio

app = func.FunctionApp(http_auth_level=func.AuthLevel.ANONYMOUS)

def work(context: func.Context):
context.thread_local_storage.invocation_id = context.invocation_id
logging.info("Logging from a background thread")

@app.route(route="test")
async def test_async(req: func.HttpRequest, context: func.Context) -> func.HttpResponse:
await asyncio.to_thread(work, context)
logging.info("Logging from main handler")
return func.HttpResponse("ok")
```

### Relevant log output

```shell

```

### requirements.txt file

```shell
azure-functions
```

### Where are you facing this problem?

Production Environment (explain below)

### Function app name

_No response_

### Additional Information

Root cause: azure-functions-runtime (used on Python 3.13) has its own separate
threading.local object for log routing. context.thread_local_storage points to
azure-functions-worker's threading.local — a different object that the new
runtime's logging proxy never reads.

Workaround (confirmed working on Python 3.13):

from azure_functions_runtime.utils.executor import invocation_id_cv

def work():
logging.info("Logging from a background thread")

@app.route(route="test")
async def test_async(req, context):
invocation_id_cv.set(context.invocation_id) # copied by asyncio.to_thread
await asyncio.to_thread(work)

asyncio.to_thread copies ContextVars automatically, so the proxy finds the
invocation_id correctly.

Note: invocation_id_cv is an internal API — a public API for this use case
would be appreciated.

贡献指南

打开贡献指南

调研方向

首先,在 Python 3.12 和 3.13 上使用 asyncio.to_thread 复现 async HTTP 触发器,然后检查 azure_functions_runtime.utils.executor 中的 invocation_id_cv workaround,以及 context.thread_local_storage.invocation_id 的使用方式。当后台线程日志在 Python 3.13 上通过受支持的 API 以相同的 InvocationId 出现在 Application Insights 中时,即表示完成。

由索引模型根据 Issue 内容生成。

评估

技术栈
azure, python
领域
backend, observability-sre
Issue 类型
缺陷
难度
4/5
预计耗时
3-5 天
活跃度
冷清
描述清晰度
基本清楚
新手友好度
45/100

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。