About remstats
  Release Notes
  FAQ
  Conventions
  Prerequisites
  Installation
  Configuration
  Configuration Tools
  Servers
  Collectors
      cisco-access-server-collector
      dbi-collector
      dns-collector
      error-collector
      log-collector
      nt-status-collector
      ntop-collector
      ping-collector
      port-collector
      program-collector
      remoteping-collector
      snmp-collector
      snmp-route-collector
      unix-status-collector
  Updater
  Monitors
  pagemakers
  run-remstats2
  CGIs
  troubleshooting
  do-traceroutes
  Miscellany
  Thank-you
  Index

Remstats was written by Thomas Erskine at the CRC in Canada and now looking for work.

	host timestamp variable value

	host timestamp variable:instance value

Having all the collectors using a standard form permits a single updating program, updater, to process the data from them all, and also means that I can write a new collector without needing to change the updater.

• log-collector - gets info from remote log-files
• ping-collector - pings hosts
• port-collector - checks on remote services
• program-collector - runs arbitrary commands to collect info
• remoteping-collector - pings hosts from somewhere else
• unix-status-collector - gets info from unix hosts
• snmp-collector - gets info via SNMP
• snmp-route-collector - counts routes available from BGP peers

The usual invocation of a collector (via run-remstats) is:

	xxx-collector | updater xxx

1. it must write its results to stdout in standard form (see the top of this file.)
2. it must be placed in the same directory with the rest of the collectors, and must be called XXX-collector, replacing "XXX" with whatever it's collecting.
3. it must take (or at least ignore), the same arguments that the other collectors do, specificly, the -f, -u and -F flags, and the -G and -H flags, if I ever get around to implementing them (see todo).
4. you must add it to the list of collectors (the collectors line in the general config-file ).
5. you must define rrd(s) specifying "source XXX" to use the data from this collector.
6. you must add "rrd YYY" to the appropriate host config-files.

There is a supplied skeleton-collector.pl file supplied with the distribution, which does everything except collect data. You should be able to plug your code into its collect_host routine and have a collector, if you don't mind writing in perl.