Apply suggestions from code review

Co-authored-by: Alexander Hentschel <[email protected]>

Author: durkmurder

module/metrics.go

@@ -621,7 +621,7 @@ type CollectionMetrics interface {
 	// CollectionMaxSize measures the current maximum size of a collection.
 	CollectionMaxSize(size uint)
 
-	// ClusterBlockCreated informs about cluster block being proposed by this node.
+	// ClusterBlockCreated informs about cluster blocks being PROPOSED by THIS NODE.
 	// CAUTION: These metrics will represent a partial picture of cluster block creation across the network,
 	// as each node will only report on cluster blocks where they are the proposer.
 	ClusterBlockCreated(block *cluster.Block, priorityTxnsCount uint)

module/metrics/collection.go

@@ -16,8 +16,8 @@ type CollectionCollector struct {
 	finalizedHeight      *prometheus.GaugeVec     // tracks the finalized height
 	maxCollectionSize    prometheus.Gauge         // tracks the maximum collection size
 	guarantees           *prometheus.HistogramVec // counts the number/size of FINALIZED collections
-	collectionSize       *prometheus.HistogramVec
-	priorityTxns         *prometheus.HistogramVec
+	collectionSize *prometheus.HistogramVec // number of transactions included ONLY in the cluster blocks proposed by this node
+	priorityTxns   *prometheus.HistogramVec // number of priority transactions included ONLY in cluster blocks proposed by this node
 }
 
 var _ module.CollectionMetrics = (*CollectionCollector)(nil)