This repo demonstrates how to use a subscribe request through gRPC Network Management Interface (gNMI) in order to retrieve interface counter statistics data with open-config models. A function is provided for this endeavour. This project will expand to other data in future releases. Support for C++ is currently provided. Potential for other language support in future releases.
To get a local copy up and running follow these simple steps.
These are all provided/handled for ease of use:
User can find the specification for gNMI here:
https://github.com/openconfig/reference/blob/master/rpc/gnmi/gnmi-specification.md
User can find information regarding open-config here:
https://github.com/openconfig/public/tree/master
User can find the protos used here (Updated protos on April 22 2024): https://github.com/openconfig/gnmi/tree/master/proto Things to do: cleanup and fetch during build The commands used to get the protos were: git clone <> followed by: git checkout SHA:
git clone https://github.com/openconfig/gnmi.git
git checkout 5588964b559c9afee319909dd022b6706fe4a162User might need to add more protos in the future as dependecies for these proto files can change. The gnmi.proto file has one change made on it: import "github.com/openconfig/gnmi/proto/gnmi_ext/gnmi_ext.proto"; -> import "gnmi_ext.proto";
We use docker containers, which handles the installation of the required packages and libraries. If the user wants to run this in their own environment, then please refer to the Dockerfile for the necessary installation packages.
-
Clone the repo
git clone https://github.com/cisco-open/gnmi-client-examples.git
-
Run the docker build
cd gnmi_client make gnmi-build -
To go into docker enviornment
make app-bash
-
To remake the build with any new changes, in the docker environment
cd src make
Following the Steps mentioned in the C++ README
See the open issues for a list of proposed features (and known issues).
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions Users make are greatly appreciated. For detailed contributing guidelines, please see CONTRIBUTING.md
Distributed under the Apache License, Version 2.0 License. See LICENSE for more information.
Project Link: https://github.com/cisco-open/gnmi-client-examples
This template was adapted from https://github.com/othneildrew/Best-README-Template.