core/tracker2: add tracker2 package

core/consensus/component.go

@@ -322,6 +322,8 @@ func (c *Component) propose(ctx context.Context, duty core.Duty, value proto.Mes
 
 	if !decided {
 		consensusTimeout.WithLabelValues(duty.Type.String()).Inc()
+
+		return errors.New("consensus timeout", z.Str("duty", duty.String()))
 	}
 
 	return nil

core/interfaces.go

@@ -173,6 +173,30 @@ type Broadcaster interface {
 	Broadcast(context.Context, Duty, PubKey, SignedData) error
 }
 
+// Tracker sends core component events for further analysis and instrumentation.
+type Tracker interface {
+	// FetcherFetched sends Fetcher component's events to tracker.
+	FetcherFetched(context.Context, Duty, DutyDefinitionSet, error)
+
+	// ConsensusProposed sends Consensus component's events to tracker.
+	ConsensusProposed(context.Context, Duty, UnsignedDataSet, error)
+
+	// DutyDBStored sends DutyDB component's store events to tracker.
+	DutyDBStored(context.Context, Duty, UnsignedDataSet, error)
+
+	// ParSigDBStoredInternal sends ParSigDB component's store internal events to tracker.
+	ParSigDBStoredInternal(context.Context, Duty, ParSignedDataSet, error)
+
+	// ParSigDBStoredExternal sends ParSigDB component's store external events to tracker.
+	ParSigDBStoredExternal(context.Context, Duty, ParSignedDataSet, error)
+
+	// SigAggAggregated sends SigAgg component's events to tracker.
+	SigAggAggregated(context.Context, Duty, PubKey, []ParSignedData, error)
+
+	// BroadcasterBroadcast sends Broadcaster component's broadcast events to tracker.
+	BroadcasterBroadcast(context.Context, Duty, PubKey, SignedData, error)
+}
+
 // wireFuncs defines the core workflow components as a list of input and output functions
 // instead as interfaces, since functions are easier to wrap than interfaces.
 type wireFuncs struct {

core/sigagg/sigagg.go

@@ -51,6 +51,8 @@ func (a *Aggregator) Subscribe(fn func(context.Context, core.Duty, core.PubKey,
 
 // Aggregate aggregates the partially signed duty data for the DV.
 func (a *Aggregator) Aggregate(ctx context.Context, duty core.Duty, pubkey core.PubKey, parSigs []core.ParSignedData) error {
+	ctx = log.WithTopic(ctx, "sigagg")
+
 	if len(parSigs) < a.threshold {
 		return errors.New("require threshold signatures")
 	} else if a.threshold == 0 {

core/tracker/tracker2/metrics.go

@@ -0,0 +1,59 @@
+// Copyright © 2022 Obol Labs Inc.
+//
+// This program is free software: you can redistribute it and/or modify it
+// under the terms of the GNU General Public License as published by the Free
+// Software Foundation, either version 3 of the License, or (at your option)
+// any later version.
+//
+// This program is distributed in the hope that it will be useful, but WITHOUT
+// ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY or
+// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+// more details.
+//
+// You should have received a copy of the GNU General Public License along with
+// this program.  If not, see <http://www.gnu.org/licenses/>.
+
+package tracker2
+
+import (
+	"github.com/prometheus/client_golang/prometheus"
+
+	"github.com/obolnetwork/charon/app/promauto"
+)
+
+var (
+	participationGauge = promauto.NewGaugeVec(prometheus.GaugeOpts{
+		Namespace: "core",
+		Subsystem: "tracker2",
+		Name:      "participation",
+		Help:      "Set to 1 if peer participated successfully for the given duty or else 0",
+	}, []string{"duty", "peer"})
+
+	participationCounter = promauto.NewCounterVec(prometheus.CounterOpts{
+		Namespace: "core",
+		Subsystem: "tracker2",
+		Name:      "participation_total",
+		Help:      "Total number of successful participations by peer and duty type",
+	}, []string{"duty", "peer"})
+
+	failedCounter = promauto.NewCounterVec(prometheus.CounterOpts{
+		Namespace: "core",
+		Subsystem: "tracker2",
+		Name:      "failed_duties_total",
+		Help:      "Total number of failed duties by type",
+	}, []string{"duty"})
+
+	unexpectedEventsCounter = promauto.NewCounterVec(prometheus.CounterOpts{
+		Namespace: "core",
+		Subsystem: "tracker2",
+		Name:      "unexpected_events_total",
+		Help:      "Total number of unexpected events by peer",
+	}, []string{"peer"})
+
+	inconsistentCounter = promauto.NewCounterVec(prometheus.CounterOpts{
+		Namespace: "core",
+		Subsystem: "tracker2",
+		Name:      "inconsistent_parsigs_total",
+		Help:      "Total number of duties that contained inconsistent partial signed data by duty type",
+	}, []string{"duty"})
+)