feat(go): expose runtime ingest metrics

go/vehicle-gateway/internal/gateway/tcp_server.go

@@ -15,6 +15,7 @@ import (
 	"lingniu-vehicle-ingest/go/vehicle-gateway/internal/envelope"
 	"lingniu-vehicle-ingest/go/vehicle-gateway/internal/eventbus"
 	"lingniu-vehicle-ingest/go/vehicle-gateway/internal/identity"
+	"lingniu-vehicle-ingest/go/vehicle-gateway/internal/metrics"
 )
 
 type FrameExtractor func([]byte) (frames [][]byte, remainder []byte, err error)
@@ -36,6 +37,7 @@ type TCPServer struct {
 	sink           eventbus.Sink
 	resolver       identity.Resolver
 	logger         *slog.Logger
+	metrics        *metrics.Registry
 	readBufferSize int
 	idleTimeout    time.Duration
 	maxConnections int
@@ -46,6 +48,7 @@ type TCPServerConfig struct {
 	Sink           eventbus.Sink
 	Resolver       identity.Resolver
 	Logger         *slog.Logger
+	Metrics        *metrics.Registry
 	ReadBufferSize int
 	IdleTimeout    time.Duration
 	MaxConnections int
@@ -89,6 +92,7 @@ func NewTCPServer(cfg TCPServerConfig) (*TCPServer, error) {
 		sink:           cfg.Sink,
 		resolver:       cfg.Resolver,
 		logger:         cfg.Logger,
+		metrics:        cfg.Metrics,
 		readBufferSize: cfg.ReadBufferSize,
 		idleTimeout:    cfg.IdleTimeout,
 		maxConnections: cfg.MaxConnections,
@@ -209,18 +213,23 @@ func (s *TCPServer) handleFrame(ctx context.Context, conn net.Conn, raw []byte,
 			env = resolved
 		}
 	}
+	s.recordFrameMetric(env.ParseStatus)
 
 	if err := s.sink.PublishRaw(frameCtx, env); err != nil {
+		s.recordPublishMetric("raw", "error")
 		s.logger.Error("publish raw failed", "protocol", s.protocol.Protocol, "event_id", env.StableEventID(), "error", err)
 		return
 	}
+	s.recordPublishMetric("raw", "ok")
 	if env.ParseStatus == envelope.ParseBadFrame {
 		return
 	}
 	if err := s.sink.PublishUnified(frameCtx, env); err != nil {
+		s.recordPublishMetric("unified", "error")
 		s.logger.Error("publish unified failed", "protocol", s.protocol.Protocol, "event_id", env.StableEventID(), "error", err)
 		return
 	}
+	s.recordPublishMetric("unified", "ok")
 	if s.protocol.Respond == nil {
 		return
 	}
@@ -238,6 +247,27 @@ func (s *TCPServer) handleFrame(ctx context.Context, conn net.Conn, raw []byte,
 	}
 }
 
+func (s *TCPServer) recordFrameMetric(status envelope.ParseStatus) {
+	if s.metrics == nil {
+		return
+	}
+	s.metrics.IncCounter("vehicle_gateway_frames_total", metrics.Labels{
+		"protocol": string(s.protocol.Protocol),
+		"status":   string(status),
+	})
+}
+
+func (s *TCPServer) recordPublishMetric(kind string, status string) {
+	if s.metrics == nil {
+		return
+	}
+	s.metrics.IncCounter("vehicle_gateway_publish_total", metrics.Labels{
+		"protocol": string(s.protocol.Protocol),
+		"kind":     kind,
+		"status":   status,
+	})
+}
+
 func (p TCPProtocol) String() string {
 	return fmt.Sprintf("%s@%s", p.Protocol, p.Addr)
 }