|Documentation - MRTGWebCfg|
MRTGWebCfg: How to add new host, step by step
The following steps are required for adding a host:
Step 1: Host creation
Go to Control Panel and navigate to IP Address Management, next choose Add an IP address
Fields IP Address, Description and Password are mandatory
IP Address - 127.0.0.1
Description - My HOST
Password - public
Step 2: Basic setup
Go to Control Panel, then choose Add Record and and create Basic settings for MRTG.
Select the host created in 1st step (match by ip field).
Specify title specify how to name new setting (For instance: Traffic Analysis for fxp0 on localhost)
ver_snmp - SNMP protocol version (for instance: 1 or 2)
filename - RRD file name, where MRTG data stores collected data (For instance: traffic_fxp0_localhost)
target - SNMP OID
OID values are standardized for most equipment and can be browsed by any SNMP browser.
For instance: The first server NIC defines the following OIDs:
220.127.116.11.18.104.22.168.1.1 à ifIndex -> Interface identifier
22.214.171.124.126.96.36.199.1.10 à ifInOctets -> Packets count
188.8.131.52.184.108.40.206.1.16 à ifOutOctets -> Number of packets sent
220.127.116.11.18.104.22.168.1.14.1 à ifInErrors -> Errors rate in incoming flow
22.214.171.124.126.96.36.199.1.20.1 à ifInErrors -> Errors rate in outgoing flow
Red digit states for interface number.
In general Targer filed is determined by MRTG configuration, it is supposed that SNMP and MRTG things are known for You. Target field is assembled as the following:
Target["filename"]: target:Password@IP Address
Target["traffic_fxp0_localhost "]: .188.8.131.52.184.108.40.206.1.14.1&.220.127.116.11.18.104.22.168.1.20.1:email@example.com
For SNMP v2:
Target["filename"]: target:Password@IP Address :::::2
Target["traffic_fxp0_localhost"]: .22.214.171.124.126.96.36.199.1.10&.188.8.131.52.184.108.40.206.1.16:firstname.lastname@example.org :::::2
Target["traffic_fxp0_localhost "]: .220.127.116.11.18.104.22.168.1.14.1&.22.214.171.124.126.96.36.199.1.20.1:email@example.com :::::2
Parameters interface_ip and interface_name describe the following MRTG things:
SetEnv["filename"]: MRTG_INT_IP="interface_ip" MRTG_INT_DESCR="interface_name"
SetEnv["traffic_fxp0_localhost"]: MRTG_INT_IP="127.0.0.1" MRTG_INT_DESCR="fxp0"
The rest of the parameters on Adding record page are the same as MRTG parameters. They are maxbytes, iftype, absmax, withpeak, options, colours, ylegend, shortlegend and others.
Step 3: Template management, placing graphic at the page.
Placing graphic on MRTGWebCfg is the next thing to do after the Basic settings.
Graphic information is organized by groups. The Default group always exists and new objects are placed in that group. Also Default group is displayed on the first page of MRTGWebCfg.
Groups are managed in Group Management
Next go to Template Management
Templates can be created manually by choosing proper basic settings and specifying group and page place (row and column). Also Template management - GUI can be used.
MRTG configuration file may be created after the 2nd step.
3rd step is only required for proper placing graphic on MRTGWebCfg page