From 4c83442e174b186f5ee22bc8744cc7cc2a890e13 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Tue, 15 Oct 2024 20:31:04 -0700 Subject: Stats API converted to mdbook. A number of small errors were fixed, and we tried to restructure this to be a bit more usable to readers. --- docs/ref/api/stat/index.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/ref/api/stat/index.md (limited to 'docs/ref/api/stat/index.md') diff --git a/docs/ref/api/stat/index.md b/docs/ref/api/stat/index.md new file mode 100644 index 00000000..9bdceb55 --- /dev/null +++ b/docs/ref/api/stat/index.md @@ -0,0 +1,23 @@ +# Statistics + +To facilitate debugging and support situations, the _NNG_ library +supports collection and reporting of numerous statistics. + +These statistics are organized in a tree, and include both values, +and metadata describing the statistics. In order to be efficient and +minimize the impact of maintaining statistics, an explicit snapshot +of statistics must be taken, and that snapshot can then be processed. + +The following documentation will be useful: + +- [nng_stat](./nng_stat.md) - Single statistic +- [nng_stats](./nng_stats.md) - Statistics snapshot + +> [!NOTE] +> The presence, name, and semantics of any given statistic are +> subject to change at any time and without notice. +> Programmatic use is therefore discouraged. + +> [!NOTE] +> Statistics may be disabled by build-time configuration options, +> in order to reduce program size and run-time overheads. -- cgit v1.2.3-70-g09d2