Differences between current version and revision by previous author of JFFNMSExtension.
Other diffs: Previous Major Revision, Previous Revision, or view the Annotated Edit History
| Newer page: | version 4 | Last edited on Friday, March 5, 2004 5:33:52 pm | by JamieCurtis | |
| Older page: | version 2 | Last edited on Friday, March 5, 2004 4:47:39 pm | by PerryLorier | Revert |
@@ -8,14 +8,42 @@
Unfortunatly the user interface for JFFNMS could do with some work, and the documentation is not much better.
For my application I wanted to monitor a new SNMP based temperature and humidity sensor (http://dcf.sk/microweb/snmpmain.html) we purchased.
-This assumes that you have got JFFNMS installed and working correctly, and that you have some understanding of how to write PHP and how SNMP works.
+This assumes that you have got JFFNMS installed and working correctly, and that you have some understanding of how to write PHP and how SNMP works. This is based off of version .7.5 of JFFNMS. Earlier versions have a different UI and way to edit the fields
.
Some JFFNMS terms:
* Interface - The basic unit which you can monitor. An obvious example is a port in a router. An interface may have multiple statistics gathered about it. (Eg. packet loss rates, bytes in, bytes out). However an interface might be something like a disk, or a temperature sensor
* Host - An entity that contains interfaces. You define the IP address to talk to and the community string to use at a host level.
* Interface Type - A type of interface, a host may contain multiple instances of each interface type. (Eg. physical_interface, temperature sensor)
+** Each statistic or bit of info gatered about an Interface Type is called an Interface Type Field
* Poller - A script that when given a paramerter (what to poll) will return a single value. (Eg. There is a single snmp poller which when passed an OID will return it's current value)
* Poller Item - A defination of how to get a specific parameter for an Interface by using a poller (Eg. The "Bytes In" poller item uses the snmp poller and provides it the OID to fetch the bytes in value for a specific interface.)
* Poller Group - A group of poller items which collect and store all the stats relating to an Interface Type.
+* Graph Type - For each Interface Type you will need a Graph Type to graph each statistic you are collecting about that Interface.
+
+
+There are actually inter dependencies when creating these things, so you have to create them in a specific order, and often have to go back and add bits once you have created more stuff.
+
+You also will probably have to write some scripts, such as an auto discovery script and perhaps a custom poller and/or a custom grapher. More about those later.
+
+__Web Configuration__
+
+This section details the configuration you need to do using the web frontend to add a new custom Interface type.
+
+Goto Administration -> Internal Configuration -> Polling and Discovery -> Interface Types
+
+Click Add
+
+The fields are as follows:
+
+* Description - Name of the Interface Type
+* AD Enabled - Is auto discovery enabled for this interface type. If it is not, JFFNMS will never go looking for this type of interface either when auto discovery is set for a host or when you use the WYSIWYG interface selector.
+* Validate in AD - ??
+* AD Function - The name of the Auto Discovery script - leave it set to none until you have written you AD script (see later section).
+* AD Paramaters - Parameters passed to the AD script, allows you to use the same AD script for multiple different Interface Types by passing differnt param's
+* AD Default Poller - The default poller used to poll for data for this interface type. Leave it set to No Poller until you have created your poller
+* Internal Update Handler - ??
+* Break by Card - Allows you to split interfaces based on the card (read big routers here) the interface is on. Not sure how it works.
+* Have Graph - Leave unchecked until you have a graph type configured
+* RRD options - Leave until your graph stuff is sorted.
