.. _if_stats_client_doc:
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
--------
.. code:: bash
go get git.fd.io/govpp.git
go build
Using (post-build for example on linux 64bit)
---------------------------------------------
.. code:: bash
./bin/vpp_if_stats_linux_amd64
Output examples
---------------
`JSON schema <./response_schema.json>`__
`Example <./response_example.json>`__