mirror of
https://github.com/ethereum/go-ethereum.git
synced 2026-05-26 17:59:29 +00:00
Populates per-block state read/write counts in slow-block JSON for BAL blocks (which #34892 left as TBD), and adds reader-level read timing. Builds on top of bal-devnet-3 — most of the PR's earlier slow-block log infrastructure was adapted into upstream by that commit, so this change is now scoped to the metric population that the BAL alone can derive. - BAL helpers: BlockAccessList.{UniqueAccountCount, UniqueStorageSlotCount, WrittenCounts}. WrittenCounts walks the BAL once and returns the block-aggregate write counts. - Reader-level read timing: *reader times all synchronous Account/Storage/ Code/CodeSize calls via atomic counters; exposed via ReadTimes() ReadDurations and the new state.ReadTimer interface. Replaces StateDB- level AccountReads/StorageReads/CodeReads tracking (the StateDB shouldn't time its dependencies — the reader is where the I/O happens). - Reader-level code-load dedup: *reader.codeLoaded sync.Map records the first-seen byte length per address; CodeLoads() returns (count, bytes). Exposed via state.CodeLoadTracker. Replaces StateDB CodeLoaded/ CodeLoadBytes tracking and the SnapshotCodeLoads aggregation pattern. - BALStateTransition: caches BlockAccessList.WrittenCounts() once at construction; tracks accountDeleted/storageDeleted atomics for the parallel root-pass (the BAL alone can't distinguish a selfdestruct from a balance/nonce reset). Exposes Deletions() DeletionCounts. Drops the older accountUpdated/storageUpdated/codeUpdated/codeUpdateBytes counters (now derived from WrittenCounts). - BAL block stats path (blockchain.go): populates StateCounts directly — AccountUpdated = WrittenCounts.Accounts - Deletions.Accounts (same for storage). AccountLoaded/StorageLoaded come from BAL. CodeLoaded/ CodeLoadBytes come from the shared *reader (deduplicated across phase StateDBs naturally because they share one reader instance). - Non-BAL block stats path: read durations come from the reader; counts from StateDB fields. StorageUpdated/StorageDeleted unified to int width. - Hard type assertions: state.ReadTimer / state.CodeLoadTracker / state.ReaderStater consumers use direct casts (no silent zero fallback) — every Reader chain in production satisfies these interfaces. - Meter alignment: account/storage Updated meters subtract Deletions to avoid double-reporting blocks under both Update and Delete dashboards.
101 lines
3.2 KiB
Go
101 lines
3.2 KiB
Go
// Copyright 2026 The go-ethereum Authors
|
|
// This file is part of the go-ethereum library.
|
|
//
|
|
// The go-ethereum library is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU Lesser General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// The go-ethereum library 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 Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public License
|
|
// along with the go-ethereum library. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
package state
|
|
|
|
import "time"
|
|
|
|
// ReadDurations groups cumulative read durations by category.
|
|
type ReadDurations struct {
|
|
Account time.Duration
|
|
Storage time.Duration
|
|
Code time.Duration
|
|
}
|
|
|
|
// ReadTimer exposes a Reader's cumulative read durations.
|
|
type ReadTimer interface {
|
|
ReadTimes() ReadDurations
|
|
}
|
|
|
|
// CodeLoadTracker exposes a Reader's deduplicated code-load count and bytes.
|
|
type CodeLoadTracker interface {
|
|
CodeLoads() (count, bytes int)
|
|
}
|
|
|
|
// ContractCodeReaderStats aggregates statistics for the contract code reader.
|
|
type ContractCodeReaderStats struct {
|
|
CacheHit int64 // Number of cache hits
|
|
CacheMiss int64 // Number of cache misses
|
|
CacheHitBytes int64 // Total bytes served from cache
|
|
CacheMissBytes int64 // Total bytes read on cache misses
|
|
}
|
|
|
|
// HitRate returns the cache hit rate in percentage.
|
|
func (s ContractCodeReaderStats) HitRate() float64 {
|
|
total := s.CacheHit + s.CacheMiss
|
|
if total == 0 {
|
|
return 0
|
|
}
|
|
return float64(s.CacheHit) / float64(total) * 100
|
|
}
|
|
|
|
// ContractCodeReaderStater wraps the method to retrieve the statistics of
|
|
// contract code reader.
|
|
type ContractCodeReaderStater interface {
|
|
GetCodeStats() ContractCodeReaderStats
|
|
}
|
|
|
|
// StateReaderStats aggregates statistics for the state reader.
|
|
type StateReaderStats struct {
|
|
AccountCacheHit int64 // Number of account cache hits
|
|
AccountCacheMiss int64 // Number of account cache misses
|
|
StorageCacheHit int64 // Number of storage cache hits
|
|
StorageCacheMiss int64 // Number of storage cache misses
|
|
}
|
|
|
|
// AccountCacheHitRate returns the cache hit rate of account requests in percentage.
|
|
func (s StateReaderStats) AccountCacheHitRate() float64 {
|
|
total := s.AccountCacheHit + s.AccountCacheMiss
|
|
if total == 0 {
|
|
return 0
|
|
}
|
|
return float64(s.AccountCacheHit) / float64(total) * 100
|
|
}
|
|
|
|
// StorageCacheHitRate returns the cache hit rate of storage requests in percentage.
|
|
func (s StateReaderStats) StorageCacheHitRate() float64 {
|
|
total := s.StorageCacheHit + s.StorageCacheMiss
|
|
if total == 0 {
|
|
return 0
|
|
}
|
|
return float64(s.StorageCacheHit) / float64(total) * 100
|
|
}
|
|
|
|
// StateReaderStater wraps the method to retrieve the statistics of state reader.
|
|
type StateReaderStater interface {
|
|
GetStateStats() StateReaderStats
|
|
}
|
|
|
|
// ReaderStats wraps the statistics of reader.
|
|
type ReaderStats struct {
|
|
CodeStats ContractCodeReaderStats
|
|
StateStats StateReaderStats
|
|
}
|
|
|
|
// ReaderStater defines the capability to retrieve aggregated statistics.
|
|
type ReaderStater interface {
|
|
GetStats() ReaderStats
|
|
}
|