SAGE

Sistema Aberto de Gerenciamento de Energia

Conversor de Protocolo
Verso Provisria

Av. Horcio Macedo, 354 - Cidade Universitria

CEP 21941-911

Rio de Janeiro RJ

Dezembro de 2007

A informao contida neste documento de propriedade do CEPEL, tendo se originado de trabalho desenvolvido nesta
empresa para consulta e referncia dos usurios do sistema SAGE, e no poder ser reproduzida ou utilizada para
quaisquer outros fins sem autorizao prvia e expressa do CEPEL. Este documento baseia-se em informao disponvel
na data de sua publicao. Embora sejam feitos esforos para torn-lo preciso, este no se prope a cobrir todos os
detalhes ou particularidades apresentadas pelo sistema. O CEPEL no se responsabiliza por notificar os usurios deste
documento de possveis alteraes feitas posteriormente.

Contedo
INTRODUO ................................................................................. 1
CONVERSOR DE PROTOCOLOS SNMP ............................................ 3
MAPEAMENTO DE OPERAES ..................................................... 5
AQUISIO ANALGICA .........................................................................5
AQUISIO DIGITAL .............................................................................6
CONTROLE .........................................................................................6
PONTOS CALCULADOS ................................................................... 7
FILTRO .......................................................................................... 9
TABELAS ...................................................................................... 11
LSC.................................................................................................... 11
CNF ................................................................................................... 11
PAS.................................................................................................... 11
PAF.................................................................................................... 12
PDF.................................................................................................... 13
PDS.................................................................................................... 13
CGF ................................................................................................... 13
CGS ................................................................................................... 13
NV1 ................................................................................................... 13
NV2 ................................................................................................... 13
CXU ................................................................................................... 14
UTR ................................................................................................... 14
TAC ................................................................................................... 14
ENU ................................................................................................... 14
GERAO AUTOMTICA DE BASE FONTE.................................... 15
PROCEDIMENTO ................................................................................ 15

i
SAGE
Sistema Aberto de Gerenciamento de Energia

- Contedo

ii
Conversor de Protocolo
Dezembro - 2007

Introduo

O conversor de protocolo SNMP e o transportador de protocolo SNMP

permitem ao SAGE realizar monitoramento da infra-estrutura de rede e
computacional de um sistema SAGE.
Ao habilitar o conversor de protocolos SNMP em um sistema SAGE, o
SAGE passa a ter capacidade de aquisio de dados disponibilizados em
equipamentos gerenciveis como estaes SAGE, roteadores, switches,
firewall, terminal servers.

1
SAGE
Sistema Aberto de Gerenciamento de Energia

- Introduo

2
Conversor de Protocolo
Dezembro - 2007

Conversor de Protocolos SNMP

Dentre as mensagens bsicas definidas para o protocolo SNMP, trs
tipos de mensagens, GET, SET e GETNEXT, so utilizadas no SAGE.
O agente a entidade definida para atender um servio de gerncia via
SNMP.
O agente responde a mensagens GET e SET (e tambm GETNEXT)
referentes a objetos de gerncia. Estes objetos so referenciados por
estruturas-padro denominadas MIBs.
Por exemplo, como parte de uma MIB (MIB-II) est definido o objeto
SysUpTime que corresponde ao tempo de atividade de gerncia de um
equipamento. A este objeto atribuda uma referncia .1.3.6.1.2.1.1.3
que um equivalente numrico a posio de referncia em uma rvore
de objetos.
Para obter informao sobre o SysUpTime, o gerente, que a entidade
que faz requisies ao agente SNMP, emite mensagem GET com a
referncia .1.3.6.1.2.1.1.3. Em resposta, o agente SNMP retornar
mensagem SNMP com valor corrente de SysUpTime.
No SAGE o conversor SNMP e o transportador SNMP assumem a funo
de gerncia. O conversor coleta na base de dados do SAGE informaes
a serem gerenciadas via SNMP e mantm mquinas de estado pra
aquisio e controle. Ao definir mensagens de aquisio e de controle
as informaes necessrias so passadas ao transportador de protocolo
SNMP. O transportador gera a mensagem SNMP e a transmite ao
agente. Ao receber respostas de requisies SNMP o transportador as
encaminha ao conversor que cuida de atualizar sua mquina de estados
e passar informaes ao SAC.

3
SAGE
Sistema Aberto de Gerenciamento de Energia

- Conversor de Protocolos SNMP

4
Conversor de Protocolo
Dezembro - 2007

