github.com/celestiaorg/celestia-node@v0.15.0-beta.1/das/stats.go

package das

// SamplingStats collects information about the DASer process.
type SamplingStats struct {
	// all headers before SampledChainHead were successfully sampled
	SampledChainHead uint64 `json:"head_of_sampled_chain"`
	// all headers before CatchupHead were submitted to sampling workers. They could be either already
	// sampled, failed or still in progress. For in progress items check Workers stat.
	CatchupHead uint64 `json:"head_of_catchup"`
	// NetworkHead is the height of the most recent header in the network
	NetworkHead uint64 `json:"network_head_height"`
	// Failed contains all skipped headers heights with corresponding try count
	Failed map[uint64]int `json:"failed,omitempty"`
	// Workers has information about each currently running worker stats
	Workers []WorkerStats `json:"workers,omitempty"`
	// Concurrency amount of currently running parallel workers
	Concurrency int `json:"concurrency"`
	// CatchUpDone indicates whether all known headers are sampled
	CatchUpDone bool `json:"catch_up_done"`
	// IsRunning tracks whether the DASer service is running
	IsRunning bool `json:"is_running"`
}

type WorkerStats struct {
	JobType jobType `json:"job_type"`
	Curr    uint64  `json:"current"`
	From    uint64  `json:"from"`
	To      uint64  `json:"to"`

	ErrMsg string `json:"error,omitempty"`
}

// totalSampled returns the total amount of sampled headers
func (s SamplingStats) totalSampled() uint64 {
	var inProgress uint64
	for _, w := range s.Workers {
		// don't count recent jobs, since heights they are working on are after catchup head
		if w.JobType != recentJob {
			inProgress += w.To - w.Curr + 1
		}
	}
	return s.CatchupHead - inProgress - uint64(len(s.Failed))
}

// workersByJobType returns a map of job types to the number of workers assigned to those types.
func (s SamplingStats) workersByJobType() map[jobType]int64 {
	workers := make(map[jobType]int64)
	for _, w := range s.Workers {
		workers[w.JobType]++
	}
	return workers
}