tenox7 / ttg

Display SNMP bandwidth usage similar to ping(1) output

SNMP Text Traffic Grapher

TTG is a small command line utility that displays current throughput (bandwidth usage) on an interface of a remote device such as router, switch, firewall, etc., over SNMP. You can think of TTG as command line version of STG or a high-interval/ad-hoc query/test tool for MRTG, etc. The output is very similar to ping(1) command. You can use it to quickly check/measure traffic before waiting 5 minute cycle when configuring MRTG, as a means of using the data in text form (eg. copy&paste in to an email or spreadsheet) or just a general purpose command line network administration aid.

TTG allows you to specify: SI prefix k/M/G (default is auto), units bits/bytes (b/B), size of "kilo" which can be either 1000 or 1024 depending on a personal opinion (default is 1000), interval in seconds and count limit. Finally the utility also allows you to list all interfaces of the device and can take interface name, such as "FastEthernet1/1" or it's abbreviation ("fa1/1") instead of OID name/number as the parameter.

Downloads

snap install ttg

For other platforms go to releases tab

FAQ:

Q: I get zero values every second line of output or more often, or inaccurate readings, eg:

  [11:38:16] current throughput: in 40.8 Mb/s out 39.3 Mb/s
  [11:38:26] current throughput: in 0.0 Mb/s out 0.0 Mb/s
  [11:38:36] current throughput: in 40.9 Mb/s out 39.4 Mb/s
  [11:38:46] current throughput: in 0.0 Mb/s out 0.0 Mb/s

A: Increase the polling interval (option -i) till high enough. Some agents may require even 60 seconds or higher.

On Cisco IOS you can try this:

(config) # snmp-server cache interval 1

If your agent is Net-SNMP try this:

$ snmpset -c private -v 1 x.x.x.x 1.3.6.1.4.1.8072.1.5.3.1.2.1.3.6.1.2.1.2.2 i 1

Q: On Windows I get a lot of weird virtual interface names when using list?

A: Use listphy or lp argument instead. Extended mode -x required.

Q: Where does the OpenVMS Net-SNMP port come from?

A: Tanks to Siemens AG from here.

Q: Why doesn't TTG use ISO/IEC 80000 notation?

A: Because MiB stands for Men in Black also this

ttg's Issues

add man page

Print statistics and continue on CTRL+BREAK

as ping program doing. Implementing such feature will be usefull. Now such keys combination terminate program print nothing...

error: (noSuchName) There is no such variable name in this MIB. on windows

add makefile

Refactor list command

TTG.exe crash if program is terminated by CTRL+C before display first line of data [-i 10]

Tested on Windows 7, 32 and 64bit, WXP 32bit and W10 64bit

Podpis problému:
Název události problému: APPCRASH
Název aplikace: ttg.exe
Verze aplikace: 0.0.0.0
Časové razítko aplikace: 00000000
Název chybného modulu: ttg.exe
Verze chybného modulu: 0.0.0.0
Časové razítko chybného modulu: 00000000
Kód výjimky: c0000094
Posun výjimky: 0005a883
Verze operačního systému: 6.1.7601.2.1.0.768.3
ID národního prostředí: 1029

Support SNMP v2 GETBULK

Print statistics on network error

I case of network error, ttg only print errormesage now. Print statistics prior errormessage will be usefull.

Improve handling "Error in packet Reason: (noSuchName)" situation

Rare case: Two network devices have (accidentaly) same IP addres and SNMP community, one support 64bit counters but second one dont.

Reading packets from 64bit conuter aware device, but (probably) ARP table record expires and device supported only 32bit counters is queried with -x parameter and get error. SNMPGET display "Error in packet
Reason: (noSuchName) There is no such variable name in this MIB. Failed object: .1.3.6.1.2.1.31.1.1.1.10.2" in such situation, but TTG computate with 0 in this case which usually give non-sence results.

Shouldnt be better to terminate TTG with corresponding error message and exitcode?

add actual graphing function using ttyplot

FreeBSD precompiled binary does not start

Probably, FreeBSD binary is built for an old FreeBSD version - it does not start on FreeBSD 12.2 x64:

% ./ttg
ld-elf32.so.1: Shared object "libc.so.6" not found, required by "ttg"
% ls /lib/libc.so.*
/lib/libc.so.7