ifGraph 0.3.6 - 20/02/2002 - Ricardo Sartori <sartori@lrv.ufsc.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.6:
=================================

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
   nolegend - nao serah gerado nenhum tipo de legenda nesse grafico

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: 
*/5 * * * * /path/to/ifgraph/ifgraph.pl -c /path/to/ifgraph.conf ; /path/to/ifgraph/makegraph.pl -c /path/to/ifgraph.conf > /dev/null

Os programas ifgraph.pl e makegraph.pl aceitam alguns parametros na linha
de comando:

	ifgraph:
	-h Mostra uma ajuda resumida
	-d Ativa o modo debug

	makegraph:
	-h Mostra uma ajuda resumida
	-d Ativa o modo debug
	-B Cria graficos usando a unidade de trafego como sendo Bytes
	-g Cria somente os graficos, sem nenhum HTML
