aury-boot 0.0.29__py3-none-any.whl → 0.0.31__py3-none-any.whl

aury/boot/infrastructure/monitoring/tracing/tracing.py

@@ -0,0 +1,235 @@
+"""便捷的链路追踪 API。
+
+提供简洁的 span 创建方式，用于手动追踪自定义业务逻辑。
+
+用法:
+    # 上下文管理器方式（kind 可自定义，如 "llm"、"tool" 等）
+    with span("llm.chat", kind="llm", model="gpt-4") as s:
+        response = await call_openai()
+        s.set_attribute("tokens", response.usage.total_tokens)
+    
+    # 装饰器方式
+    @trace_span("tool.search", kind="tool")
+    async def search(query: str):
+        ...
+"""
+
+from __future__ import annotations
+
+import asyncio
+from collections.abc import Callable
+from contextlib import contextmanager
+from functools import wraps
+from typing import TYPE_CHECKING, Any
+
+# OTel 可选依赖
+try:
+    from opentelemetry import trace as otel_trace
+    from opentelemetry.trace import SpanKind as OTelSpanKind
+    from opentelemetry.trace import StatusCode
+except ImportError:
+    otel_trace = None  # type: ignore[assignment]
+    OTelSpanKind = None  # type: ignore[assignment, misc]
+    StatusCode = None  # type: ignore[assignment, misc]
+
+if TYPE_CHECKING:
+    from opentelemetry.trace import Span
+
+
+class SpanKind:
+    """OTel 标准 Span 类型常量。
+    
+    开发者也可传入任意字符串作为 kind（如 "llm"、"tool"），
+    会作为属性记录，并默认映射为 INTERNAL。
+    """
+    
+    INTERNAL = "internal"   # 内部操作
+    CLIENT = "client"       # 外部调用（HTTP client、DB）
+    SERVER = "server"       # 处理请求
+    PRODUCER = "producer"   # 消息生产者
+    CONSUMER = "consumer"   # 消息消费者
+
+
+def _get_tracer():
+    """获取 tracer 实例。"""
+    if otel_trace is None:
+        return None
+    return otel_trace.get_tracer("aury")
+
+
+def _to_otel_span_kind(kind: str):
+    """转换为 OTel SpanKind。
+    
+    标准类型（internal/client/server/producer/consumer）映射到对应的 OTel SpanKind，
+    其他自定义类型（如 llm/tool 等）默认映射为 INTERNAL。
+    """
+    if OTelSpanKind is None:
+        return None
+    
+    mapping = {
+        "internal": OTelSpanKind.INTERNAL,
+        "client": OTelSpanKind.CLIENT,
+        "server": OTelSpanKind.SERVER,
+        "producer": OTelSpanKind.PRODUCER,
+        "consumer": OTelSpanKind.CONSUMER,
+    }
+    return mapping.get(kind, OTelSpanKind.INTERNAL)
+
+
+@contextmanager
+def span(
+    name: str,
+    kind: str = "internal",
+    **attributes: Any,
+):
+    """创建追踪 span（上下文管理器）。
+    
+    Args:
+        name: span 名称，建议格式 "{category}.{operation}"
+        kind: span 类型，可自由定义（如 "llm"、"tool"、"task" 等），
+              标准类型（internal/client/server）会映射到 OTel SpanKind
+        **attributes: 附加属性
+    
+    Yields:
+        Span: OTel span 对象，可调用 set_attribute() 添加更多属性
+    
+    用法:
+        # 追踪 LLM 调用
+        with span("llm.chat", kind="llm", model="gpt-4") as s:
+            response = await openai.chat.completions.create(...)
+            s.set_attribute("llm.tokens", response.usage.total_tokens)
+        
+        # 追踪工具调用
+        with span("tool.web_search", kind="tool", query=query):
+            result = await search(query)
+        
+        # 追踪自定义业务
+        with span("payment.process", order_id=order_id):
+            await process_payment(order_id)
+    """
+    tracer = _get_tracer()
+    
+    if tracer is None:
+        # OTel 未安装，使用空上下文
+        yield _DummySpan()
+        return
+    
+    otel_kind = _to_otel_span_kind(kind)
+    
+    with tracer.start_as_current_span(name, kind=otel_kind) as s:
+        # 设置自定义类型标识（用于 AlertingSpanProcessor 识别）
+        s.set_attribute("aury.span_kind", kind)
+        
+        # 设置用户传入的属性
+        for key, value in attributes.items():
+            if value is not None:
+                s.set_attribute(key, _safe_attribute_value(value))
+        
+        yield s
+
+
+def trace_span(
+    name: str | None = None,
+    kind: str = "internal",
+    **attributes: Any,
+) -> Callable:
+    """追踪装饰器。
+    
+    Args:
+        name: span 名称，默认使用函数名
+        kind: span 类型，可自由定义
+        **attributes: 附加属性
+    
+    用法:
+        @trace_span(kind="llm", model="gpt-4")
+        async def chat(prompt: str):
+            return await openai.chat.completions.create(...)
+        
+        @trace_span("custom.operation")
+        def sync_operation():
+            ...
+    """
+    def decorator(func: Callable) -> Callable:
+        span_name = name or f"{func.__module__}.{func.__qualname__}"
+        
+        @wraps(func)
+        async def async_wrapper(*args, **kwargs):
+            with span(span_name, kind=kind, **attributes):
+                return await func(*args, **kwargs)
+        
+        @wraps(func)
+        def sync_wrapper(*args, **kwargs):
+            with span(span_name, kind=kind, **attributes):
+                return func(*args, **kwargs)
+        
+        # 根据函数类型返回对应包装器
+        if asyncio.iscoroutinefunction(func):
+            return async_wrapper
+        return sync_wrapper
+    
+    return decorator
+
+
+def set_span_error(error: Exception, message: str | None = None) -> None:
+    """在当前 span 上记录错误。
+    
+    Args:
+        error: 异常对象
+        message: 错误消息（可选）
+    """
+    if otel_trace is None or StatusCode is None:
+        return
+    
+    current_span = otel_trace.get_current_span()
+    if current_span and current_span.is_recording():
+        current_span.set_status(StatusCode.ERROR, message or str(error))
+        current_span.record_exception(error)
+
+
+def set_span_attribute(key: str, value: Any) -> None:
+    """在当前 span 上设置属性。
+    
+    Args:
+        key: 属性名
+        value: 属性值
+    """
+    if otel_trace is None:
+        return
+    
+    current_span = otel_trace.get_current_span()
+    if current_span and current_span.is_recording():
+        current_span.set_attribute(key, _safe_attribute_value(value))
+
+
+def _safe_attribute_value(value: Any) -> Any:
+    """转换属性值为 OTel 支持的类型。"""
+    if isinstance(value, str | int | float | bool):
+        return value
+    if isinstance(value, list | tuple):
+        return [_safe_attribute_value(v) for v in value]
+    return str(value)
+
+
+class _DummySpan:
+    """占位 span，用于 OTel 未安装时。"""
+    
+    def set_attribute(self, key: str, value: Any) -> None:
+        pass
+    
+    def set_status(self, status, description: str | None = None) -> None:
+        pass
+    
+    def record_exception(self, exception: Exception) -> None:
+        pass
+    
+    def add_event(self, name: str, attributes: dict | None = None) -> None:
+        pass
+
+
+__all__ = [
+    "SpanKind",
+    "set_span_attribute",
+    "set_span_error",
+    "span",
+    "trace_span",
+]

