Updating Generic SNMP OID Doco

Author: TheWitness

Graph-a-Single-SNMP-OID.md

@@ -1,17 +1,34 @@
-# Graph a Single SNMP OID
+# Creating a Graph for a Single SNMP OID
 
-When dealing with SNMP-enabled devices, there are often times when you want to
+When dealing with SNMP-enabled **Devices**, there are often times when you want to
 graph the value of a single OID. This tutorial explains how to do this in
-Cacti. It also assumes that you have the "SNMP - Generic OID Template" graph
-template, which is now included in Cacti as of version 0.8.5. If you do not see
-this template listed under Graph Templates, download the template from the
-Cacti website in XML form and import it using the Import Templates menu item.
+Cacti. It also assumes that you have the "SNMP - Generic OID Template" **Graph
+Template** which is available in the **Generic SNMP Device Package**. 
+If you do not see this **Graph Template** listed under **Graph Templates**, 
+install the **Generic SNMP Device Package** using the `import_package.php`
+command line script located in Cacti's cli directory.
 
-To start the process of creating a new graph for your OID, click the New Graphs
-menu item and select the host that contains the target OID from the dropdown.
-Under the Graph Templates box, you will see a dropdown on the last line that
-reads (Select a graph type to create). From this dropdown, choose "SNMP -
-Generic OID Template" and click the Create button at the bottom of the page.
+To start the process of creating a new graph for your OID, click go to
+`Cosnole > Create > New Graphs`, and from there find the **Device**
+you would like to add the **Graph** to.
+
+From the image below, you can see the **New Graphs** interface.
+
+![Graphs New](images/graphs-new.png)
+
+In this image, only the "Graph Template Based` **Graph Templates** are displayed.
+Had the `Graph Types` been switched to any of the **Data Query** based ``Graph Types``
+the interface would look a bit different.
+
+From that Interface, to create a `Generic SNMP OID` based Graph, you need to first
+select it from the `Select a graph type to create` drop-down.  Once you have selected
+it, you may press the `Create` button, at which point in time, you will see the
+image below.
+
+![Graphs New](images/graphs-new-generic-oid.png)
+
+From this interface, you must define various attributes for your resulting **Graph**
+as shown in the table below.
 
 ###### Table 10-1. Field Description: SNMP - Generic OID Template
 
@@ -27,16 +44,24 @@ Name | Description
 (Data Source) Data Source Type [snmp_oid] | How the data from the OID should be stored by RRDTool and interpreted on the graph. If the value of the OID represents the actual data, you should use GAUGE for this field. If the OID value is a constantly incremented number, you should use COUNTER for this field. The two remaining field values, DERIVE and ABSOLUTE can be ignored in most situations.
 (Custom Data) OID | The actual SNMP OID to graph. It is typically a good idea to enter the number OID here as opposed to using MIB names. For instance, to get the number of open files on a Netware server, you would use ".1.3.6.1.4.1.23.2.28.2.7.0" as the OID.
 
-You will be presented with several fields that will require input before the
-new graph can be created. They are described in more detail below.
+So, based upon your specific OID that you are graphing, You will need to fill out these
+fields before the new graph can be created properly.
 
 When finished filling in values for these fields, click the Create button. Your
-new graph can now be accessed through the Graph Management page or the Graphs
-tab inside of Cacti.
+new **Graph** can now be accessed through the `Cosole > Management > Graphs` menu pick.
+
+> **NOTE**: When comparing the Table above, to the image, you will see that the 
+> `Opacity/Alpha Channel` pick is missing from the interface.  To add it, you simply need
+> to edit the `Generic SNMP OID` **Graph Template**, add a new **Graph Item Input** 
+> override to the Alpha/Opacity on the Graph Template as shown below.  We will cover
+> that topic in the **Graph Template** section of the manual though.
+
+![Graphs New](images/graphs-new-generic-oid-alpha.png)
+
 
-#### Note on graphing single OID's with spine
+#### Important Note on graphing single OID's with Cacti
 
-In order to ensure that Spine will process single OID's correctly,
+In order to ensure that Spine and cmd.php will process single OID's correctly,
 They should be written using numeric format separated by dots, such as `1.3.6.1.4.1.9.9.97.`
 At this time, ASN's (named OID's) such as `enterprise.9.9.97` (Cisco Switch) or
 `enterprises.cisco.ciscoMgnt.ciscoSwitchEngineMIB` are not supported.