Mapeamento de Operaes
Para fazer a aquisio de dados via SNMP faz-se necessrio um
entendimento das entidades que atuam no sistema para tal
funcionalidade. A terminologia utilizada em documentos que descrevem
o padro SNMP gerente e agente. Em cada equipamento que
monitorado deve haver pelo menos uma instncia de agente SNMP. No
caso de mais de um agente instanciado por equipamento, um agente
seria o responsvel por atender o servio SNMP enquanto outros
ficariam de reserva para eventual falha no agente atuante. Portanto,
pode-se por exemplo definir dois agentes em um mesmo equipamento
para controle de failover. O agente SNMP exerce a funo tpica de uma
UTR como normalmente definido no SAGE.

Aquisio Analgica

Na operao de aquisio analgica, dados

endereamento via MIB por mensagens GET.

so

coletados

por

Quanto preciso dos dados coletados, dados analgicos coletados

podem ser armazenados em sua forma instantnea, em mdia calculado
por mltiplas janelas de tempo e tambm por mdia mvel com
ponderao exponencial. Quanto ao tipo de grandeza, os dados podem
ser armazenados em forma absoluta ou relativa. Por exemplo, o tempo
de operao de sistema uma grandeza absoluta.
Um exemplo
diferente o tempo de consumo de CPU por processos do usurio em
um dado intervalo. Este dado vem pela diferena entre o valor coletado
no final e no incio do intervalo. Para casos de valor de taxa ento,
apenas a diferena no suficiente, mas tambm necessrio calcular
a taxa pela razo entre a diferena de valores coletados e o tempo no
intervalo de medidas.

importante ressaltar que o valor armazenado pelo conversor de

protocolo segue os dois conceitos de preciso e de relatividade. Uma
taxa pode ser calculada em mdia mvel ponderada exponencialmente.
Ou pode-se ter a mdia de diferenas em diferentes janelas de tempo.

Tipicamente qualquer ponto em aquisio tem valores de mdia

calculados. O normal ter o valor instantneo disponvel no ponto e os
valores por diferena de tempo disponveis por filtros.
Para o caso especfico de percentual de consumo de CPU, h ainda o
clculo de percentual que utiliza como parcelas o tempo consumido por
processos do usurio, o tempo consumido por processos de sistema, o
5
SAGE
Sistema Aberto de Gerenciamento de Energia

- Mapeamento de Operaes

tempo no-consumido (tempo ocioso) e tempo consumido por processos

com baixa prioridade (nice).

Aquisio Digital
Na operao de aquisio digital, dados so tambm coletados por
endereamento via MIB por mensagens GET, mas digitalizados para o
SAGE. No momento, este processo de digitalizao simplesmente
atribuir valor 1 (um) a qualquer valor maior do que zero e 0 (zero) caso
contrrio.

Controle
Para operaes de controle tambm se utiliza o endereamento via MIB,
mas deve utilizar necessariamente um objeto OID que permita escrita
(read-write), pois o tipo de mensagem SNMP utilizado SET. No
momento, dentre os tipos de controle definidos na base SAGE, o tipo de
controle utilizado RTSC.

6
Conversor de Protocolo
Dezembro - 2007

Pontos Calculados
Para obter clculo de consumo de CPU, necessrio definir na base um
ponto de clculo cujo valor determinado atravs de clculo no SAGE.
No exemplo abaixo, o ponto definido como pertencente a uma TAC de
clculos e o clculo definido CPU (atributo para TCL).
Exemplo:
PAS
BNDMO =

ID =

CALCCPU

LIE =

-500

LSE =

500

OCR =

OCR_PAS01

TAC =

CALC

TCL =

CPU

TIPO =

OUTROS

DPE =

LIA =

-300

LIU =

-400

LSA =

300

LSU =

400

TERM =

A_REA

NOME =

Percentual de Consumo de CPU

Tambm necessrio para alguns casos, como capacidade de unidades

de mdia, um clculo de multiplicao MULT. No caso de obter uma
medida pela MIB HOST-RESOURCES a capacidade disco ou memria
RAM uma entrada definida, mas a unidade de medida est em outra
entrada na MIB. Um exemplo a unidade estar definida em 4 Kbytes e
a capacidade 500000. A capacidade total dada pela multiplicao
destes dois fatores.

7
SAGE
Sistema Aberto de Gerenciamento de Energia

- Pontos Calculados

8
Conversor de Protocolo
Dezembro - 2007

