lanz

README

Arista LANZ Consumer Input Plugin

This plugin provides a consumer for use with Arista Networks’ Latency Analyzer (LANZ)

Metrics are read from a stream of data via TCP through port 50001 on the switches management IP. The data is in Protobuffers format. For more information on Arista LANZ

• https://www.arista.com/en/um-eos/eos-latency-analyzer-lanz

This plugin uses Arista's sdk.

• https://github.com/aristanetworks/goarista

Configuration

# Read metrics off Arista LANZ, via socket
[[inputs.lanz]]
  ## URL to Arista LANZ endpoint
  servers = [
    "tcp://switch1.int.example.com:50001",
    "tcp://switch2.int.example.com:50001",
  ]

You will need to configure LANZ and enable streaming LANZ data.

• https://www.arista.com/en/um-eos/eos-section-44-3-configuring-lanz
• https://www.arista.com/en/um-eos/eos-section-44-3-configuring-lanz#ww1149292

Metrics

For more details on the metrics see https://github.com/aristanetworks/goarista/blob/master/lanz/proto/lanz.proto

• lanz_congestion_record:

  • tags:
    • intf_name
    • switch_id
    • port_id
    • entry_type
    • traffic_class
    • fabric_peer_intf_name
    • source
    • port
  • fields:
    • timestamp (integer)
    • queue_size (integer)
    • time_of_max_qlen (integer)
    • tx_latency (integer)
    • q_drop_count (integer)

• lanz_global_buffer_usage_record

  • tags:
    • entry_type
    • source
    • port
  • fields:
    • timestamp (integer)
    • buffer_size (integer)
    • duration (integer)

Sample Queries

Get the max tx_latency for the last hour for all interfaces on all switches.

SELECT max("tx_latency") AS "max_tx_latency" FROM "congestion_record" WHERE time > now() - 1h GROUP BY time(10s), "hostname", "intf_name"

Get the max tx_latency for the last hour for all interfaces on all switches.

SELECT max("queue_size") AS "max_queue_size" FROM "congestion_record" WHERE time > now() - 1h GROUP BY time(10s), "hostname", "intf_name"

Get the max buffer_size for over the last hour for all switches.

SELECT max("buffer_size") AS "max_buffer_size" FROM "global_buffer_usage_record" WHERE time > now() - 1h GROUP BY time(10s), "hostname"

Example output

lanz_global_buffer_usage_record,entry_type=2,host=telegraf.int.example.com,port=50001,source=switch01.int.example.com timestamp=158334105824919i,buffer_size=505i,duration=0i 1583341058300643815
lanz_congestion_record,entry_type=2,host=telegraf.int.example.com,intf_name=Ethernet36,port=50001,port_id=61,source=switch01.int.example.com,switch_id=0,traffic_class=1 time_of_max_qlen=0i,tx_latency=564480i,q_drop_count=0i,timestamp=158334105824919i,queue_size=225i 1583341058300636045
lanz_global_buffer_usage_record,entry_type=2,host=telegraf.int.example.com,port=50001,source=switch01.int.example.com timestamp=158334105824919i,buffer_size=589i,duration=0i 1583341058300457464
lanz_congestion_record,entry_type=1,host=telegraf.int.example.com,intf_name=Ethernet36,port=50001,port_id=61,source=switch01.int.example.com,switch_id=0,traffic_class=1 q_drop_count=0i,timestamp=158334105824919i,queue_size=232i,time_of_max_qlen=0i,tx_latency=584640i 1583341058300450302

Documentation

Index

• type Lanz
  • func NewLanz() *Lanz
  • func (l *Lanz) Gather(_ telegraf.Accumulator) error
  • func (*Lanz) SampleConfig() string
  • func (l *Lanz) Start(acc telegraf.Accumulator) error
  • func (l *Lanz) Stop()

Types

type Lanz

type Lanz struct {
	Servers []string `toml:"servers"`
	// contains filtered or unexported fields
}

func NewLanz

func NewLanz() *Lanz

func (*Lanz) Gather

func (l *Lanz) Gather(_ telegraf.Accumulator) error

func (*Lanz) SampleConfig

func (*Lanz) SampleConfig() string

func (*Lanz) Start

func (l *Lanz) Start(acc telegraf.Accumulator) error

func (*Lanz) Stop

func (l *Lanz) Stop()