report

Documentation

Index

• type BlockStore
• type DataPoint
• type Report
• type Reports
  • func GenerateFromBlockStore(s BlockStore) (*Reports, error)
  • func (rs *Reports) ErrorCount() int
  • func (rs *Reports) List() []Report

Types

type BlockStore

type BlockStore interface {
	Height() uint64
	Base() uint64
	LoadBlock(uint64) (*types.Block, error)
}

BlockStore defines the set of methods needed by the report generator from Tendermint's store.Blockstore type. Using an interface allows for tests to more easily simulate the required behavior without having to use the more complex real API.

type DataPoint

type DataPoint struct {
	Duration  time.Duration
	BlockTime time.Time
	Hash      []byte
}

DataPoint contains the set of data collected for each transaction.

type Report

type Report struct {
	ID                      uuid.UUID
	Rate, Connections, Size uint64
	Max, Min, Avg, StdDev   time.Duration

	// NegativeCount is the number of negative durations encountered while
	// reading the transaction data. A negative duration means that
	// a transaction timestamp was greater than the timestamp of the block it
	// was included in and likely indicates an issue with the experimental
	// setup.
	NegativeCount int

	// TPS is calculated by taking the highest averaged TPS over all consecutive blocks
	TPS uint64

	// All contains all data points gathered from all valid transactions.
	// The order of the contents of All is not guaranteed to be match the order of transactions
	// in the chain.
	All []DataPoint
	// contains filtered or unexported fields
}

Report contains the data calculated from reading the timestamped transactions of each block found in the blockstore.

type Reports

type Reports struct {
	// contains filtered or unexported fields
}

Reports is a collection of Report objects.

func GenerateFromBlockStore

func GenerateFromBlockStore(s BlockStore) (*Reports, error)

GenerateFromBlockStore creates a Report using the data in the provided BlockStore.

func (*Reports) ErrorCount

func (rs *Reports) ErrorCount() int

ErrorCount returns the number of erronous transactions encountered while creating the report

func (*Reports) List

func (rs *Reports) List() []Report

List returns a slice of all reports.