aury-boot 0.0.32__py3-none-any.whl → 0.0.33__py3-none-any.whl

aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.32'
-__version_tuple__ = version_tuple = (0, 0, 32)
+__version__ = version = '0.0.33'
+__version_tuple__ = version_tuple = (0, 0, 33)
 
 __commit_id__ = commit_id = None

aury/boot/infrastructure/monitoring/alerting/__init__.py

@@ -27,7 +27,7 @@
 
 from .aggregator import AlertAggregator
 from .events import AlertEvent, AlertEventType, AlertNotification, AlertSeverity
-from .manager import AlertManager, emit_alert
+from .manager import AlertManager, emit_alert, emit_exception_alert
 from .notifiers import AlertNotifier, FeishuNotifier, WebhookNotifier
 from .rules import AlertRule, load_rules_from_dict
 
@@ -46,5 +46,6 @@ __all__ = [
     "WebhookNotifier",
     # 便捷函数
     "emit_alert",
+    "emit_exception_alert",
     "load_rules_from_dict",
 ]

aury/boot/infrastructure/monitoring/alerting/manager.py

@@ -424,7 +424,61 @@ def _detect_source() -> str:
     return "unknown"
 
 
+async def emit_exception_alert(
+    exc: Exception,
+    message: str | None = None,
+    *,
+    severity: AlertSeverity = AlertSeverity.ERROR,
+    source: str | None = None,
+    **metadata: Any,
+) -> None:
+    """发送异常告警的便捷函数（带完整堆栈）。
+    
+    用于在 try/except 中捕获异常后手动发送告警。
+    框架只会自动告警未被捕获的异常，被 catch 的异常需要手动调用此函数。
+    
+    Args:
+        exc: 异常对象
+        message: 告警消息（默认使用异常信息）
+        severity: 严重级别（默认 ERROR）
+        source: 来源（可选，自动检测）
+        **metadata: 额外元数据（如 session_id, user_id 等）
+        
+    Example:
+        try:
+            await some_operation()
+        except Exception as e:
+            await emit_exception_alert(
+                e, 
+                source="task_stream",
+                session_id=session_id,
+            )
+            # 继续处理...
+    """
+    import traceback
+    
+    exc_type = type(exc).__name__
+    exc_msg = str(exc)
+    tb = traceback.format_exc()
+    
+    alert_message = message or f"{exc_type}: {exc_msg}"
+    
+    # 合并异常信息到 metadata
+    metadata["error_type"] = exc_type
+    metadata["error_message"] = exc_msg
+    metadata["stacktrace"] = tb
+    
+    await emit_alert(
+        AlertEventType.EXCEPTION,
+        alert_message,
+        severity=severity,
+        source=source,
+        **metadata,
+    )
+
+
 __all__ = [
     "AlertManager",
     "emit_alert",
+    "emit_exception_alert",
 ]

{aury_boot-0.0.32.dist-info → aury_boot-0.0.33.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.32
+Version: 0.0.33
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2

{aury_boot-0.0.32.dist-info → aury_boot-0.0.33.dist-info}/RECORD

@@ -1,5 +1,5 @@
 aury/boot/__init__.py,sha256=pCno-EInnpIBa1OtxNYF-JWf9j95Cd2h6vmu0xqa_-4,1791
-aury/boot/_version.py,sha256=R_6iGx2TpbHTm0_3hIB8Kl5225iMZqRsqf47DXFHa64,706
+aury/boot/_version.py,sha256=xrs8Qn_OZ3B9ijkPtzIwzsKzRxeJuFan8EOwBgLmnxE,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
@@ -169,10 +169,10 @@ aury/boot/infrastructure/events/backends/__init__.py,sha256=1mj0rDauHdoRm4kXOg87
 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/monitoring/__init__.py,sha256=KGtJU0slbRvFzzUv60LQHB12sX7eNNvGDu8Lyk9Owy8,22415
-aury/boot/infrastructure/monitoring/alerting/__init__.py,sha256=gBZ23JnCjqglyYTTUxfkmilZ4mY_ZkrkKMDo--3COGE,1363
+aury/boot/infrastructure/monitoring/alerting/__init__.py,sha256=UvUsMhSZeGJOjZy05FnkZQmWytBlz3wiRd0y8EfZgpY,1413
 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/manager.py,sha256=vdWox9Pnjl_0IIE6w-Ne9R17IUrqtF9CPhZHwZvke6E,16044
 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
@@ -209,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.32.dist-info/METADATA,sha256=QlqZSaFqARK6vxLILTJn6BKGKBHejKRtO085_XZK2BE,8694
-aury_boot-0.0.32.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-aury_boot-0.0.32.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
-aury_boot-0.0.32.dist-info/RECORD,,
+aury_boot-0.0.33.dist-info/METADATA,sha256=pJ1jUTF2kmZXGKLj-gC0fF2i5Jj1Uq_tkRUjdqJMu-8,8694
+aury_boot-0.0.33.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aury_boot-0.0.33.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
+aury_boot-0.0.33.dist-info/RECORD,,