Arista CloudVision Telemetry Input Plugin

This is a external plugin for Telegraf to pull telemetry data from all Arista EOS devices running within CloudVision portal.

The plugin is currently in beta and being tested by various users. Use at your own risk and please report any issues that arise

Summary

The Arista CloudVision Telemetry External Input Plugin allows for a operator to use the gNMI gRPC interface to stream telemetry data from CloudVision portal with telegraf. CloudVision exports every device with the serial as the gNMI Path Target so when a client connects to a single address of CloudVision the device that it is interest is then distinguished based off of the path target. Telegraf will ask CloudVision for the inventory of devices via the resource apis once returned to telegraf it will then try to stream every devices paths which are specified.

A valid service token is required for each CloudVision subscription.

EOS Switch Device configuration

Every switch must be connected to cvp through terminattr and must leverage the new -cvgnmi flag for example

daemon TerminAttr
   exec /usr/bin/TerminAttr -ingestgrpcurl=CVPIPADDRESS:9910 -cvcompression=gzip -ingestauth=key, -smashexcludes=ale,flexCounter,hardware,kni,pulse,strata -cvgnmi -ingestexclude=/Sysdb/cell/1/agent,/Sysdb/cell/2/agent -taillogs
   no shutdown

Every switch need to have the gNMI interface running.

management api gnmi
   transport grpc default

verification

switch1#show management api gnmi
Transport: default
Enabled: yes
Server: running on port 6030, in default VRF
SSL profile: none
QoS DSCP: none
Authorization required: no
Accounting requests: no
Certificate username authentication: no
Notification timestamp: last change time
Listen addresses: ::

Configuration

[[inputs.arista_cloudvision_telemtry]]
  ## CVP Address
  addresses = "10.255.35.170:8443"
  ## redial in case of failures after
  redial = "10s"

  enable_tls = false

  ## cvp service account access token generated at /cv/settings/aaa-service-accounts
  cvptoken = "-snip-"

  [[inputs.arista_cloudvision_telemtry.subscription]]
    ## Name of the measurement
    name = "System"
    origin = "openconfig"
    path = "/interfaces/interface/state/counters"
    subscription_mode = "target_defined"

Example Output

/system/config/hostname,host=DC1-LEAF1A,host-id=SN-DC1-LEAF1A /system/config/hostname="DC1-LEAF1A" 1656336056235063297
/system/config/hostname,host=DC1-SPINE1,host-id=ABC12345678 /system/config/hostname="DC1-SPINE1" 1656336055710900677
/system/config/hostname,host=DC1-L2LEAF2A,host-id=SN-DC1-L2LEAF2A /system/config/hostname="DC1-L2LEAF2A" 1656336066676127908
/system/config/hostname,host=DC1-LEAF2B,host-id=SN-DC1-LEAF2B /system/config/hostname="DC1-LEAF2B" 1656336056822297422
/system/config/hostname,host=DC1-SPINE2,host-id=SN-DC1-SPINE2 /system/config/hostname="DC1-SPINE2" 1656336160090622662
/system/config/hostname,host=DC1-L2LEAF1A,host-id=SN-DC1-L2LEAF1A /system/config/hostname="DC1-L2LEAF1A" 1656336076016108686
/system/config/hostname,host=DC1-LEAF1B,host-id=SN-DC1-LEAF1B /system/config/hostname="DC1-LEAF1B" 1656336055690373742

Installation

Clone the repo

git clone https://github.com/arista-netdevops-community/Telegraf-Cloudvision-Telemetry

Build the "arista-cloudvision-telemetry" binary

$ make

Set the permission appropriately.

sudo chmod u+x arista_cloudvision_telemetry && sudo chmod 700 arista_cloudvision_telemetry

You can now execute and potentially try this on your own without telegraf for some verbosity before trying within telegraf.

./arista_cloudvision_telemetry --config sample.conf

You should be able to call this from telegraf now using execd
```
telegraf --config sample.conf
```

Sample Data

/interfaces/interface/state/counters/in_octets,host=DC1-LEAF2B,host-id=SN-DC1-LEAF2B,name=Management1 /interfaces/interface/state/counters/in_octets=45232345i 1672776243495455764
/interfaces/interface/state/counters/in_pkts,host=DC1-LEAF2B,host-id=SN-DC1-LEAF2B,name=Management1 /interfaces/interface/state/counters/in_pkts=228184i 1672776243495455764
/interfaces/interface/state/counters/in_unicast_pkts,host=DC1-LEAF2B,host-id=SN-DC1-LEAF2B,name=Management1 /interfaces/interface/state/counters/in_unicast_pkts=228184i 1672776243495455764
/interfaces/interface/state/counters/out_octets,host=DC1-LEAF2B,host-id=SN-DC1-LEAF2B,name=Management1 /interfaces/interface/state/counters/out_octets=36872275i 1672776243495455764
/interfaces/interface/state/counters/out_pkts,host=DC1-LEAF2B,host-id=SN-DC1-LEAF2B,name=Management1 /interfaces/interface/state/counters/out_pkts=258831i 1672776243495455764
/interfaces/interface/state/counters/out_unicast_pkts,host=DC1-LEAF2B,host-id=SN-DC1-LEAF2B,name=Management1 /interfaces/interface/state/counters/out_unicast_pkts=258831i 1672776243495455764

This self-contained plugin is based on the documentations of Execd Go Shim

aristanetworks / telegraf-cloudvision

readme