Templates de Monitoramento

Esta seção explica como configurar e gerenciar templates de monitoramento no DBizzie.

Visão Geral

Os templates de monitoramento são conjuntos pré-configurados de sensores e triggers que definem quais métricas serão coletadas e quais alertas serão disparados para os bancos de dados. Eles permitem padronizar o monitoramento e aplicar rapidamente configurações para múltiplos bancos.

Tipos de Templates

Templates Padrão (Sistema)

Características:

• Fornecidos pelo DBizzie com instalação
• Não podem ser editados pelos usuários
• Baseados em melhores práticas de monitoramento Oracle
• Atualizados automaticamente com novas versões
• Cobrem cenários comuns de monitoramento

Templates Personalizados

Características:

• Criados pelos usuários conforme necessidades específicas
• Totalmente editáveis e customizáveis
• Baseados em templates padrão ou criados do zero
• Podem ser compartilhados entre bancos similares
• Evoluem conforme mudanças de requisitos

Componentes dos Templates

Sensores

Os sensores são responsáveis por coletar métricas específicas dos bancos de dados Oracle. Cada sensor executa uma consulta SQL periodicamente e retorna um valor numérico.

Configurações do Sensor:

• Ativado: Define se o sensor está ativo (true) ou inativo (false)
• Nome: Nome descritivo que aparecerá nos alertas e relatórios
• Intervalo: Frequência de coleta em segundos (mínimo 10 segundos)
• Consulta: Query SQL que deve retornar apenas um número
• Consulta de Retorno: Query SQL adicional que busca informações detalhadas quando o usuário seleciona o sensor na interface

Exemplo de Configuração:

Sensor: CPU Usage
Ativado: true
Nome: "Uso de CPU (%)"
Intervalo: 60
Consulta: "SELECT ROUND(AVG(VALUE), 2) FROM V$SYSMETRIC WHERE METRIC_NAME = 'Host CPU Utilization (%)'"
Consulta de Retorno: "SELECT INSTANCE_NAME, VALUE FROM V$SYSMETRIC WHERE METRIC_NAME = 'Host CPU Utilization (%)'"

Triggers (Alertas)

Os triggers definem quando alertas serão disparados baseados nos valores coletados pelos sensores.

Configurações do Trigger:

• Severidade: Nível de criticidade do alerta

  • info - Informativo
  • low - Baixa prioridade
  • medium - Média prioridade
  • high - Alta prioridade
  • critical - Crítico

• Operador: Tipo de comparação a ser realizada

  • equal - Igual a
  • not_equal - Diferente de
  • greater_than - Maior que
  • less_than - Menor que
  • greater_than_or_equal_to - Maior ou igual a
  • less_than_or_equal_to - Menor ou igual a

• Valor para checar: Valor numérico para comparação

Exemplo de Configuração:

Trigger: CPU Alto
Sensor: CPU Usage
Severidade: high
Operador: greater_than
Valor: 85

Trigger: CPU Crítico
Sensor: CPU Usage
Severidade: critical
Operador: greater_than_or_equal_to
Valor: 95

Templates Padrão Detalhados

Basic Monitoring

Objetivo: Monitoramento essencial para qualquer banco Oracle

Sensores Inclusos:

CPU Usage:
  Nome: "Uso de CPU (%)"
  Intervalo: 60 segundos
  Consulta: "SELECT ROUND(AVG(VALUE), 2) FROM V$SYSMETRIC WHERE METRIC_NAME = 'Host CPU Utilization (%)'"

Memory Usage:
  Nome: "Uso de Memória (%)"
  Intervalo: 60 segundos
  Consulta: "SELECT ROUND((1 - (bytes_free / bytes_total)) * 100, 2) FROM V$SGAINFO WHERE name = 'Maximum SGA Size'"

Active Sessions:
  Nome: "Sessões Ativas"
  Intervalo: 30 segundos
  Consulta: "SELECT COUNT(*) FROM V$SESSION WHERE STATUS = 'ACTIVE'"

