vpp/extras/vpp_if_stats

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. _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 cant 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>`__