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

aury/boot/commands/templates/project/aury_docs/17-alerting.md.tpl

@@ -0,0 +1,210 @@
+# 告警系统
+
+本文档介绍 {project_name} 项目中的告警系统配置和使用方法。
+
+## 快速开始（简版配置）
+
+所有告警发送到同一个飞书群：
+
+```bash
+# .env
+ALERT__ENABLED=true
+ALERT__NOTIFIERS__DEFAULT__TYPE=feishu
+ALERT__NOTIFIERS__DEFAULT__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/xxx
+```
+
+框架会自动创建默认规则，检测慢请求、慢 SQL、异常并发送告警。
+
+---
+
+## 完整版配置（分群告警）
+
+不同类型的告警发送到不同的飞书群，避免一个群接收所有消息。
+
+### 1. 环境变量
+
+```bash
+# .env
+
+# ============ 告警系统 ============
+ALERT__ENABLED=true
+ALERT__RULES_FILE=alert_rules.yaml
+
+# 性能群（慢请求、慢SQL）
+ALERT__NOTIFIERS__PERF_GROUP__TYPE=feishu
+ALERT__NOTIFIERS__PERF_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/perf-xxx
+ALERT__NOTIFIERS__PERF_GROUP__SECRET=your-secret  # 可选
+
+# 错误群（异常）
+ALERT__NOTIFIERS__ERROR_GROUP__TYPE=feishu
+ALERT__NOTIFIERS__ERROR_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/error-xxx
+
+# 运维群（任务失败、超时）
+ALERT__NOTIFIERS__OPS_GROUP__TYPE=feishu
+ALERT__NOTIFIERS__OPS_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/ops-xxx
+
+# 慢操作阈值
+ALERT__SLOW_REQUEST_THRESHOLD=1.0
+ALERT__SLOW_SQL_THRESHOLD=0.5
+```
+
+### 2. 规则文件
+
+生成规则模板：`aury docs alert-rules`
+
+```yaml
+# alert_rules.yaml
+defaults:
+  slow_request_threshold: 1.0
+  slow_sql_threshold: 0.5
+  aggregate_window: 10
+  suppress_seconds: 300
+
+rules:
+  # 慢请求 → 性能群
+  - name: slow_request
+    event_types: [slow_request]
+    aggregate_threshold: 5
+    notifiers: [perf_group]
+
+  # 慢 SQL → 性能群
+  - name: slow_sql
+    event_types: [slow_sql]
+    aggregate_threshold: 10
+    notifiers: [perf_group]
+
+  # 异常 → 错误群（立即告警）
+  - name: exception
+    event_types: [exception]
+    aggregate_threshold: 1
+    suppress_seconds: 60
+    notifiers: [error_group]
+
+  # 任务失败/超时 → 运维群
+  - name: task_issues
+    event_types: [task_failure, task_timeout]
+    aggregate_threshold: 1
+    notifiers: [ops_group]
+```
+
+### 3. 效果
+
+| 事件类型 | 目标群 | 触发条件 |
+|---------|--------|----------|
+| 慢请求（>1s） | 性能群 | 60秒内累计5次 |
+| 慢 SQL（>0.5s） | 性能群 | 60秒内累计10次 |
+| 异常 | 错误群 | 立即告警 |
+| 任务失败/超时 | 运维群 | 立即告警 |
+
+---
+
+## 代码中手动发送告警
+
+```python
+from aury.boot.infrastructure.monitoring.alerting import emit_alert, AlertEventType, AlertSeverity
+
+# 发送自定义告警
+await emit_alert(
+    AlertEventType.CUSTOM,
+    "订单支付超时",
+    severity=AlertSeverity.WARNING,
+    order_id="12345",
+    user_id="u001",
+)
+
+# 发送慢 SQL 告警（通常由框架自动触发）
+await emit_alert(
+    AlertEventType.SLOW_SQL,
+    "慢查询告警",
+    duration=2.5,
+    sql="SELECT * FROM orders WHERE ...",
+)
+```
+
+---
+
+## 通知器类型
+
+### 飞书（feishu）
+
+```bash
+ALERT__NOTIFIERS__XXX__TYPE=feishu
+ALERT__NOTIFIERS__XXX__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/xxx
+ALERT__NOTIFIERS__XXX__SECRET=xxx  # 可选，签名密钥
+```
+
+### 通用 Webhook
+
+```bash
+ALERT__NOTIFIERS__XXX__TYPE=webhook
+ALERT__NOTIFIERS__XXX__URL=https://your-system.com/alert
+ALERT__NOTIFIERS__XXX__METHOD=POST
+ALERT__NOTIFIERS__XXX__HEADERS='{{"Authorization": "Bearer xxx"}}'
+```
+
+### 自定义通知器
+
+```python
+from aury.boot.infrastructure.monitoring.alerting import AlertNotifier, AlertManager
+
+class DingTalkNotifier(AlertNotifier):
+    @classmethod
+    def from_config(cls, config: dict) -> "DingTalkNotifier":
+        return cls(webhook=config["webhook"])
+
+    async def send(self, notification) -> bool:
+        # 实现发送逻辑
+        ...
+
+# 注册
+AlertManager.register_notifier_class("dingtalk", DingTalkNotifier)
+```
+
+然后在环境变量中使用：
+
+```bash
+ALERT__NOTIFIERS__DING__TYPE=dingtalk
+ALERT__NOTIFIERS__DING__WEBHOOK=https://oapi.dingtalk.com/robot/send?access_token=xxx
+```
+
+---
+
+## 告警事件类型
+
+| 类型 | 说明 | 自动触发 |
+|-----|------|----------|
+| `slow_request` | 慢 HTTP 请求 | 框架自动检测 |
+| `slow_sql` | 慢 SQL 查询 | 框架自动检测 |
+| `exception` | 异常/错误 | 框架自动检测 |
+| `task_failure` | 任务执行失败 | 任务系统触发 |
+| `task_timeout` | 任务执行超时 | 任务系统触发 |
+| `custom` | 自定义告警 | 手动调用 emit_alert |
+
+---
+
+## 告警抑制与聚合
+
+- **聚合窗口**：在窗口时间内累计触发次数，达到阈值才发送告警
+- **抑制时间**：同一告警在抑制时间内不会重复发送
+- **示例**：`aggregate_window=60, aggregate_threshold=5` 表示 60 秒内触发 5 次才告警
+
+这样可以避免告警风暴，同时不遗漏重要问题。
+
+---
+
+## 环境变量参考
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `ALERT__ENABLED` | 是否启用告警 | `false` |
+| `ALERT__RULES_FILE` | 规则文件路径 | - |
+| `ALERT__SLOW_REQUEST_THRESHOLD` | 慢请求阈值（秒） | `1.0` |
+| `ALERT__SLOW_SQL_THRESHOLD` | 慢 SQL 阈值（秒） | `0.5` |
+| `ALERT__ALERT_ON_SLOW_REQUEST` | 是否对慢请求告警 | `true` |
+| `ALERT__ALERT_ON_SLOW_SQL` | 是否对慢 SQL 告警 | `true` |
+| `ALERT__ALERT_ON_ERROR` | 是否对异常告警 | `true` |
+| `ALERT__AGGREGATE_WINDOW` | 聚合窗口（秒） | `10` |
+| `ALERT__SLOW_REQUEST_AGGREGATE` | 慢请求触发阈值（窗口内次数） | `5` |
+| `ALERT__SLOW_SQL_AGGREGATE` | 慢 SQL 触发阈值 | `10` |
+| `ALERT__EXCEPTION_AGGREGATE` | 异常触发阈值 | `1` |
+| `ALERT__SUPPRESS_SECONDS` | 抑制时间（秒） | `300` |