{aury_boot-0.0.29.dist-info → aury_boot-0.0.31.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.29
+Version: 0.0.31
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2
@@ -42,6 +42,14 @@ Requires-Dist: mkdocs-material>=9.7.0; extra == 'docs'
 Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
 Provides-Extra: mysql
 Requires-Dist: aiomysql>=0.3.2; extra == 'mysql'
+Provides-Extra: otel
+Requires-Dist: opentelemetry-api>=1.25.0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.46b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.46b0; extra == 'otel'
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.46b0; extra == 'otel'
+Requires-Dist: opentelemetry-sdk>=1.25.0; extra == 'otel'
+Provides-Extra: otel-exporter
+Requires-Dist: opentelemetry-exporter-otlp>=1.25.0; extra == 'otel-exporter'
 Provides-Extra: postgres
 Requires-Dist: asyncpg>=0.31.0; extra == 'postgres'
 Provides-Extra: rabbitmq
@@ -52,6 +60,11 @@ Requires-Dist: apscheduler>=3.11.1; extra == 'recommended'
 Requires-Dist: asyncpg>=0.31.0; extra == 'recommended'
 Requires-Dist: aury-sdk-storage[aws]>=0.0.1; extra == 'recommended'
 Requires-Dist: dramatiq>=1.18.0; extra == 'recommended'
+Requires-Dist: opentelemetry-api>=1.25.0; extra == 'recommended'
+Requires-Dist: opentelemetry-instrumentation-fastapi>=0.46b0; extra == 'recommended'
+Requires-Dist: opentelemetry-instrumentation-httpx>=0.46b0; extra == 'recommended'
+Requires-Dist: opentelemetry-instrumentation-sqlalchemy>=0.46b0; extra == 'recommended'
+Requires-Dist: opentelemetry-sdk>=1.25.0; extra == 'recommended'
 Requires-Dist: redis>=7.1.0; extra == 'recommended'
 Provides-Extra: redis
 Requires-Dist: redis>=7.1.0; extra == 'redis'

{aury_boot-0.0.29.dist-info → aury_boot-0.0.31.dist-info}/RECORD

@@ -1,6 +1,6 @@
 aury/boot/__init__.py,sha256=pCno-EInnpIBa1OtxNYF-JWf9j95Cd2h6vmu0xqa_-4,1791
-aury/boot/_version.py,sha256=p4kcB0BmpcnphBIseH7188jNCCOqFZSly7Pka9LrUDM,706
-aury/boot/application/__init__.py,sha256=0o_XmiwFCeAu06VHggS8I1e7_nSMoRq0Hcm0fYfCywU,3071
+aury/boot/_version.py,sha256=nmSHmaFWTuD8SY4lecbyWq4JEPaihzn-zXy2K9lJGYo,706
+aury/boot/application/__init__.py,sha256=I2KqNVdYg2q5nlOXr0TtFGyHmhj4oWdaR6ZB73Mwg7Y,3041
 aury/boot/application/adapter/__init__.py,sha256=e1bcSb1bxUMfofTwiCuHBZJk5-STkMCWPF2EJXHQ7UU,3976
 aury/boot/application/adapter/base.py,sha256=Ar_66fiHPDEmV-1DKnqXKwc53p3pozG31bgTJTEUriY,15763
 aury/boot/application/adapter/config.py,sha256=X6ppQMldyJbEdG1GcQSc2SulLtyeBTr8OAboYIjkSu0,8153
@@ -8,15 +8,15 @@ aury/boot/application/adapter/decorators.py,sha256=yyGu_16bWWUiO36gxCeQWgG0DN19p
 aury/boot/application/adapter/exceptions.py,sha256=Kzm-ytRxdUnSMIcWCSOHPxo4Jh_A6YbyxlOVIUs-5F4,6183
 aury/boot/application/adapter/http.py,sha256=4TADsSzdSRU63307dmmo-2U_JpVP12mwTFy66B5Ps-w,10759
 aury/boot/application/app/__init__.py,sha256=I8FfCKDuDQsGzAK6BevyfdtAwieMUVYu6qgVQzBazpE,830
-aury/boot/application/app/base.py,sha256=MYfkrb2zZgumLrGWhtT71neGncUfVHyUeAHRnetoSXk,17668
-aury/boot/application/app/components.py,sha256=qBAd8hJ4Ap3cfCYJUJu9v_IvC16U9Q8O5dEZDtjDveY,24188
+aury/boot/application/app/base.py,sha256=7n7uFAVmIylr9YZannWKeQSOLSifNosIJUMbL-nmJe4,21897
+aury/boot/application/app/components.py,sha256=Ub7NlfxSPXSDcxUajQ5ed42kNmsBSol-UttcBfnx64Y,33473
 aury/boot/application/app/middlewares.py,sha256=BXe2H14FHzJUVpQM6DZUm-zfZRXSXIi1QIZ4_3izfHw,3306
 aury/boot/application/app/startup.py,sha256=DHKt3C2G7V5XfFr1SQMl14tNzcuDd9MqUVAxi274HDQ,7873
 aury/boot/application/config/__init__.py,sha256=Dd-myRSBCM18DXXsi863h0cJG5VFrI10xMRtjnvelGo,1894
 aury/boot/application/config/multi_instance.py,sha256=RXSp-xP8-bKMDEhq3SeL7T3lS8-vpRlvBEVBuZVjVK4,6475
-aury/boot/application/config/settings.py,sha256=-afn5p9rIS4_63OLqfG-mrTl2UergOZb6z8I5GyYOAY,31621
+aury/boot/application/config/settings.py,sha256=MPOjUyPxvWOrw878FOs0gnUPkqSUMyLpQ-MZz9yMwls,37866
 aury/boot/application/constants/__init__.py,sha256=DCXs13_VVaQWHqO-qpJoZwRd7HIexiirtw_nu8msTXE,340
-aury/boot/application/constants/components.py,sha256=VBCgxJ_iZXjEZyUkC13ZCdqPmdKq-lQmU7jQpXnTa2Y,1056
+aury/boot/application/constants/components.py,sha256=I4SlsF2DpSzMiLsi1wVrEmdHn4yV5J2h3ikMQqufPmM,1120
 aury/boot/application/constants/scheduler.py,sha256=S77FBIvHlyruvlabRWZJ2J1YAs2xWXPQI2yuGdGUDNA,471
 aury/boot/application/constants/service.py,sha256=_BjSNP83m1KuLcGs1oqciDU9Nk1mO45COucRYubuFkM,513
 aury/boot/application/errors/__init__.py,sha256=aYhGqjHayYr7sv9kM22y0sOo9R-8RK0r3Jf5_tgm7TQ,1217
@@ -29,7 +29,7 @@ aury/boot/application/interfaces/__init__.py,sha256=EGbiCL8IoGseylLVZO29Lkt3luyg
 aury/boot/application/interfaces/egress.py,sha256=t8FK17V649rsm65uAeBruYr2mhfcqJiIzkS8UPsOzlc,5346
 aury/boot/application/interfaces/ingress.py,sha256=rlflJ4nxAZ2Mc3Iy8ZX__GRgfAWcMYYzLhHL2NSk4_U,2425
 aury/boot/application/middleware/__init__.py,sha256=T01fmbcdO0Sm6JE74g23uuDyebBGYA4DMZMDBl0L00w,258
-aury/boot/application/middleware/logging.py,sha256=d3wbprbCxFJ6TpeEDomTSnjQ7sIadYxXnnKS6b_Wj38,11899
+aury/boot/application/middleware/logging.py,sha256=kStfLskA_srNvWIuNMs0ptZ4Wr9-ke6hYl8kESxbhxc,13509
 aury/boot/application/migrations/__init__.py,sha256=Z5Gizx7f3AImRcl3cooiIDAZcNi5W-6GvB7mK5w1TNA,204
 aury/boot/application/migrations/manager.py,sha256=G7mzkNA3MFjyQmM2UwY0ZFNgGGVS4W5GoG2Sbj5AUXk,23685
 aury/boot/application/migrations/setup.py,sha256=cxzBIHGzRXhlIYs4_ZW6P85Z9A7uVnTq_dmQFKp3ha4,6485
@@ -45,9 +45,9 @@ aury/boot/commands/add.py,sha256=JRJir92oFHwIBtIKKEjQ7trUhfb9-kCH84x_7saV2gI,264
 aury/boot/commands/app.py,sha256=k0zHzR3ckt17laAYk6WwwS-lqzS-N8811XjKC-7lerg,7857
 aury/boot/commands/config.py,sha256=gPkG_jSWrXidjpyVdzABH7uRhoCgX5yrOcdKabtX5wY,4928
 aury/boot/commands/docker.py,sha256=7mKorZCPZgxH1XFslzo6W-uzpe61hGXz86JKOhOeBlo,9006
-aury/boot/commands/docs.py,sha256=7VaZyEuezmL28aM9y13ni-y-VYP-eNKff5-qb-9q1RQ,13066
+aury/boot/commands/docs.py,sha256=Hz1W-2TW8DzaPxARqEF4UncPhGMI9h97jJ962dlox3U,14327
 aury/boot/commands/generate.py,sha256=WZieSXuofxJOC7NBiVGpBigB9NZ4GMcF2F1ReTNun1I,44420
-aury/boot/commands/init.py,sha256=vHg2Zhdoar1ANug9J8pT1tNGdH5S0GO19Rhsy-04mXQ,32262
+aury/boot/commands/init.py,sha256=W_eCL3wydWaMSLqTpadREDnzC0w-LGgNnj3IBjuQAfA,32348
 aury/boot/commands/pkg.py,sha256=bw0QPptKscNgQ4I1SfSehTio9Q5KrvxgvkYx4tbZ7Vs,14495
 aury/boot/commands/scheduler.py,sha256=BCIGQcGryXpsYNF-mncP6v5kNoz6DZ10DMzMKVDiXxA,3516
 aury/boot/commands/worker.py,sha256=qAcPdoKpMBLYoi45X_y2-nobuYKxscJpooEB_0HhM4o,4163
@@ -61,14 +61,15 @@ aury/boot/commands/templates/generate/model.py.tpl,sha256=knFwMyGZ7wMpzH4_bQD_V1
 aury/boot/commands/templates/generate/repository.py.tpl,sha256=xoEg6lPAaLIRDeFy4I0FBsPPVLSy91h6xosAlaCL_mM,590
 aury/boot/commands/templates/generate/schema.py.tpl,sha256=HIaY5B0UG_S188nQLrZDEJ0q73WPdb7BmCdc0tseZA4,545
 aury/boot/commands/templates/generate/service.py.tpl,sha256=2hwQ8e4a5d_bIMx_jGDobdmKPMFLBlfQrQVQH4Ym5k4,1842
-aury/boot/commands/templates/project/AGENTS.md.tpl,sha256=SpqoXZXCyWmitBV6Mt0VvXWdPZAZXsLoU-vDEyJyQDc,8269
+aury/boot/commands/templates/project/AGENTS.md.tpl,sha256=sp5qyzU-SGhgQCobpMW4EXRzpGsEsVdmJvspnKAP4AQ,10059
 aury/boot/commands/templates/project/README.md.tpl,sha256=oCeBiukk6Pa3hrCKybkfM2sIRHsPZ15nlwuFTUSFDwY,2459
 aury/boot/commands/templates/project/admin_console_init.py.tpl,sha256=K81L14thyEhRA8lFCQJVZL_NU22-sBz0xS68MJPeoCo,1541
+aury/boot/commands/templates/project/alert_rules.example.yaml.tpl,sha256=QZH6SC5TcUhgX_2JRXk0k0g26wJf9xNwsdquiEIgg-I,2492
 aury/boot/commands/templates/project/config.py.tpl,sha256=H_B05FypBJxTjb7qIL91zC1C9e37Pk7C9gO0-b3CqNs,1009
 aury/boot/commands/templates/project/conftest.py.tpl,sha256=chbETK81Hy26cWz6YZ2cFgy7HbnABzYCqeyMzgpa3eI,726
 aury/boot/commands/templates/project/gitignore.tpl,sha256=OI0nt9u2E9EC-jAMoh3gpqamsWo18uDgyPybgee_snQ,3053
 aury/boot/commands/templates/project/main.py.tpl,sha256=Q61ve3o1VkNPv8wcQK7lUosne18JWYeItxoXVNNoYJM,1070
-aury/boot/commands/templates/project/aury_docs/00-overview.md.tpl,sha256=8Aept3yEAe9cVdRvkddr_oEF-lr2riPXYRzBuw_6DBA,2138
+aury/boot/commands/templates/project/aury_docs/00-overview.md.tpl,sha256=eOjtqMeKqZ8OgijrOwcpfpHhrhUvt_CiHPUtRG0dilA,2251
 aury/boot/commands/templates/project/aury_docs/01-model.md.tpl,sha256=1mQ3hGDxqEZjev4CD5-3dzYRFVonPNcAaStI1UBEUyM,6811
 aury/boot/commands/templates/project/aury_docs/02-repository.md.tpl,sha256=JfUVdrIgW7_J6JGCcB-_uP_x-gCtjKiewwGv4Xr44QI,7803
 aury/boot/commands/templates/project/aury_docs/03-service.md.tpl,sha256=SgfPAgLVi_RbMjSAe-m49jQOIr6vfUT8VF2V1E-qa3w,15098
@@ -85,13 +86,15 @@ aury/boot/commands/templates/project/aury_docs/13-channel.md.tpl,sha256=aGpf2phQ
 aury/boot/commands/templates/project/aury_docs/14-mq.md.tpl,sha256=4bxLQBbCi0Fue0VQWOPt6acZ5P00BoLkCoLPQe_8k4U,2396
 aury/boot/commands/templates/project/aury_docs/15-events.md.tpl,sha256=a4wQRgVPuYUGTGmw_lX1HJH_yFTbD30mBz7Arc4zgfs,3361
 aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl,sha256=pkmJkZw2Ca6_uYk2jZvAb8DozjBa2tWq_t3gtq1lFSk,11456
+aury/boot/commands/templates/project/aury_docs/17-alerting.md.tpl,sha256=2MosApSAuGerBw7SOO-ihk4NTp2qEkgOUyu6pS2m0UY,5709
 aury/boot/commands/templates/project/aury_docs/99-cli.md.tpl,sha256=9JSdiAbu3SGmmF_iCslw5LBPlks2DYf4WYw05pA_2_I,5673
 aury/boot/commands/templates/project/env_templates/_header.tpl,sha256=Pt0X_I25o1th3CLR228L2-nlcC-lIkN8cPailohBEkU,513
 aury/boot/commands/templates/project/env_templates/admin.tpl,sha256=wWt3iybOpBHtuw6CkoUJ1bzEL0aNgOzKDEkMKhI2oag,2032
 aury/boot/commands/templates/project/env_templates/cache.tpl,sha256=_sK-p_FECj4mVvggNvgb4Wu0yGii0Ocz560syG7DU2c,498
 aury/boot/commands/templates/project/env_templates/database.tpl,sha256=2lWzTKt4X0SpeBBCkrDV90Di4EfoAuqYzhVsh74vTUI,907
 aury/boot/commands/templates/project/env_templates/log.tpl,sha256=x5rkrEFJISH0gaCcr-wTCbDYtyFnlLNJpY789fqjZgc,754
-aury/boot/commands/templates/project/env_templates/messaging.tpl,sha256=ZaNBM4pq0pgkTXbCBx_sgjm8QKEBfW1nSnsKZfHu-HM,1771
+aury/boot/commands/templates/project/env_templates/messaging.tpl,sha256=SzPRKwN0wO5e1kpjkSwpPJfVmiUDzZkK4Qm-qNsCvVE,2178
+aury/boot/commands/templates/project/env_templates/monitoring.tpl,sha256=Zq0xQzDrCRtbeLCQB3pkEE2p8FFED6IjQo4TqMyd_P8,2584
 aury/boot/commands/templates/project/env_templates/rpc.tpl,sha256=FhweCFakawGLSs01a_BkmZo11UhWax2-VCBudHj68WA,1163
 aury/boot/commands/templates/project/env_templates/scheduler.tpl,sha256=c8Grcs1rgBB58RHlxqmDMPHQl8BnbcqNW473ctmsojU,752
 aury/boot/commands/templates/project/env_templates/service.tpl,sha256=b-a2GyRyoaunbDj_2kaSw3OFxcugscmPvUBG7w0XO8c,710
@@ -106,9 +109,9 @@ aury/boot/common/exceptions/__init__.py,sha256=aS3rIXWc5qNNJbfMs_PNmBlFsyNdKUMEr
 aury/boot/common/i18n/__init__.py,sha256=2cy4kteU-1YsAHkuMDTr2c5o4G33fvtYUGKtzEy1Q6c,394
 aury/boot/common/i18n/translator.py,sha256=_vEDL2SjEI1vwMNHbnJb0xErKUPLm7VmhyOuMBeCqRM,8412
 aury/boot/common/logging/__init__.py,sha256=Z6pMdjXZMWXz6w-1ev0h6QN3G3c8Cz7EpOqZh42kgQ0,1612
-aury/boot/common/logging/context.py,sha256=U78XwjVcDP7Y96VTGclCcP09p0ZWCmiEYzVhp1Obytw,2058
+aury/boot/common/logging/context.py,sha256=ndml3rUokEIt5-845E5aW8jI8b4N93ZtukyqsjqzuNE,2566
 aury/boot/common/logging/decorators.py,sha256=UaGMhRJdARNJ2VgCuRwaNX0DD5wIc1gAl6NDj7u8K2c,3354
-aury/boot/common/logging/format.py,sha256=V1VoZCPFAaAXy20n3WehOsZGTHuboYMHnSFGa0GxhdU,9648
+aury/boot/common/logging/format.py,sha256=ZEqLagTdyGadywTamybcEh1fAZng3Wfx7DC952TFU30,9782
 aury/boot/common/logging/setup.py,sha256=ZPxOHJD8Fw4KxKPgsf8ZHQ2mWuXxKh4EJtXXvGY7Hgo,9422
 aury/boot/contrib/__init__.py,sha256=fyk_St9VufIx64hsobv9EsOYzb_T5FbJHxjqtPds4g8,198
 aury/boot/contrib/admin_console/__init__.py,sha256=HEesLFrtYtBFWTDrh5H3mR-4V4LRg5N4a2a1C4-Whgs,445
@@ -131,19 +134,18 @@ aury/boot/domain/repository/query_builder.py,sha256=pFErMzsBql-T6gBX0S4FxIheCkNa
 aury/boot/domain/service/__init__.py,sha256=ZRotaBlqJXn7ebPTQjjoHtorpQREk8AgTD69UCcRd1k,118
 aury/boot/domain/service/base.py,sha256=6sN0nf8r5yUZsE6AcZOiOXFCqzb61oCxTfrWlqjIo9I,2035
 aury/boot/domain/transaction/__init__.py,sha256=EKnjJ235SYjMCvGIuLVlTdYRzU35RxNMejRGUExYqqE,15488
-aury/boot/infrastructure/__init__.py,sha256=ppP1-suaDICMNvBSXj_4DVSH3h0D8e0qZhtENCr16m8,3007
+aury/boot/infrastructure/__init__.py,sha256=DDEr_BIL5OyMJjNlI05jGIUrSHn6MPdnW9xnCS4eHfg,2949
 aury/boot/infrastructure/cache/__init__.py,sha256=G40uCkpJ1jSs2fc_CBDem73iQQzCcp-4GG1WpDJzwaA,658
 aury/boot/infrastructure/cache/backends.py,sha256=9QMQ8G9DtZgzVXZ_Ng7n1gXRu-_OQZgw4FHPOfr1qco,13585
 aury/boot/infrastructure/cache/base.py,sha256=Yn-h_SGcOoGGZW1unOnz_zgcuHaMKOEmwiUP0P7_pIM,1624
 aury/boot/infrastructure/cache/exceptions.py,sha256=KZsFIHXW3_kOh_KB93EVZJKbiDvDw8aloAefJ3kasP8,622
 aury/boot/infrastructure/cache/factory.py,sha256=aF74JoiiSKFgctqqh2Z8OtGRS2Am_ou-I40GyygLzC0,2489
 aury/boot/infrastructure/cache/manager.py,sha256=GGoOgYyIdWKMmhej5cRvEfpNeMN1GaSaU9hc0dy8_sA,12106
-aury/boot/infrastructure/channel/__init__.py,sha256=Ztcfn1-TomgV91qhePpFK-3_nKgBt862yEFYUzIwPlo,566
-aury/boot/infrastructure/channel/base.py,sha256=kRjvoOQ0X5ilUAdz03BNBfbZJgdqcsjUviK4_dJatBs,2642
-aury/boot/infrastructure/channel/manager.py,sha256=wOkO018Ch2694z9vOGgojaGOdCXHi0zrekkfLezn8bo,7444
-aury/boot/infrastructure/channel/backends/__init__.py,sha256=zrOhrzkhEIgsO7Armhgda1ruJQ6a9ZK7GPZuzvEiuN8,151
-aury/boot/infrastructure/channel/backends/memory.py,sha256=QQyZxIdYtA_pWqdKgUIMkvnbBwvv45-vX-qostDHyfg,4699
-aury/boot/infrastructure/channel/backends/redis.py,sha256=_UL7wE-bO147CPXKDjJgYGjj09Lg9x9U2PLYa37q5yQ,4666
+aury/boot/infrastructure/channel/__init__.py,sha256=NmjddenZPz1Dcl0glwIF1Xn9gxBzvGvlOlzhV3eEnEQ,664
+aury/boot/infrastructure/channel/base.py,sha256=TDiP7pXyd2ixiOM3cbxqCSOluGLTkmLCa8pv-KyQ0jo,2941
+aury/boot/infrastructure/channel/manager.py,sha256=GT6eG6PglduKAr23i1PSmjjTQsALvGGoLjYiQ33aZiw,7488
+aury/boot/infrastructure/channel/backends/__init__.py,sha256=NcXG8_KAqy1SiGUs2z_KvkS90jMfLJ6bzyYK4Jw4qCg,107
+aury/boot/infrastructure/channel/backends/broadcaster.py,sha256=y8eKx6X6Iy9a_5vnLMm5gjqkq05SmJEWESw1-x0lIFg,4771
 aury/boot/infrastructure/clients/__init__.py,sha256=1ANMejb3RrBgaR-jq-dsxJ0kQDRHz5jV-QvdUNcf_ok,435
 aury/boot/infrastructure/clients/rabbitmq/__init__.py,sha256=cnU-W7jOcAgp_FvsY9EipNCeJzeA9gHLRuZ0yQZE2DI,200
 aury/boot/infrastructure/clients/rabbitmq/config.py,sha256=YmvNiISpqNt-LE2CrpzmxCgaEgYna7IbOfUSnA0B4T0,1239
@@ -155,19 +157,34 @@ aury/boot/infrastructure/database/__init__.py,sha256=MsHNyrJ2CZJT-lbVZzOAJ0nFfFE
 aury/boot/infrastructure/database/config.py,sha256=5LYy4DuLL0XNjVnX2HUcrMh3c71eeZa-vWGM8QCkL0U,1408
 aury/boot/infrastructure/database/exceptions.py,sha256=hUjsU23c0eMwogSDrKq_bQ6zvnY7PQSGaitbCEhhDZQ,766
 aury/boot/infrastructure/database/manager.py,sha256=lRSKL9jDkSdaA99DjD1k4EoQuQsn2vbh9XQQBOt9dM0,10317
-aury/boot/infrastructure/database/query_tools/__init__.py,sha256=D-8Wxm8x48rg9G95aH_b4re7S4_IGJO9zznArYXldFo,5500
+aury/boot/infrastructure/database/query_tools/__init__.py,sha256=pOFuyDDNpkY5cSMJ-O6UA0-5Lq96-Zvt4FaYMhiwaMg,5488
 aury/boot/infrastructure/database/strategies/__init__.py,sha256=foj_2xEsgLZxshpK65YAhdJ2UZyh1tKvGRq6sre8pQY,5909
 aury/boot/infrastructure/di/__init__.py,sha256=qFYlk265d6_rS8OiX37_wOc7mBFw8hk3yipDYNkyjQg,231
 aury/boot/infrastructure/di/container.py,sha256=14FVbafGXea-JEAYeOEBxB6zAwndLCZJvprKiD_1IOQ,12524
-aury/boot/infrastructure/events/__init__.py,sha256=D5JNFkGHCH79nYbqUil0Z8eW2p6Gx8P0vBbNnHqnTgM,698
-aury/boot/infrastructure/events/base.py,sha256=oS6aNUWRvpXlbh7L3_4vzlwUumYmg44HKS1S4m_zOFo,3019
-aury/boot/infrastructure/events/manager.py,sha256=Hnua9x_Ppmo99JUEmjuZcKIPv2IEZQ3Du9ziPg-C8Fo,7570
+aury/boot/infrastructure/events/__init__.py,sha256=-fXZiTKkwh2olyw8BCGO-Qv67ZDCS0enioY005vPhrI,676
+aury/boot/infrastructure/events/base.py,sha256=m5sXe7rpdvq6pcgCAn2PX7lLXZgCpujteRqHXQ0oaqs,3238
+aury/boot/infrastructure/events/manager.py,sha256=aQNzyPuz1oWAMkXz4UQqCRSPiGTcm8HmSE1lGWovhWE,7754
 aury/boot/infrastructure/events/middleware.py,sha256=Ck3qNMTtLuFFKsJuEUeOMG9nu3qK1N_aqt6wH5JoAtw,1336
-aury/boot/infrastructure/events/backends/__init__.py,sha256=V_hPtdjVUkYU4Uf8hTPVBUcnNYG9OfkjRPDnjp_5_zA,224
-aury/boot/infrastructure/events/backends/memory.py,sha256=Up7vAxdJvIqkcqpnKNCu81ec6iCfNIhcQ-jKM3M2hZc,2623
+aury/boot/infrastructure/events/backends/__init__.py,sha256=1mj0rDauHdoRm4kXOg87l2f9jnMbj_jKZdVnIZMj9XM,185
+aury/boot/infrastructure/events/backends/broadcaster.py,sha256=FnxO62LUXWLs1ZEiaYmNiMaL3ccXNtuc3DFzLe02eK0,6700
 aury/boot/infrastructure/events/backends/rabbitmq.py,sha256=XCuI9mc3GR-t0zht4yZ3e2nnyFl8UuTDir_0nsDbfxM,6495
-aury/boot/infrastructure/events/backends/redis.py,sha256=i8jPCtR7ITPVTl9DVFDbNbjypnWoeSpar6z4lJJlOD8,5790
-aury/boot/infrastructure/monitoring/__init__.py,sha256=VgElCdCVcgERTIn3oRoSNslR82W9gRX5vgJcYDeloak,16149
+aury/boot/infrastructure/monitoring/__init__.py,sha256=KGtJU0slbRvFzzUv60LQHB12sX7eNNvGDu8Lyk9Owy8,22415
+aury/boot/infrastructure/monitoring/alerting/__init__.py,sha256=gBZ23JnCjqglyYTTUxfkmilZ4mY_ZkrkKMDo--3COGE,1363
+aury/boot/infrastructure/monitoring/alerting/aggregator.py,sha256=fiI-lBSqWxXv1eVPfaDNjcigX-81w41fcmhD_vN_XSs,5805
+aury/boot/infrastructure/monitoring/alerting/events.py,sha256=zJvTevQ-9JflIDyYVo1BRzOVyAGhdgEfRlMsD0NcBgM,4056
+aury/boot/infrastructure/monitoring/alerting/manager.py,sha256=ZcIMhBgHmrSGn8FeJOIBIiwKOcdWvT6NBm-6wvRmGc4,14525
+aury/boot/infrastructure/monitoring/alerting/rules.py,sha256=XcXJXWVrPpdZKKz63BiVWmwkKitIaNQWBfJATrSzG1M,6116
+aury/boot/infrastructure/monitoring/alerting/notifiers/__init__.py,sha256=dsfxThPHO_Ofb3Wo_dYlL8HvP_N63pb_S_UXm_qSxF8,321
+aury/boot/infrastructure/monitoring/alerting/notifiers/base.py,sha256=_RXZMzWX-YeTG0Up1U8CwK8ADfX34dd0Sh56ugfqOWM,1462
+aury/boot/infrastructure/monitoring/alerting/notifiers/feishu.py,sha256=JAMJiCNRYoDeJrYn29ew_ZVXDGq8OLgiFApRWd4iPY0,7134
+aury/boot/infrastructure/monitoring/alerting/notifiers/webhook.py,sha256=EiGtLCztHoyjRTR3cvhguRMXbMkScfwY_mXRy9AD5Vw,3514
+aury/boot/infrastructure/monitoring/health/__init__.py,sha256=nqwFFXl6J9yTfQa1JLjQDs4hS4qSVEeA4w07JWdt4jM,7305
+aury/boot/infrastructure/monitoring/tracing/__init__.py,sha256=YizkpnhY-bcUUcd8YaDzUsluMflhNOH1dAKdVtkW05U,1287
+aury/boot/infrastructure/monitoring/tracing/context.py,sha256=s_k2MzNl4LDDpei9xUP6TFW5BwZneoQg44RPaw95jac,978
+aury/boot/infrastructure/monitoring/tracing/logging.py,sha256=gzuKa1ZiyY4z06fHNTbjgZasS6mLftSEaZQQ-Z6J_RE,2041
+aury/boot/infrastructure/monitoring/tracing/processor.py,sha256=qc37YmS8rslpwqAYHrBDzVvNWmXRIFEwpld34NMmByk,12640
+aury/boot/infrastructure/monitoring/tracing/provider.py,sha256=AnPHUDHnfrCB48WHjp9vLBhCh9BpyfWb3DHGRh6Din4,11553
+aury/boot/infrastructure/monitoring/tracing/tracing.py,sha256=BeWL-FYtlQ05r05wGJ6qjTSpypgCp-7OzdNnZ3uunB0,6890
 aury/boot/infrastructure/mq/__init__.py,sha256=Q7kBk_GeQnxnqkyp29Bh1yFH3Q8xxxjs8oDYLeDj8C0,498
 aury/boot/infrastructure/mq/base.py,sha256=kHrWUysWflMj3qyOnioLZ90it8d9Alq1Wb4PYhpBW4k,3396
 aury/boot/infrastructure/mq/manager.py,sha256=DVXOQhoqx9dz9INajWiAxLnKjLaP-otKmdiBUzxgsAY,7502
@@ -192,7 +209,7 @@ aury/boot/testing/client.py,sha256=KOg1EemuIVsBG68G5y0DjSxZGcIQVdWQ4ASaHE3o1R0,4
 aury/boot/testing/factory.py,sha256=8GvwX9qIDu0L65gzJMlrWB0xbmJ-7zPHuwk3eECULcg,5185
 aury/boot/toolkit/__init__.py,sha256=AcyVb9fDf3CaEmJPNkWC4iGv32qCPyk4BuFKSuNiJRQ,334
 aury/boot/toolkit/http/__init__.py,sha256=zIPmpIZ9Qbqe25VmEr7jixoY2fkRbLm7NkCB9vKpg6I,11039
-aury_boot-0.0.29.dist-info/METADATA,sha256=EaL1z6pE7pRmQ6YSAytT91uPj34ejAyuzeTpWWpAI-g,7695
-aury_boot-0.0.29.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-aury_boot-0.0.29.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
-aury_boot-0.0.29.dist-info/RECORD,,
+aury_boot-0.0.31.dist-info/METADATA,sha256=UPuRX_9BPO-OPlk78XK1ynbzHq-je4mrKTKrAvsouzA,8560
+aury_boot-0.0.31.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aury_boot-0.0.31.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
+aury_boot-0.0.31.dist-info/RECORD,,

aury/boot/infrastructure/channel/backends/memory.py

@@ -1,126 +0,0 @@
-"""内存通道后端。
-
-适用于单进程场景，如开发环境或简单应用。
-"""
-
-from __future__ import annotations
-
-import asyncio
-from collections.abc import AsyncIterator
-import contextlib
-import fnmatch
-
-from aury.boot.common.logging import logger
-
-from ..base import ChannelMessage, IChannel
-
-
-class MemoryChannel(IChannel):
-    """内存通道实现。
-
-    使用 asyncio.Queue 实现进程内的发布/订阅。
-
-    注意：仅适用于单进程，不支持跨进程通信。
-    """
-
-    def __init__(self, max_subscribers: int = 1000) -> None:
-        """初始化内存通道。
-
-        Args:
-            max_subscribers: 每个通道最大订阅者数量
-        """
-        self._max_subscribers = max_subscribers
-        # channel -> list of queues
-        self._subscribers: dict[str, list[asyncio.Queue[ChannelMessage]]] = {}
-        # pattern -> list of queues (用于 psubscribe)
-        self._pattern_subscribers: dict[str, list[asyncio.Queue[ChannelMessage]]] = {}
-        self._lock = asyncio.Lock()
-
-    async def publish(self, channel: str, message: ChannelMessage) -> None:
-        """发布消息到通道。"""
-        message.channel = channel
-        async with self._lock:
-            # 精确匹配订阅者
-            subscribers = self._subscribers.get(channel, [])
-            for queue in subscribers:
-                try:
-                    queue.put_nowait(message)
-                except asyncio.QueueFull:
-                    logger.warning(f"通道 [{channel}] 订阅者队列已满，消息被丢弃")
-
-            # 模式匹配订阅者
-            for pattern, queues in self._pattern_subscribers.items():
-                if fnmatch.fnmatch(channel, pattern):
-                    for queue in queues:
-                        try:
-                            queue.put_nowait(message)
-                        except asyncio.QueueFull:
-                            logger.warning(f"模式 [{pattern}] 订阅者队列已满，消息被丢弃")
-
-    async def subscribe(self, channel: str) -> AsyncIterator[ChannelMessage]:
-        """订阅通道。"""
-        queue: asyncio.Queue[ChannelMessage] = asyncio.Queue(maxsize=100)
-
-        async with self._lock:
-            if channel not in self._subscribers:
-                self._subscribers[channel] = []
-            if len(self._subscribers[channel]) >= self._max_subscribers:
-                raise RuntimeError(f"通道 [{channel}] 订阅者数量已达上限")
-            self._subscribers[channel].append(queue)
-
-        try:
-            while True:
-                message = await queue.get()
-                yield message
-        finally:
-            async with self._lock:
-                if channel in self._subscribers:
-                    with contextlib.suppress(ValueError):
-                        self._subscribers[channel].remove(queue)
-                    if not self._subscribers[channel]:
-                        del self._subscribers[channel]
-
-    async def psubscribe(self, pattern: str) -> AsyncIterator[ChannelMessage]:
-        """模式订阅通道。
-
-        使用 fnmatch 风格的通配符：
-        - `*` 匹配任意字符
-        - `?` 匹配单个字符
-        - `[seq]` 匹配 seq 中的任意字符
-        """
-        queue: asyncio.Queue[ChannelMessage] = asyncio.Queue(maxsize=100)
-
-        async with self._lock:
-            if pattern not in self._pattern_subscribers:
-                self._pattern_subscribers[pattern] = []
-            if len(self._pattern_subscribers[pattern]) >= self._max_subscribers:
-                raise RuntimeError(f"模式 [{pattern}] 订阅者数量已达上限")
-            self._pattern_subscribers[pattern].append(queue)
-
-        try:
-            while True:
-                message = await queue.get()
-                yield message
-        finally:
-            async with self._lock:
-                if pattern in self._pattern_subscribers:
-                    with contextlib.suppress(ValueError):
-                        self._pattern_subscribers[pattern].remove(queue)
-                    if not self._pattern_subscribers[pattern]:
-                        del self._pattern_subscribers[pattern]
-
-    async def unsubscribe(self, channel: str) -> None:
-        """取消订阅通道（清除所有订阅者）。"""
-        async with self._lock:
-            if channel in self._subscribers:
-                del self._subscribers[channel]
-
-    async def close(self) -> None:
-        """关闭通道，清理所有订阅。"""
-        async with self._lock:
-            self._subscribers.clear()
-            self._pattern_subscribers.clear()
-        logger.debug("内存通道已关闭")
-
-
-__all__ = ["MemoryChannel"]