Initial open source release

internal/mtprotoedge/metrics.go

@@ -0,0 +1,67 @@
+package mtprotoedge
+
+import "time"
+
+// Metrics 接收连接层运行指标。实现可对接 Prometheus 等监控系统；
+// 默认 NopMetrics（零开销）。第一阶段仅预留钩子，正式指标后续接入。
+type Metrics interface {
+	// ConnOpened 在接受一个连接时调用。
+	ConnOpened()
+	// ConnClosed 在一个连接结束时调用。
+	ConnClosed()
+	// HandshakeDone 在一次密钥交换成功完成时调用，d 为握手耗时。
+	HandshakeDone(d time.Duration)
+	// RPCHandled 在一次 RPC 处理完成时调用：method 为 TL 方法名，
+	// d 为耗时，err 非 nil 表示失败。
+	RPCHandled(method string, d time.Duration, err error)
+	// InboundRPCQueued 在 RPC 成功进入单连接 bounded queue 时调用。
+	InboundRPCQueued(method string, len, cap int)
+	// InboundRPCStarted 在 RPC 从 bounded queue 取出开始执行时调用。
+	InboundRPCStarted(method string, queueWait time.Duration)
+	// InboundRPCDropped 在 RPC 因队列满、连接关闭或调度错误被丢弃时调用。
+	InboundRPCDropped(method, reason string)
+	// OutboundSend 在一条 server 出站消息完成写入或失败时调用。
+	OutboundSend(typeID uint32, queueWait time.Duration, bytes int, err error)
+	// OutboundResend 在一次 msg_resend_req/重复 RPC 触发重发后调用。
+	OutboundResend(count int, err error)
+	// OutboundDropped 在出站队列或状态跟踪因背压丢弃时调用。
+	OutboundDropped(reason string)
+	// OutboundQueueWait 在出站入队等待超过阈值时调用。
+	OutboundQueueWait(len, cap int)
+}
+
+// NopMetrics 是 Metrics 的空实现。
+type NopMetrics struct{}
+
+// ConnOpened 实现 Metrics。
+func (NopMetrics) ConnOpened() {}
+
+// ConnClosed 实现 Metrics。
+func (NopMetrics) ConnClosed() {}
+
+// HandshakeDone 实现 Metrics。
+func (NopMetrics) HandshakeDone(time.Duration) {}
+
+// RPCHandled 实现 Metrics。
+func (NopMetrics) RPCHandled(string, time.Duration, error) {}
+
+// InboundRPCQueued 实现 Metrics。
+func (NopMetrics) InboundRPCQueued(string, int, int) {}
+
+// InboundRPCStarted 实现 Metrics。
+func (NopMetrics) InboundRPCStarted(string, time.Duration) {}
+
+// InboundRPCDropped 实现 Metrics。
+func (NopMetrics) InboundRPCDropped(string, string) {}
+
+// OutboundSend 实现 Metrics。
+func (NopMetrics) OutboundSend(uint32, time.Duration, int, error) {}
+
+// OutboundResend 实现 Metrics。
+func (NopMetrics) OutboundResend(int, error) {}
+
+// OutboundDropped 实现 Metrics。
+func (NopMetrics) OutboundDropped(string) {}
+
+// OutboundQueueWait 实现 Metrics。
+func (NopMetrics) OutboundQueueWait(int, int) {}