groupcache 0.3.0

groupcache is a distributed caching and cache-filling library, intended as a replacement for a pool of memcached nodes in many cases. It shards by key to select which peer is responsible for that key.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

//! metrics module contains metric names along with description what each metric counts.
//!
//!
//! Metrics are exported via `metrics` create.
//! It's up to the application to ingest these metrics, some options:
//! - `metrics-exporter-prometheus`,
//! - `axum-prometheus`.
//!
//! For meaning of each metric, see below.

/// Any GET request, including from peers.
pub(crate) const METRIC_GET_TOTAL: &str = "groupcache_get_total";

/// GETs that came over the network from peers.
pub(crate) const METRIC_GET_SERVER_REQUESTS_TOTAL: &str = "groupcache_get_server_requests_total";

/// Local cache hit (without going over the network or loading a value using [crate::groupcache::ValueLoader]).
pub(crate) const METRIC_LOCAL_CACHE_HIT_TOTAL: &str = "groupcache_local_cache_hit_total";

/// Total calls to [`crate::groupcache::ValueLoader::load`]
pub(crate) const METRIC_LOCAL_LOAD_TOTAL: &str = "groupcache_local_load_total";

/// Total number of failures of [`crate::groupcache::ValueLoader::load`]
pub(crate) const METRIC_LOCAL_LOAD_ERROR_TOTAL: &str = "groupcache_local_load_errors";

/// Total number of remote GETs:
/// - peer is not the owner and needs to make HTTP request to the owner for a given key.
pub(crate) const METRIC_REMOTE_LOAD_TOTAL: &str = "groupcache_remote_load_total";

/// Total number of remote GET failures.
pub(crate) const METRIC_REMOTE_LOAD_ERROR: &str = "groupcache_remote_load_errors";