ifGraph 0.3.5 - 15/01/2002 - Ricardo Sartori <sartori@duosite.com.br>

Requerimentos:
 - Perl >= 5.0 (http://www.perl.org)
 - Modulo da Net::SNMP Perl (http://search.cpan.org/search?dist=Net-SNMP)
 - RRDTool >= 1.3.32 (http://ee-staff.ethz.ch/~oetiker/webtools/rrdtool/)

Passos para usar o ifGraph 0.3.5:
=================================

1 - Procure pelas interfaces que voce deseja monitorar usando o comando
find-if.pl. Digamos que voce queira monitorar alguma interface do host
algum.host.com.br, mas nao sabe qual, voce deve usar o comando assim:

otherhost 35$ ./find-if.pl algum.host.com.br
OK: session created, getting info from algum.host.com.br
Showing up interfaces of: algum.host.com.br
Interface total: 5
OK: Collecting info on each interface, wait...
......
OK: Data collected
System Description: Linux algum.host.com.br 2.4.13 #4 SMP Mon Nov 5 16:03:28 BRST 2001 i586
System Uptime: 1 day, 01:12:14.46
| if # | Description            | Stat | Octets In     | Errors  | Octets Out    | Errors |
-------------------------------------------------------------------------------------------
| (1)  | eth0                   | up   | 2421689163    | 278     | 3024455811    | 26     |
| (2)  | eth1                   | up   | 4046770442    | 14118   | 3653663255    | 1      |
| (4)  | lo0                    | up   | 1085194330    | 0       | 1085197143    | 0      |

2 - Essas sao as interfaces ativas do host. Voce deve escolher quais delas
voce quer monitorar. Anote o numero (campo if #) das que voce selecionou.

3 - Edite o arquivo de configuracao ifgraph.conf. Voce deve setar corretamente
as diretivas rrdtool, rrddir e graphdir. Feito isto, configure quais
interfaces de quais hosts voce deseja monitorar. Suponha que voce queira
monitorar a interface 2 do host algum.host.com.br. A linha de configuracao
seria algo assim:

	algum.host.com.br:public:161:2:100M:Link1

Se voce deseja utilizar as opcoes que foram adicionadas na versao 0.3.4 do ifgraph, basta utilizar a
seguinte linha padrao:

	algum.host.com.br:public:161:2:100M:Link1:opcoes

   As seguintes opcoes podem ser adicionadas na linha de configuracao da interface:
   h=N - altura do grafico, nao da imagem
   w=N - largura do grafico, nao da imagem
   in=#RRGGBB - a cor (em hexadecimal) que vai ser aplicada na area que representa os dados que entram
   out=#RRGGBB - a cor (em hexadecimal) que vai ser aplicada na linha que representa os dados que saem
   bg=#RRGGBB - a cor de fundo da imagem (nao do grafico)
   canvas=#RRGGBB - a cor de fundo do grafico
   font=#RRGGBB - a cor que vai ser aplicada nas fontes da imagem
   invert - essa opcao faz com que os dados IN passem a ser plotados como OUT e vice-versa
   noerror - essa opcao faz com que sejam omitidos os dados sobre erros na interface de rede
   rigid - faz com que o valor maximo do eixo Y fique fixo no valor setado no campo "largura de banda" da interface

De modo geral, uma linha de configuracao segue o seguinte padrao:

hostname : comunidade : porta do agente : numero da interface : largura de banda: descricao [: opcoes ]

 Ex.:
 202.202.202.202:public:161:1:10M:Lan Interface:h=200,w=400,noerror,in=#333333
 203.203.203.203:comunidade:161:3:128k:Wan Interface:invert
 150.150.150.150:comunidade:161:1:100M:Ethernet Interface

4 - Apos a configuracao, voce pode comecar a utilizar o ifGraph. Ele deve ser
executado a cada 5 minutos, podendo ser ajustado para rodar na sua cron. Para
adicionar o programa na cron, basta executar um:

host$ crontab -e

e adicionar a seguinte linha ao seu arquivo: 
(Mude os paths para os programas e o arquivo de configuracao)
*/5 * * * * /path/to/ifgraph/ifgraph.pl -c /path/to/ifgraph.conf ; /path/to/ifgraph/makegraph.pl -c /path/to/ifgraph.conf > /dev/null
