nagios-tang.1.adoc 1.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. nagios-tang(1)
  2. ==============
  3. :doctype: manpage
  4. == NAME
  5. nagios-tang - A Nagios plugin for Tang
  6. == SYNOPSIS
  7. *tang* -u URL
  8. == OVERVIEW
  9. This Nagios plugin for Tang enables Nagios to monitor a Tang server for its
  10. basic functionality as well as performance metrics. The plugin is executed
  11. simply by providing the base URL to the Tang service.
  12. The plugin will test the following functionality:
  13. 1. Downloading the advertisement.
  14. 2. Verification of advertisement semantics.
  15. 3. Verification of signatures for all advertised signing keys.
  16. 4. Verification of key exchanges for all advertised exchange keys.
  17. If any of these tests fail, an error will be generated. Upon success, the
  18. plugin will output the following performance metrics:
  19. * *adv* : Time it took to fetch the advertisement (in μs).
  20. * *exc* : Average time of all key exchange operations (in μs).
  21. * *nkeys* : Number of keys in the advertisement.
  22. * *nsigk* : Number of signing keys in the advertisement.
  23. * *nexck* : Number of exchange keys in the advertisement.
  24. == EXAMPLES
  25. A simple test against a localhost Tang server:
  26. $ ./tang -u http://localhost/
  27. OK|adv=21430 exc=44587 nkeys=2 nsigk=1 nexck=1
  28. == AUTHOR
  29. Nathaniel McCallum <npmccallum@redhat.com>
  30. == SEE ALSO
  31. link:tang.8.adoc[*tang*(8)]