Filtro
Para obter valores mximos de determinada medida em um dado
intervalo de tempo deve-se utilizar o filtro FIL1. O default utilizar um
intervalo de tempo de uma hora. Nesse caso o valor retornado no filtro
o valor mximo medido no ponto em uma janela de tempo de uma
hora.
Outros filtros so definidos para obter mdias em janela de tempo. Os
filtros FIL2, FIL3, FIL4, e FIL5 retornam as mdias em intervalos de
tempo que por default so de 1 minutos, 10 minutos, 1hora, e 1 dia.
Utiliza-se tambm filtros para o SAGE retornar os processos de maior
consumo de CPU. O filtro FIL6 retorna o filtro de maior consumo de
memria. Os filtros FIL7 e FIL8 retornam respectivamente os processos
de segundo maior e terceiro maior consumo de memria.
Todos estes filtros utilizam apenas o ponto de medida como entrada.
Desta forma, h apenas uma parcela para cada ponto na tabela RFC.

9
SAGE
Sistema Aberto de Gerenciamento de Energia

- Filtro

10
Conversor de Protocolo
Dezembro - 2007

Tabelas
A seguir so colocadas algumas particularidades em relao a como
definir uma base de dados de forma que o SAGE possa atuar como
gerente SNMP.

LSC
Deve definir para cada LSC atributos TCV e TTP da seguinte forma:
TCV = CNVQ
TTP = TSNMP

CNF
Ao definir uma CNF, o atributo CONFIG deve conter as definies
necessrias para acesso a um agente SNMP. Tipicamente deve-se
definir um endereo IP, a porta que responde o servio SNMP e a string
definida como community.
Tambm possvel definir mais de um endereo IP e portas de servio
SNMP para efeitos de redundncia.
Exemplo:
CONFIG= HOST= 161.79.56.101 PORTA= 161
COMMUNITY=public HOST= 161.79.56.101
PORTA=10001
No caso acima definida uma segunda porta para efeitos de
redundncia.
Tipicamente esta porta deve estar com o servio
habilitado atravs de uma instncia reserva de um agente SNMP (UTR
reserva).

PAS
Os pontos lgicos so definidos normalmente. No caso de pontos de
filtro ou de clculo, pode-se usar um dos filtros ou clculos tal como
explicado anteriormente.

11
SAGE
Sistema Aberto de Gerenciamento de Energia

- Tabelas

PAF
Para o atributo ID utiliza-se uma conveno que determina o tipo de
ponto, o OID (Object ID) a que o ponto corresponde e se so
computados mdias em diferentes intervalos de tempo.
A conveno ID = nome_tipo_oid. nome indica uma referncia. tipo
indica se o ponto a ser medido um valor instantneo, ou valor
diferencial, ou de taxa ou ainda por mdia exponencial. Oid declara a
entrada na MIB que corresponde ao ponto fsico em questo.
Uma observao para a definio de oid que so definidos
descontando-se o prefixo .1.3.6.1 que so comuns a todos os oids de
interesse.
O tipo pode ser um dentre os seguintes:
Valor Instantneo

(tipo I)

Definido pelo OID diretamente

Valor Diferencial

(tipo D)

Normalmente instantneo

Taxa em Tempo

(tipo ED ou ID)

Pode ser instantneo ou exponencial

Media Exponencial

(tipo E)

Definido por um filtro ou diretamente

Tabela

(tipo T)

Retorna apenas uma parte da tabela

ordenando de forma decrescente por
um
determinado
ndice
a
ser
especificado para cada ponto

Lista

(L ou LD)

Disponibiliza 3 pontos em ordem

decrescente dada por um parmetro a
definir no atributo DESC1

Status

(Sx)

Onde x um numero inteiro

disponibiliza
um
ndice
de
disponibilidade. O nmero x indica o
valor
a
ser
considerado
como
verdadeiro. Qualquer valor diferente de
x ento considerado falso.

Demais atributos de interesse:

KCONV1 - mudana de escala
KCONV2 - utilizado para definir parmetro a de mdia mvel ponderada
exponencial. Nota: 0 a 1, quanto maior o valor de a maior ser o
peso dado a medida mais recente.
DESC1 utilizada para ordenar em ordem decrescente uma lista, onde
os trs maiores valores so armazenados. A sintaxe aqui deve ser a:b:c.
O valor de a a parte fixa do OID (removendo-se .1.3.6.1 da parte
inicial). O valor de b o complemento para o OID da medida a ser
considerada. E o valor de c o complemento para o OID do nome
referente a medida armazenada.
Exemplo:
DESC1= .2.1.25:5.1.1.1:4.2.1.2.
Aqui a parte fixa .1.3.6.1.2.1.25 (referente a MIB HOST-RESOURCES).
Os OIDs .1.3.6.1.2.1.25.5.1.1.1 so OIDs para entradas em tabelas de
processo que retornam consumo de CPU de cada processo.
12
Conversor de Protocolo
Dezembro - 2007

