summaryrefslogtreecommitdiffstats
path: root/extras/vpp_if_stats/README.md
diff options
context:
space:
mode:
authorKoren Lev <korenlev@gmail.com>2018-11-21 18:46:54 +0200
committerOle Trøan <otroan@employees.org>2018-11-22 06:31:30 +0000
commit19ca78fbd7567c676beefc2b511dfdcd9f20201a (patch)
tree3f5a816566e73777bc28cd50a58dbb685eabf970 /extras/vpp_if_stats/README.md
parent15e8e681813a2e88dad107b5fe238bc8abee17d2 (diff)
stats: golang vpp_if_stats_client
see README for details Change-Id: Ida603ccaee21dabc903512699b5b355cebb70320 Signed-off-by: Koren Lev <korenlev@gmail.com>
Diffstat (limited to 'extras/vpp_if_stats/README.md')
-rwxr-xr-xextras/vpp_if_stats/README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/extras/vpp_if_stats/README.md b/extras/vpp_if_stats/README.md
new file mode 100755
index 00000000000..7185d6cb5b1
--- /dev/null
+++ b/extras/vpp_if_stats/README.md
@@ -0,0 +1,35 @@
+# VPP interface stats client
+
+This is a source code and a binary of a 'thin client' to collect,
+aggregate and expose VPP interface stats through VPP stats socket API.
+It also provides some information about the installed VPP version.
+
+This can be used by monitoring systems that needs to grab those details
+through a simple executable client with no dependencies.
+
+example use case: where VPP runs in a container that can't expose the socket API to the host level
+
+
+## Prerequisites (for building)
+
+**GoVPP** library (compatible with VPP 18.10)
+vpp, vpp-api, vpp-lib
+
+## Building
+
+```bash
+go get git.fd.io/govpp.git
+go build
+```
+
+## Using (post-build for example on linux 64bit)
+
+```bash
+./bin/vpp_if_stats_linux_amd64
+```
+
+## Output examples
+
+[JSON schema](./response_schema.json)
+[Example](./response_example.json)
+