Oracle OsWatcher

O OSWatcher (OSW) é uma ferramenta para auxilio em análises de performance, através da coleta de

informações do Sistema Operacional. É composto por uma série de scripts shell que utilizam os utilitários UNIX de diagnóstico para coleta de dados.

O OSW utiliza os seguintes utilitários para coleta de dados:

• ps
• top
• mpstat
• iostat
• netstat
• tracerout
• vmstat

O download do OSW pode ser realizado através do My Oracle Support (Doc ID 301137.1) e sua instalação é bastante simples, conforme veremos abaixo. Após realizar o download do OSW, será necessário extrai-lo e configurar alguns parâmetros.

[oracle@lamim ferramentas]$ pwd
/oraprd01/app/oracle/lamim/ferramentas
[oracle@lamim ferramentas]$ ls -ltr
total 6304
-rw-r--r-- 1 oracle dba 6318080 Dez 17 08:26 oswbb733.tar

--Para descompactar, será usando o tar -xvf

[oracle@lamim ferramentas]$ tar xvf oswbb733.tar
oswbb/
oswbb/docs/
oswbb/docs/The_Analyzer/
oswbb/docs/The_Analyzer/OSWatcherAnalyzerOverview.pdf
oswbb/docs/The_Analyzer/oswbbaUserGuide.pdf
oswbb/docs/The_Analyzer/oswbba_README.txt
oswbb/docs/OSWatcher/
oswbb/docs/OSWatcher/oswbb_README.txt
oswbb/docs/OSWatcher/OSWatcherUserGuide.pdf
oswbb/Exampleprivate.net
oswbb/nfssub.sh
oswbb/stopOSWbb.sh
oswbb/call_du.sh
oswbb/iosub.sh
oswbb/OSWatcherFM.sh
oswbb/ifconfigsub.sh
oswbb/ltop.sh
oswbb/mpsub.sh
oswbb/call_uptime.sh
oswbb/psmemsub.sh
oswbb/tar_up_partial_archive.sh
oswbb/oswnet.sh
oswbb/vmsub.sh
oswbb/call_sar.sh
oswbb/oswib.sh
oswbb/startOSWbb.sh
oswbb/Example_extras.txt
oswbb/oswsub.sh
oswbb/oswbba.jar
oswbb/OSWatcher.sh
oswbb/tarupfiles.sh
oswbb/xtop.sh
oswbb/src/
oswbb/src/Thumbs.db
oswbb/src/OSW_profile.htm
oswbb/src/tombody.gif
oswbb/src/missing_graphic.gif
oswbb/src/coe_logo.gif
oswbb/src/watch.gif
oswbb/src/oswbba_input.txt
oswbb/oswrds.sh

Descompactado o arquivo oswbb733.tar já podemos executar o OSW, para isso basta acessar o diretório oswbb e executar o script startOSWbb.sh. É possível passar alguns parâmetros na execução do processo como, por exemplo o intervalo da coleta, tempo de retenção, compactação dos arquivos, etc.

ARG1 = intervalo de coleta em segundos
ARG2 = numero de horas de retenção dos dados coletados.
ARG3 = (opicional) nome da ferramenta de compressão para que os dados sejam comprimidos após coletados.
ARG4 = (opicional) este parâmetro serve para alternar da localização do diretório onde os históricos serão gravados.

No exemplo a seguir, definirei uma coleta a cada 60 segundos com retenção de 10 horas e compactação via gzip.

./startOSWbb.sh 60 10 gzip
Se desajar também alterar o destino dos archives basta adicionar o caminho onde serão gerados.
/startOSWbb.sh 60 10 gzip /novodiretorio/archive

Agora, temos como necessidade configurar para que o OSW seja iniciado automaticamente com o reboot da maquina, evitando a necessidade de uma intervenção manual. Para isso precisamos instalar o pacote osw-service que está em anexo no doc 580513.1.

--Apos baixar o RPM, o mesmo será instalado (necessita ser executado com root)
[root@lamim ~]# cd /oraprd01/app/oracle/lamim/ferramentas/
[root@lamim ferramentas]# ls -ltr
total 24712
-rw-r--r-- 1 oracle dba  6318080 Dez 17 08:26 oswbb733.tar
-rw-r--r-- 1 oracle dba 18837765 Dez 17 09:08 osw-1.2.7-1.i386.rpm
-rw-r--r-- 1 oracle dba     5366 Dez 17 09:21 oswbb-service-7.2.0-1.noarch.rpm
-rwxr-xr-x 1 oracle dba   134732 Dez 17 09:28 oratop
lrwxrwxrwx 1 oracle dba       18 Dez 17 11:13 oswbb -> /oratemp/oswatcher
[root@lamim ferramentas]# rpm -ivh oswbb-service-7.2.0-1.noarch.rpm
Preparando...               ########################################### [100%]
   1:oswbb-service          ########################################### [100%]

Feita a instalação do pacote, basta ajustar o OSW_HOME e os parâmetros de retenção que ficam no arquivo /etc/oswbb.conf.

--Para corrigir o erro, basta ajustar o aquivo //usr///libexec/oswbb-service/oswbb-helper quetambém possuí o OSW_HOME.
[root@lamim ferramentas]# vi //usr///libexec/oswbb-service/oswbb-helper
#!/bin/bash
########################################################################
# vim: sw=8 ts=8 filetype=bash
#
# Helper file for Oracle OSWatcher
#
########################################################################

########################################################################
# Establish default values
########################################################################
# Set OSW_HOME to the directory where your OSWatcher tools are installed
OSW_HOME='/oratemp/oswatcher'
# Set OSW_INTERVAL to the number of seconds between collections
OSW_INTERVAL='30'
# Set OSW_RETENTION to the number of hours logs are to be retained
OSW_RETENTION='160'
# Set OSW_USER to the owner of the OSW_HOME directory
OSW_USER='root'
# Set OSW_COMPRESSION to the desired compression scheme
OSW_COMPRESSION='gzip'
# Set OSW_ARCHIVE to where the output logs should be generated
OSW_ARCHIVE='archive'
########################################### [100%]
[root@lamim ferramentas]# /sbin/service oswbb start
Iniciando o OSWatcher:                                     [  OK  ]
[root@lamim ferramentas]#
[root@lamim ferramentas]# service oswbb status
OSWatcher is running.

Os arquivos gerados serão gravados em OSW_HOME/archive.

Em um próximo post estarei abordando sobre o oswbba, que analiza os logs produzidos pelo OSW, permitindo a criação de graficos em HTML.

Fonte:
How To Start OSWatcher Black Box (OSWBB) Every System Boot Using RPM oswbb-service (Doc ID 580513.1).
OS Watcher User's Guide (Doc ID 1531223.1).
https://veduardodba.wordpress.com/2012/05/10/os-watcher-black-box/
http://www.dbaexpert.com/blog/the-better-way-to-configure-oswatcher/