Tabelas -

E o OID .1.3.6.1.25.4.2.1.2 o OID referente aos comandos

propriamente ditos dos processos cujos valores so armazenados.

PDF
Os pontos digitais fsicos so definidos de forma similar aos pontos
analgicos fsicos na tabela PAF. O atributo ID segue o mesmo formato
utilizado para PAF. O atributo KCONV tipicamente configurado para
NOR.

PDS
Pontos digitais lgicos na tabela PDS so definidos normalmente.

CGF
Utiliza-se a mesmo formato para o atributo ID que utilizado na tabela
PAF. O tipo de ponto designado pela letra C.
Exemplo:
ID= L101_C_ .4.1.2021.100.12.0

CGS
O atributo TRRAC define um intervalo de tempo para um temporizador
de controle. Ao expirar tal temporizador o controle cancelado.

NV1
So definidas entradas na tabela NV1 especficas para a aquisio
SNMP.

NV2
So definidas entradas na tabela NV2 especficas para a aquisio
SNMP.
Para TN2 configura-se da seguinte forma:
TN2=

ASIM

para pontos digitais

TN2 =

AANL

para pontos analgicos

TN2 =

ASTP

para pontos analgicos que correspondem a uma

tabela

TN2=

CSIM

para pontos de controle

13
SAGE
Sistema Aberto de Gerenciamento de Energia

- Tabelas

CXU
Para a tabela CXU importante observar intervalos de tempo
(definidas nos atributos INTGR para pontos digitais e AQANL
para pontos analgicos) para aquisio de medidas que sejam
compatveis com clculo de mdias em janelas de tempo e outros
fatores similares.

UTR
definida normalmente com a devida ateno para o campo
RESPT que deve ter um valor para tempo acima do tempo que se
espera para aquisio de dados. Para aquisio de dados em
tabela o tempo necessrio tipicamente maior. recomendvel
neste caso definir uma outra entrada em UTR para este tipo de
ponto ainda que seja referente a um mesmo equipamento de
outra entrada na tabela.

TAC
definida normalmente. Utiliza-se ASAC para o atributo TPAQS.

ENU
Deve-se observar que o valor de TDESC seja compatvel, pois ao
fazer aquisio o valor definido em TDESC o intervalo de tempo
entre dois pedido consecutivos de aquisio.

14
Conversor de Protocolo
Dezembro - 2007

Gerao Automtica de Base Fonte

H uma ferramenta que permite automatizar o processo de criao de
pontos na base fonte. Tal procedimento auxilia a tarefa de gerncia
pois cria os pontos seguindo um padro recomendado pelo CEPEL.
Configuraes particulares podem ser modificadas a partir da
configurao padro gerada pela ferramenta, dependendo dos casos
particulares.

Procedimento
Escrever um arquivo de configurao (formato ASCII) que contm as
informaes sobre elementos de rede (Estaes SAGE, switches,
roteadores etc.) e medidas a serem obtidas de cada um dos elementos
definidos.
Inicialmente define-se informaes sobre os elementos e sobre o acesso
SNMP a estes elementos:
[HOST]
ID = srv1
IP_ADDR1 = 161.79.56.101:1027
SNMP_VERSAO = 1
SNMP_COMMUNITY = public
Em seguida define-se medidas a serem obtidas para cada elemento,
utilizando-se a seguinte sintaxe:
TIPO INFO [opes]
Onde opes

TIPM x

KCONV1 y

KCONV2 w

IND z

INC

max1h

med1min

med10min

med1h

med1d

x =ED, D, L, LD, I
y= fator de escala
w = fator p/mdia exponencial
z = ndice em tabela
Exemplo:
PAS HOST_UPTIME KCONV1 360000 INC max1h med1h

Existe um script perl que gera entradas para tabelas PAS, PAF, PDS,
PDF, CGS, CGF, NV1, NV2, TAC, LSC, ENU, CXU, UTR, CNF, RCA,
RFC.
Estas entradas so colocadas em arquivos em $BD/dados/snmp. O
script faz uma operao do tipo merge entre arquivos para concatenar
entradas da base fonte localizadas em arquivos no diretrio
15
SAGE
Sistema Aberto de Gerenciamento de Energia

- Gerao Automtica de Base Fonte

$BD/dados/bsico com os arquivos gerados para gerncia SNMP e

finalmente colocar os arquivos completos da base fonte no diretrio
padro utilizado pelo SAGE que $BD/dados.

16
Conversor de Protocolo
Dezembro - 2007