Tablespace Usage:
  Nome: "Uso de Tablespace (%)"
  Intervalo: 300 segundos
  Consulta: "SELECT MAX(ROUND((bytes_used / bytes_total) * 100, 2)) FROM DBA_TABLESPACE_USAGE_METRICS"

Triggers Configurados:

CPU Warning:
  Severidade: medium
  Operador: greater_than
  Valor: 80

CPU Critical:
  Severidade: critical
  Operador: greater_than_or_equal_to
  Valor: 95

Tablespace Warning:
  Severidade: high
  Operador: greater_than
  Valor: 85

Tablespace Critical:
  Severidade: critical
  Operador: greater_than_or_equal_to
  Valor: 95

Gerenciar Templates

Aplicar Template a Banco

Para aplicar um template a um banco de dados:

1. Acesse Configurações → Bancos de Dados
2. Edite o banco desejado
3. Na seção "Templates", clique em "Add Template"
4. Selecione o template desejado
5. Configure parâmetros específicos (se necessário)
6. Salve as configurações

Múltiplos Templates

Um banco pode ter múltiplos templates aplicados:

• Templates se complementam ao invés de sobrescrever
• Sensores únicos são combinados
• Triggers com mesma métrica usam o mais restritivo
• Ordem de aplicação pode ser importante

Visualizar Templates Aplicados

Na tela de gerenciamento do banco, visualize:

• Templates ativos e suas configurações
• Sensores coletados por template
• Triggers configurados e seus status
• Última atualização de cada template

Criar Templates Personalizados

Processo de Criação

1. Acesse Configurações → Templates
2. Clique em "+ New Template"
3. Configure informações básicas
4. Adicione sensores necessários
5. Configure triggers e alertas
6. Teste com banco piloto
7. Aplique a outros bancos

Informações Básicas

Configuração do Template:

• Nome: Identificação clara (ex: "ERP Production")
• Descrição: Propósito e cenário de uso
• Categoria: Classificação para organização
• Tags: Para filtros e buscas

Configurar Sensores

Adicionar Sensores:

1. Na seção "Sensores", clique em "Add Sensor"
2. Configure as propriedades do sensor:

Propriedades Obrigatórias:

• Ativado: Marque como true para ativar
• Nome: Nome descritivo (ex: "Uso de CPU")
• Intervalo: Frequência em segundos (mínimo 10)
• Consulta: SQL que retorna um valor numérico

Propriedades Opcionais:

• Consulta de Retorno: SQL para detalhes adicionais

Exemplo Prático:

Nome: "Conexões Ativas"
Ativado: true
Intervalo: 30
Consulta: "SELECT COUNT(*) FROM V$SESSION WHERE STATUS = 'ACTIVE' AND TYPE = 'USER'"
Consulta de Retorno: "SELECT USERNAME, MACHINE, PROGRAM FROM V$SESSION WHERE STATUS = 'ACTIVE' AND TYPE = 'USER'"

Configurar Triggers

Adicionar Triggers:

1. Na seção "Triggers", clique em "Add Trigger"
2. Selecione o sensor relacionado
3. Configure as condições de alerta:

Configuração do Trigger:

• Severidade: Escolha entre info, low, medium, high, critical
• Operador: Selecione o tipo de comparação
• Valor: Defina o valor numérico para comparação

Exemplos de Triggers:

Alerta de Conexões:
  Sensor: "Conexões Ativas"
  Severidade: medium
  Operador: greater_than
  Valor: 50

Alerta Crítico de Conexões:
  Sensor: "Conexões Ativas"
  Severidade: critical
  Operador: greater_than_or_equal_to
  Valor: 100

Tablespace Cheio:
  Sensor: "Uso de Tablespace"
  Severidade: high
  Operador: greater_than_or_equal_to
  Valor: 90

Boas Práticas para Consultas SQL

