1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
//! Copyright (c) 2026 Kirky.X. All rights reserved.
//! See LICENSE for full license text.
//! 可观测性模块,提供 Prometheus 指标、结构化 JSON 日志与 OpenTelemetry 分布式追踪。
//!
//! ## 三层架构
//!
//! - **Metrics**(`GarrisonMetrics`):Prometheus 格式指标,覆盖登录成功率 / Token 验证延迟 /
//! 权限查询 QPS / 角色查询 QPS。启用 `metrics-prometheus` feature。
//! - **Logs**([`init_inklog_logging`](crate::observability::inklog::init_inklog_logging) /
//! [`init_inklog_logging_with_fallback`](crate::observability::inklog::init_inklog_logging_with_fallback)):
//! inklog 结构化日志(含降级到 tracing-subscriber JSON)。启用 `audit-inklog` feature;
//! 降级路径在 `metrics-prometheus` 或 `tracing-log` 启用时使用 tracing-subscriber JSON。
//! - **Traces**([`init_otlp_tracing`](crate::observability::otlp::init_otlp_tracing)):
//! OpenTelemetry 分布式追踪,OTLP gRPC 导出。启用 `observability-otlp` feature。
//!
//! ## 集成点
//!
//! `GarrisonMetrics` 通过 `GarrisonLogicDefault::with_metrics` builder 注入,未注入时零开销。
//!
//! ## Feature 门控
//!
//! - `metrics-prometheus`:编译期包含 `GarrisonMetrics`,并为 inklog 降级路径提供 tracing-subscriber 依赖
//! - `audit-inklog`:编译期包含 inklog 初始化与降级 API
//! - `observability-otlp`:编译期包含 OTLP 导出器
//! - 未启用任一 feature:模块仍可导入但所有 API 返回 `None` / no-op,保证向后兼容
pub use prometheus;
/// Prometheus 指标集合,覆盖登录 / Token 验证 / 权限查询 / 角色查询。
///
/// 通过 `GarrisonLogicDefault::with_metrics` builder 注入,未注入时所有 `*_metrics` 调用为
/// no-op(`Option::None` 短路)。
///
/// # 指标清单
///
/// | 指标名 | 类型 | 标签 | 说明 |
/// |--------|------|------|------|
/// | `garrison_login_total` | Counter | `result=success\|failure` | 登录尝试次数 |
/// | `garrison_token_validation_duration_seconds` | Histogram | - | Token 验证延迟(秒) |
/// | `garrison_permission_query_total` | Counter | `result=allow\|deny` | 权限查询次数 |
/// | `garrison_role_query_total` | Counter | `result=allow\|deny` | 角色查询次数 |
/// impl 块子模块(`GarrisonMetrics::new` / `register_to` / `record_*` 等)。
/// inklog 结构化日志初始化(`init_inklog_logging` / `init_inklog_logging_with_fallback` / `InklogInit`)。
/// OpenTelemetry OTLP 追踪导出初始化(`init_otlp_tracing`)。
/// `GarrisonOtelError` 转换实现子模块。
// ============================================================================
// 公共 re-export(保持向后兼容的扁平 API)
// ============================================================================
pub use ;
pub use init_otlp_tracing;
/// inklog 初始化结果 — 包含可选的 LoggerManager guard 和降级状态。
///
/// M-4: `#[must_use]` 确保 guard 不会被意外丢弃(丢弃后 subscriber 可能注销)。
/// OpenTelemetry 初始化错误。
/// 指标集合的 feature-gated 别名。
///
/// - `metrics-prometheus` 启用:解析为 [`GarrisonMetrics`]
/// - 未启用:不可用(调用方使用 `Option<Arc<GarrisonMetrics>>` 时仍可编译)
pub type GarrisonMetrics = ;