Add a readme about feature metered for sp-utils (#8736)

This commit is contained in:
Roman Proskuryakov
2021-05-05 15:33:52 +00:00
committed by GitHub
parent 68a740c071
commit 7c3a3f79ba
2 changed files with 35 additions and 1 deletions
+17
View File
@@ -16,6 +16,23 @@
// limitations under the License.
//! Utilities Primitives for Substrate
//!
//! # Features
//!
//! ## metered
//!
//! This feature changes the behaviour of the function `mpsc::tracing_unbounded`.
//! With the disabled feature this function is an alias to `futures::channel::mpsc::unbounded`.
//! However, when the feature is enabled it creates wrapper types to `UnboundedSender<T>`
//! and `UnboundedReceiver<T>` to register every `send`/`received`/`dropped` action happened on
//! the channel.
//!
//! Also this feature creates and registers a prometheus vector with name `unbounded_channel_len` and labels:
//!
//! | Label | Description |
//! | ------------ | --------------------------------------------- |
//! | entity | Name of channel passed to `tracing_unbounded` |
//! | action | One of `send`/`received`/`dropped` |
pub mod metrics;
pub mod mpsc;