Consultas de Sensores:

• Devem retornar apenas um valor numérico
• Usar funções de agregação quando necessário (AVG, MAX, COUNT)
• Evitar consultas muito complexas que impactem performance
• Testar sempre em ambiente de desenvolvimento primeiro

Exemplos de Consultas Válidas:

-- CPU Usage
SELECT ROUND(AVG(VALUE), 2) 
FROM V$SYSMETRIC 
WHERE METRIC_NAME = 'Host CPU Utilization (%)'

-- Tablespace Usage (maior uso)
SELECT MAX(ROUND((BYTES - NVL(FREE_BYTES, 0)) / BYTES * 100, 2))
FROM (SELECT TS.TABLESPACE_NAME, TS.BYTES, F.FREE_BYTES
      FROM DBA_TABLESPACES TS, 
           (SELECT TABLESPACE_NAME, SUM(BYTES) AS FREE_BYTES 
            FROM DBA_FREE_SPACE GROUP BY TABLESPACE_NAME) F
      WHERE TS.TABLESPACE_NAME = F.TABLESPACE_NAME(+))

-- Sessões por usuário específico
SELECT COUNT(*) 
FROM V$SESSION 
WHERE USERNAME = 'APP_USER' AND STATUS = 'ACTIVE'

Clonar Template

Para criar templates similares rapidamente:

1. Selecione um template existente
2. Clique em "Clone Template"
3. Modifique nome e descrição
4. Ajuste sensores e triggers conforme necessário
5. Salve o novo template

Gerenciar Templates Personalizados

Editar Template

Para modificar templates personalizados:

1. Acesse Configurações → Templates
2. Clique no ícone ✏️ do template
3. Modifique configurações necessárias
4. Atenção: Mudanças afetam todos os bancos usando o template
5. Salve as alterações

Excluir Template

Para remover templates personalizados:

1. Clique no ícone 🗑️ do template
2. Confirme que não está sendo usado por bancos
3. Confirme a exclusão

Importante

Templates padrão do sistema não podem ser excluídos. Apenas templates personalizados podem ser removidos.

Boas Práticas

Design de Templates

1. Começar simples: Use templates padrão como base
2. Necessidades específicas: Customize apenas quando necessário
3. Documentação: Documente propósito e configurações
4. Testes: Valide em ambiente de teste antes de produção

Configuração de Sensores

1. Intervalos adequados: Use intervalos apropriados para cada métrica
2. Consultas eficientes: Evite consultas que impactem performance
3. Nomes descritivos: Use nomes claros para facilitar identificação
4. Teste de consultas: Sempre teste SQL antes de aplicar

Configuração de Triggers

1. Severidades apropriadas: Use níveis adequados para cada situação
2. Valores realistas: Base thresholds na realidade do ambiente
3. Evitar ruído: Configure valores que evitem falsos positivos
4. Escalation: Use severidades progressivas (medium → high → critical)

Solução de Problemas

Sensor não coletando dados

Verificações:

• Sensor está ativado (true)
• Consulta SQL é válida e retorna número
• Usuário do DBizzie tem permissões para executar a query
• Intervalo está configurado corretamente (mínimo 10 segundos)

Muitos alertas (ruído)

Soluções:

• Ajustar valores dos triggers
• Revisar severidades configuradas
• Aumentar intervalos de coleta se necessário
• Refinar consultas SQL

Trigger não disparando

Verificações:

• Sensor está coletando dados
• Operador está correto para a condição desejada
• Valor de comparação está adequado
• Severidade está configurada

Próximos Passos

Após configurar templates:

1. Configurar Alertas - Definir notificações
2. Analisar Dashboards - Visualizar métricas coletadas
3. Otimizar continuamente - Ajustar conforme experiência

Dica

Comece com templates padrão e evolua gradualmente para personalizações. A experiência prática ajuda a identificar quais métricas são realmente importantes para seu ambiente.