aury/boot/commands/templates/project/env_templates/monitoring.tpl

@@ -0,0 +1,61 @@
+# =============================================================================
+# 监控与告警配置
+# =============================================================================
+
+# ---------- OpenTelemetry 遥测 ----------
+# 启用后自动 instrument FastAPI、SQLAlchemy、httpx
+TELEMETRY__ENABLED=false
+# TELEMETRY__SAMPLING_RATE=1.0
+
+# OTLP 导出（可选）
+# TELEMETRY__TRACES_ENDPOINT=http://jaeger:4317
+# TELEMETRY__LOGS_ENDPOINT=http://loki:3100
+# TELEMETRY__METRICS_ENDPOINT=http://prometheus:9090
+
+# ---------- 告警系统 ----------
+ALERT__ENABLED=false
+# 慢操作阈值
+ALERT__SLOW_REQUEST_THRESHOLD=1.0
+ALERT__SLOW_SQL_THRESHOLD=0.5
+# 告警开关
+ALERT__ALERT_ON_SLOW_REQUEST=true
+ALERT__ALERT_ON_SLOW_SQL=true
+ALERT__ALERT_ON_ERROR=true
+# 聚合与抑制
+ALERT__AGGREGATE_WINDOW=10
+ALERT__SLOW_REQUEST_AGGREGATE=5
+ALERT__SLOW_SQL_AGGREGATE=10
+ALERT__EXCEPTION_AGGREGATE=1
+ALERT__SUPPRESS_SECONDS=300
+
+# ---------- 告警通知器（简版：单群）----------
+# 所有告警发到同一个飞书群，取消注释并填写 Webhook 即可
+# ALERT__NOTIFIERS__DEFAULT__TYPE=feishu
+# ALERT__NOTIFIERS__DEFAULT__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-id
+# ALERT__NOTIFIERS__DEFAULT__SECRET=your-secret
+
+# ---------- 告警通知器（完整版：分群告警）----------
+# 不同类型告警发到不同群，需配合 alert_rules.yaml 使用
+# 生成规则模板：aury docs alert-rules
+# ALERT__RULES_FILE=alert_rules.yaml
+
+# 性能群（慢请求、慢SQL）
+# ALERT__NOTIFIERS__PERF_GROUP__TYPE=feishu
+# ALERT__NOTIFIERS__PERF_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/perf-webhook-id
+# ALERT__NOTIFIERS__PERF_GROUP__SECRET=perf-secret
+
+# 错误群（异常）
+# ALERT__NOTIFIERS__ERROR_GROUP__TYPE=feishu
+# ALERT__NOTIFIERS__ERROR_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/error-webhook-id
+# ALERT__NOTIFIERS__ERROR_GROUP__SECRET=error-secret
+
+# 运维群（任务失败、超时）
+# ALERT__NOTIFIERS__OPS_GROUP__TYPE=feishu
+# ALERT__NOTIFIERS__OPS_GROUP__WEBHOOK=https://open.feishu.cn/open-apis/bot/v2/hook/ops-webhook-id
+# ALERT__NOTIFIERS__OPS_GROUP__SECRET=ops-secret
+
+# 通用 Webhook（自定义系统）
+# ALERT__NOTIFIERS__CUSTOM__TYPE=webhook
+# ALERT__NOTIFIERS__CUSTOM__URL=https://your-system.com/api/alert
+# ALERT__NOTIFIERS__CUSTOM__METHOD=POST
+# ALERT__NOTIFIERS__CUSTOM__HEADERS={{"Authorization": "Bearer your-token"}}

