Intersystems Cache

Escrito por Hitfy

Template: Template_Intersystems_CacheV4_Padrao

As coletas de dados dos bancos Intersystems Cache são realizadas via Agente e ODBC.

Pré-requisitos

Para o monitoramento funcionar corretamente, o cliente precisará:

Criação de Views para monitoramento;
Criação do usuário de monitoramento com permissões nas views;
Liberação da porta 56772 (ou porta utilizada);
Informar a Namespace.

Proxy - Instalação unixODBC

Caso já exista este tipo de monitoramento no cliente, provavelmente a instalação já estará realizada.

Validar se os pacotes do unixODBC estão instalados no servidor de Proxy.

wget ftp://ftp.intersystems.com/pub/cache/odbc/2017/ODBC-2017.2.1.801.0-lnxrhx64.tar.gz

Instalação do Driver ODBC

Criar o diretório /etc/zabbix/cache onde ficarão os arquivos de configuração utilizados pelo ODBC Driver:

mkdir /etc/zabbix/cache

Descompactar o arquivo:

gunzip ODBC-2017.2.1.801.0-lnxrhx64.tar.gz
tar xvf ODBC-2017.2.1.801.0-lnxrhx64.tar

Iniciar o instalador:

./ODBCinstall

Configurar o arquivo do pacote unixODBC para ele carregar a biblioteca ODBC do Oracle InstantClient:

vim /etc/odbcinst.ini

Adicionar a entrada:

[InterSystems ODBC]
UsageCount=1
Driver=/etc/zabbix/cache/bin/libcacheodbc.so
Setup=/etc/zabbix/cache/bin/libcacheodbc.so
SQLLevel=1
FileUsage=0
DriverODBCVer=02.10
ConnectFunctions=YYN
APILevel=1
DEBUG=1
CPTimeout=<not pooled>

Proxy - Configuração ODBC

Acessar o arquivo com as entradas de cada monitoramento:

vim /etc/odbc.ini

Adicionar a nova entrada substituindo os valores:

[NOME_BANCO]
Driver=InterSystems ODBC
Protocol=TCP
Host=IP_SERVIDOR_BANCO
Port=56772
Namespace=%SYS 
Description=Sample namespace
Query Timeout=0
Static Cursors=0

*Caso a porta de conexão do banco não seja a padrão, alterá-la também.

Execute o teste de conexão substituindo os valores:

sql -v banco usuario senha

Caso conecte, quer dizer que as configuração estão corretas:

+-------------------------+
| Connected!              |
|                         |
| sql-statement           |
| help [tablename]        |
| quit                    |
|                         |
+-------------------------+
SQL>

Configurações do Host

O monitoramento deve ter dois hosts:

Monitoramento Sistema Operacional
Monitoramento Cache

Editar as macros

{$CACHE_DSN} - Entrada configurada no odbc.ini
{$CACHE_USERNAME}
{$CACHE_PASSWORD}

Problemas conhecidos

Itens não suportados

É importante ler o erro do item não suportado, quase sempre mostrará o motivo, como:

Tabela ou visão não encontrada:

Vários itens dependem do pré-requisito "Criação de Views para monitoramento", que geralmente é feito pelo cliente.

Caso não esteja devidamente configurado, o item ficará não suportado com o erro:

Problema de usuário:

Verificar usuário e permissões.

Falha de comunicação:

Necessário verificar o IP, porta e configurações de firewall do banco, pois provavelmente nem telnet irá fechar:

Implantação