aury/boot/common/logging/context.py

@@ -58,8 +58,24 @@ def set_service_context(context: ServiceContext | str) -> None:
 def get_trace_id() -> str:
     """获取当前链路追踪ID。
 
-    如果尚未设置，则生成一个新的随机 ID。
+    优先从 OpenTelemetry 获取（如果已启用），否则使用内置 trace_id。
+    如果都没有设置，则生成一个新的随机 ID。
     """
+    # 优先从 OTel 获取
+    try:
+        from opentelemetry import trace
+        
+        span = trace.get_current_span()
+        if span and span.is_recording():
+            otel_trace_id = span.get_span_context().trace_id
+            if otel_trace_id:
+                return format(otel_trace_id, "032x")
+    except ImportError:
+        pass
+    except Exception:
+        pass
+    
+    # 回退到内置实现
     trace_id = _trace_id_var.get()
     if not trace_id:
         trace_id = str(uuid.uuid4())

aury/boot/common/logging/format.py

@@ -309,7 +309,11 @@ def log_exception(
 
 __all__ = [
     "create_console_sink",
+    "format_exception_compact",
     "format_exception_java_style",
     "format_message",
     "log_exception",
 ]
+
+# 别名导出（保持内部使用 _ 前缀）
+format_exception_compact = _format_exception_compact

aury/boot/infrastructure/channel/base.py

@@ -31,7 +31,10 @@ class ChannelMessage:
     timestamp: datetime = field(default_factory=datetime.now)
 
     def to_sse(self) -> str:
-        """转换为 SSE 格式。"""
+        """转换为 SSE 格式。
+        
+        SSE 规范要求每个消息以双换行符结束。
+        """
         lines = []
         if self.id:
             lines.append(f"id: {self.id}")
@@ -42,7 +45,8 @@ class ChannelMessage:
         for line in data_str.split("\n"):
             lines.append(f"data: {line}")
         lines.append("")  # 空行结束
-        return "\n".join(lines)
+        # SSE 规范要求消息以双换行符结束
+        return "\n".join(lines) + "\n"
 
 
 class IChannel(ABC):

aury/boot/infrastructure/database/query_tools/__init__.py

@@ -12,8 +12,8 @@ import time
 
 from aury.boot.common.logging import logger
 
-# 查询性能监控配置
-QUERY_SLOW_THRESHOLD = 1.0  # 慢查询阈值（秒）
+# 默认慢查询阈值（秒）
+DEFAULT_SLOW_QUERY_THRESHOLD = 1.0
 
 
 def cache_query(
@@ -86,7 +86,7 @@ def cache_query(
 
 
 def monitor_query(
-    slow_threshold: float = QUERY_SLOW_THRESHOLD,
+    slow_threshold: float = DEFAULT_SLOW_QUERY_THRESHOLD,
     enable_explain: bool = False,
 ) -> Callable:
     """查询性能监控装饰器。
@@ -104,7 +104,6 @@ def monitor_query(
             async def list(self, **filters):
                 return await super().list(**filters)
     """
-    
     def decorator(func: Callable) -> Callable:
         @wraps(func)
         async def wrapper(self, *args, **kwargs):
@@ -154,7 +153,6 @@ def monitor_query(
     
     return decorator
 
-
 __all__ = [
     "cache_query",
     "monitor_query",

aury/boot/infrastructure/monitoring/__init__.py

@@ -98,15 +98,18 @@ class SlowMethodDetectorComponent(MonitorComponent):
     """慢方法检测组件。
     
     检测执行时间超过阈值的方法并记录警告。
+    支持可选的告警通知（飞书/Webhook）。
     """
     
-    def __init__(self, threshold: float) -> None:
+    def __init__(self, threshold: float, *, alert: bool = False) -> None:
         """初始化慢方法检测组件。
         
         Args:
             threshold: 慢方法阈值（秒）
+            alert: 是否发送告警通知
         """
         self._threshold = threshold
+        self._alert = alert
     
     async def process(self, context: MonitorContext) -> None:
         """检测慢方法。
@@ -119,6 +122,156 @@ class SlowMethodDetectorComponent(MonitorComponent):
                 f"慢方法检测: {context.func_name} 执行时间 {context.duration:.3f}s "
                 f"(阈值: {self._threshold}s)"
             )
+            
+            # 发送告警通知
+            if self._alert:
+                await self._emit_alert(context)
+
+
+    async def _emit_alert(self, context: MonitorContext) -> None:
+        """发送慢方法告警。"""
+        try:
+            from aury.boot.infrastructure.monitoring.alerting import (
+                AlertEventType,
+                AlertSeverity,
+                emit_alert,
+            )
+            
+            await emit_alert(
+                AlertEventType.CUSTOM,
+                f"慢方法: {context.func_name}",
+                severity=AlertSeverity.WARNING,
+                source="service",
+                duration=context.duration,
+                threshold=self._threshold,
+                service=context.service_name,
+            )
+        except ImportError:
+            pass  # alerting 模块未加载
+        except Exception as e:
+            logger.debug(f"发送慢方法告警失败: {e}")
+
+
+# =============================================================================
+# HTTP 请求监控
+# =============================================================================
+
+
+async def monitor_http_request(
+    *,
+    method: str,
+    path: str,
+    duration: float,
+    status_code: int,
+    threshold: float = 1.0,
+    alert: bool = False,
+    trace_id: str = "",
+    exception: Exception | None = None,
+) -> None:
+    """监控 HTTP 请求。
+    
+    由 middleware 调用，统一处理 HTTP 请求的慢请求检测和告警。
+    
+    Args:
+        method: HTTP 方法
+        path: 请求路径
+        duration: 执行时间（秒）
+        status_code: 响应状态码
+        threshold: 慢请求阈值（秒）
+        alert: 是否发送告警
+        trace_id: 追踪 ID
+        exception: 异常对象（如果有）
+    """
+    # 慢请求检测和告警
+    if duration >= threshold:
+        if alert:
+            await _emit_http_slow_alert(
+                method=method,
+                path=path,
+                duration=duration,
+                threshold=threshold,
+                trace_id=trace_id,
+            )
+    
+    # 异常告警
+    if exception is not None and alert:
+        await _emit_http_exception_alert(
+            method=method,
+            path=path,
+            duration=duration,
+            exception=exception,
+            trace_id=trace_id,
+        )
+
+
+async def _emit_http_slow_alert(
+    method: str,
+    path: str,
+    duration: float,
+    threshold: float,
+    trace_id: str,
+) -> None:
+    """发送 HTTP 慢请求告警。"""
+    try:
+        from aury.boot.infrastructure.monitoring.alerting import (
+            AlertEventType,
+            AlertSeverity,
+            emit_alert,
+        )
+        
+        await emit_alert(
+            AlertEventType.SLOW_REQUEST,
+            f"慢请求: {method} {path}",
+            severity=AlertSeverity.WARNING,
+            trace_id=trace_id,
+            source="api",
+            duration=duration,
+            threshold=threshold,
+            endpoint=path,
+            method=method,
+        )
+    except ImportError:
+        pass
+    except Exception as e:
+        logger.debug(f"发送慢请求告警失败: {e}")
+
+
+async def _emit_http_exception_alert(
+    method: str,
+    path: str,
+    duration: float,
+    exception: Exception,
+    trace_id: str,
+) -> None:
+    """发送 HTTP 异常告警。"""
+    try:
+        from aury.boot.infrastructure.monitoring.alerting import (
+            AlertEventType,
+            AlertSeverity,
+            emit_alert,
+        )
+        
+        await emit_alert(
+            AlertEventType.EXCEPTION,
+            f"请求异常: {method} {path} - {type(exception).__name__}: {exception}",
+            severity=AlertSeverity.ERROR,
+            trace_id=trace_id,
+            source="api",
+            duration=duration,
+            endpoint=path,
+            method=method,
+            error_type=type(exception).__name__,
+            error_message=str(exception),
+        )
+    except ImportError:
+        pass
+    except Exception as e:
+        logger.debug(f"发送异常告警失败: {e}")
+
+
+# =============================================================================
+# Service 方法监控组件
+# =============================================================================
 
 
 class StandardMetricsReporterComponent(MonitorComponent):
@@ -172,8 +325,17 @@ class ErrorReporterComponent(MonitorComponent):
     """错误报告组件。
     
     报告方法执行失败的错误信息。
+    支持可选的告警通知（飞书/Webhook）。
     """
     
+    def __init__(self, *, alert: bool = False) -> None:
+        """初始化错误报告组件。
+        
+        Args:
+            alert: 是否发送告警通知
+        """
+        self._alert = alert
+    
     async def process(self, context: MonitorContext) -> None:
         """报告错误信息。
         
@@ -186,6 +348,34 @@ class ErrorReporterComponent(MonitorComponent):
                 f"执行时间: {context.duration:.3f}s | "
                 f"异常: {type(context.exception).__name__}: {context.exception}"
             )
+            
+            # 发送告警通知
+            if self._alert:
+                await self._emit_alert(context)
+    
+    async def _emit_alert(self, context: MonitorContext) -> None:
+        """发送异常告警。"""
+        try:
+            from aury.boot.infrastructure.monitoring.alerting import (
+                AlertEventType,
+                AlertSeverity,
+                emit_alert,
+            )
+            
+            await emit_alert(
+                AlertEventType.EXCEPTION,
+                f"方法异常: {context.func_name}",
+                severity=AlertSeverity.ERROR,
+                source="service",
+                duration=context.duration,
+                service=context.service_name,
+                exception_type=type(context.exception).__name__,
+                exception_message=str(context.exception),
+            )
+        except ImportError:
+            pass  # alerting 模块未加载
+        except Exception as e:
+            logger.debug(f"发送异常告警失败: {e}")
 
 
 class MonitorPipeline:
@@ -278,19 +468,22 @@ class MonitorPipelineBuilder:
     def with_slow_detector(
         self,
         threshold: float = 1.0,
+        *,
+        alert: bool = False,
         detector: SlowMethodDetectorComponent | None = None,
     ) -> MonitorPipelineBuilder:
         """添加慢方法检测组件。
         
         Args:
             threshold: 慢方法阈值（秒）
+            alert: 是否发送告警通知
             detector: 慢方法检测组件，如果为 None 则创建新实例
         
         Returns:
             MonitorPipelineBuilder: 构建器实例（支持链式调用）
         """
         if detector is None:
-            detector = SlowMethodDetectorComponent(threshold)
+            detector = SlowMethodDetectorComponent(threshold, alert=alert)
         self._components.append(detector)
         return self
     
@@ -318,18 +511,21 @@ class MonitorPipelineBuilder:
     
     def with_error_reporter(
         self,
+        *,
+        alert: bool = False,
         reporter: ErrorReporterComponent | None = None,
     ) -> MonitorPipelineBuilder:
         """添加错误报告组件。
         
         Args:
+            alert: 是否发送告警通知
             reporter: 错误报告组件，如果为 None 则创建新实例
         
         Returns:
             MonitorPipelineBuilder: 构建器实例（支持链式调用）
         """
         if reporter is None:
-            reporter = ErrorReporterComponent()
+            reporter = ErrorReporterComponent(alert=alert)
         self._components.append(reporter)
         return self
     
@@ -370,6 +566,7 @@ def monitor(
     slow_threshold: float = 1.0,
     metrics: bool = True,
     prometheus_format: bool = False,
+    alert: bool = False,
     pipeline: MonitorPipeline | None = None,
     components: list[MonitorComponent] | None = None,
     pipeline_builder: Callable[[], MonitorPipeline] | None = None,
@@ -377,13 +574,14 @@ def monitor(
     """服务层性能监控装饰器。
     
     监控服务方法的执行时间和调用次数。
-    支持慢方法警告和 Prometheus 格式导出。
+    支持慢方法警告、Prometheus 格式导出和告警通知。
     支持自定义监控管道和组件。
     
     Args:
         slow_threshold: 慢方法阈值（秒），默认 1.0 秒
         metrics: 是否记录指标（执行时间、调用次数），默认 True
         prometheus_format: 是否使用 Prometheus 格式记录指标，默认 False
+        alert: 是否发送告警通知（飞书/Webhook），默认 False
         pipeline: 自定义监控管道，如果提供则忽略其他参数
         components: 自定义组件列表，如果提供则使用这些组件构建管道
         pipeline_builder: 自定义管道构建函数，如果提供则使用此函数构建管道
@@ -395,6 +593,12 @@ def monitor(
             async def create_user(self, data: dict):
                 return await self.user_repo.create(data)
         
+        # 启用告警通知
+        class PaymentService(BaseService):
+            @monitor(slow_threshold=0.5, alert=True)
+            async def process_payment(self, order_id: str):
+                ...
+        
         # 使用自定义组件
         custom_component = MyCustomMonitorComponent()
         @monitor(components=[custom_component])
@@ -441,12 +645,12 @@ def monitor(
         if metrics:
             builder.with_call_counter()
         
-        builder.with_slow_detector(threshold=slow_threshold)
+        builder.with_slow_detector(threshold=slow_threshold, alert=alert)
         
         if metrics:
             builder.with_metrics_reporter(prometheus_format=prometheus_format)
         
-        builder.with_error_reporter()
+        builder.with_error_reporter(alert=alert)
         
         monitor_pipeline = builder.build()