Informações de monitoramento

Cada push de monitoramento contém informações conforme mostrado na tabela a seguir:
cad141br
Cada push de monitoramento contém informações conforme mostrado na tabela a seguir:
Nome do objeto de monitoramento
:
dxserver-monitor
Nome
Tipo de valor
Formato
Descrição
host-name
 
Sequência
 
Nome do host no qual reside o DSA que fornece as informações
dsa-name
Sequência
 
Nome do DSA que fornece as informações
time
Sequência
CCAAMMDD.HHMMSS.mmm
Hora em que o DSA enviou a mensagem
message-id
Número
>=0
Número de sequência para identificar cada mensagem enviada exclusivamente pelo DSA
{alarm}
 
Essas informações serão explicadas em detalhes nas seções a seguir.
{event}
 
Essas informações serão explicadas em detalhes nas seções a seguir.
log
{log}
 
Essas informações serão explicadas em detalhes nas seções a seguir.
{stats}
 
Essas informações serão explicadas em detalhes nas seções a seguir.
{cache}
 
Essas informações serão explicadas em detalhes nas seções a seguir.
{multiwrite}
 
Essas informações serão explicadas em detalhes nas seções a seguir.
{dsastats}
 
Essas informações serão explicadas em detalhes nas seções a seguir.
Informações sobre o alarme
As informações sobre o alarme são enviadas toda vez que uma mensagem de alarme é gravada no log de alarmes, dependendo do tipo configurado. O log de alarmes captura um grande número de eventos críticos do ciclo de vida de um DSA.
  • Nome do objeto de alarme
    : alarm
  • Disparador
    : mensagem de alarme gravada no arquivo de log
A mensagem de alarme contém as seguintes informações, conforme mostrado nesta tabela:
Nome
Tipo de valor
Formato
Descrição
id
Sequência
DSA_cnnnn
Identificador exclusivo da mensagem de alarme
type
 
Sequência
Enumeração:
critical
caution
information
Gravidade do alarme
message
Sequência
 
Texto que descreve o evento de alarme que ocorreu
Exemplo de formato de alarme
Este exemplo é uma mensagem de alarme informativo enviada quando você interrompe o DSA.
 { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "data1",
        "time": "20141205.165412.212",
        "alarm": {
          "id": "DSA_I1240",
          "type": "information",
          "message": "DSA shutting down"
        }
      }
    }
Informações sobre o evento
Enquanto o DSA estiver em execução, um número de eventos-chave podem ser detectados. Esses eventos são úteis da perspectiva de uma auditoria ou para detectar problemas que exijam atenção imediata.
  • Nome do objeto de evento
    : event
  • Disparador
    : evento configurado detectado pelo DSA
A mensagem de evento contém as seguintes informações, conforme mostrado nesta tabela:
Nome
Tipo de valor
Formato
Descrição
type
 
Sequência
Enumeração:
auth-failure
account-susp
op-error
mw-error
Tipo do evento que ocorreu
message
Sequência
 
Texto que descreve o evento que ocorreu
Exemplo de formato de evento
Este exemplo ilustra a situação em que ocorre uma vinculação ao DSA com credenciais inválidas. Se isso ocorrer com frequência, pode indicar um ataque de dicionário.
    { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "data1",
        "time": "20141205.165412.212",
        "event" : {
          "type": "auth-failure",
          "message": "cn=justin,ou=users,o=ca,c=au 123.123.123.123"
        }
      }
    }
Informações sobre logs
Enquanto o DSA estiver em execução, um número de logs são gravados no sistema de arquivos. Esses logs podem ser o diretório para o endereço de monitoramento.
  • Nome do objeto de log
    : logs
  • Disparador
    : quando as operações são processadas pelo DSA
A mensagem de log contém as seguintes informações, conforme mostrado nesta tabela:
Nome
Tipo de valor
Formato
Descrição
type
 
Sequência
Enumeração:
query-log
update-log
Tipo de evento sendo registrado pelo DSA
message
Sequência
 
Texto que descreve o evento de log que ocorreu
Observação
: o monitoramento de eventos externos é independente do registro do CA Directory no sistema de arquivos.
Exemplo de formato de log
Este exemplo é uma solicitação de vinculação bem-sucedida que está sendo registrada.
   { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "router",
        "time": "20150223.115515.695",
        "log" : {
          "type": "query-log",
          "message": "20150223.115515.695 0.11 BIND 10.129.174.81 dn=\"cn=justin,ou=users,o=ca,c=au\""
        }
      }
    }
 
    { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "router",
        "time": "20150223.171428.225",
        "log" : {
          "type": "query-log",
          "message": "20150223.171428.225 0.11 RESULT success 1 entries 16 msecs"
        }
      }   
    }
Informações sobre as estatísticas
O DSA continua executando contagens de várias operações recebidas e outras informações, conforme mostrado na tabela a seguir. Essa informação é redefinida quando um DSA é reiniciado. Essa contagem continuará aumentando até que os valores voltem a zero quando MAX_INT sem assinatura (32 bits) for atingido.
Se forem tirados instantâneos periódicos, essas informações fornecerão uma medida razoável de como o DSA está se desempenhando ao longo do tempo. O delta dos instantâneos indica a quantidade de trabalho que o DSA executou nesse período.
  • Nome do objeto de estatísticas
    : stats
  • Disparador
    : se
    push-interval
    estiver configurado, este objeto será usado, caso contrário, uma mensagem será enviada a cada 60 segundos.
Nome
Tipo de valor
Formato
Descrição
anonymous-binds
Número
>=0
Vinculações anônimas processadas
simple-binds
Número
>=0
Vinculações de nome de usuário/senha processadas
strong-binds
Número
>=0
Vinculações autenticadas por certificado processadas
bind-security-errors
Número
>=0
Vinculações recusadas devido a credenciais inválidas
total-operations
Número
>=0
Contagem total de operações processadas
compare-entry-operations
Número
>=0
Número total de operações de comparação processadas
add-entry-operations
Número
>=0
Número total de operações de adição de entradas processadas
remove-entry-operations
Número
>=0
Número total de operações de remoção de entradas processadas
modify-entry-operations
Número
>=0
Número total de operações de modificação de entradas processadas
rename-entry-operations
Número
>=0
Número total de operações de renomeação de entradas processadas
list-operations
Número
>=0
Número total de operações de entrada de lista processadas (pesquisa de um nível para o objectClass presente)
search-operations
Número
>=0
Número total de operações de pesquisa processadas
one-level-search-operations
Número
>=0
Número total de operações de pesquisa com escopo de um nível processadas
whole-subtree-searches
Número
>=0
Número total de operações de pesquisa em toda a subárvore processadas
security-errors
Número
>=0
Número total de erros de segurança que ocorreram
operation-errors
Número
>=0
Número total de operações com falha
Exemplo de formato de estatísticas
{ "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "router",
        "time": "20150223.214700.014",
        "stats" : {
          "anonymous-binds": 0,
          "simple-binds": 1,
          "strong-binds": 0,
          "bind-security-errors": 0,
          "total-operations": 7,
          "compare-entry-operations": 0,
          "add-entry-operations": 0,
          "remove-entry-operations": 0,
          "modify-entry-operations": 1,
          "rename-entry-operations": 0,
          "list-operations": 5,
          "search-operations": 1,
          "one-level-searches": 1,
          "whole-subtree-searches": 0,
          "security-errors": 0,
          "operation-errors": 0
        }
      }
    }
Informações sobre o cache
O DSA usa um cache de alta velocidade para otimizar o desempenho. Desde a r12, todas as informações passaram a ser armazenada em cache (DXgrid) e esse evento fornece um instantâneo do estado atual do cache DXgrid do DSA.
Observação
se definidos no DSAs roteadores, todos os contadores serão definidos como zero e o status será desativado. Por esse motivo, é mais eficiente definir essa opção apenas nos DSAs de dados.
  • Nome do objeto de estatísticas
    : cache
  • Disparador
    : se
    push-interval
    estiver configurado, este objeto será usado, caso contrário, uma mensagem será enviada a cada 60 segundos.
A mensagem de cache contém as seguintes informações, conforme mostrado nesta tabela:
Nome
Tipo de valor
Formato
Descrição
status
Sequência
Enumeração:
ok
criando
disabled
insane
 
O cache está funcionando normalmente
O cache está sendo carregado a partir do arquivo de banco de dados do DXgrid
O cache está desativado
Não deve chegar a este ponto
size
Número
>=0
Memória usada (até MB mais próximo) para armazenar em cache as entradas e criar índices
search-hits
Número
>=0
Quantas pesquisas o cache atendeu
sequential-scans
Número
>=0
Quantas pesquisas fizeram com que o cache examinasse sequencialmente todas as entradas. Essas pesquisas são ineficientes e devem ser monitoradas.
entradas
Número
>=0
Número de entradas atendidas pelo cache
file-size
Número
>=0
O tamanho configurado do arquivo de banco de dados do DXgrid
used-bytes
Número
>=0
Número de bytes usados para armazenar os dados no arquivo de banco de dados do DXgrid. O percentual de utilização do arquivo pode ser calculado por meio desta fórmula: 
used-bytes / file-size * 100
.
reclaimable-bytes
Número
>=0
Número de bytes de entradas ou valores excluídos que podem ser recuperados por atualizações subsequentes
Exemplo de formato de cache
    { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "data1",
        "time": "20150223.214700.014",
        "cache" : {
          "status": "ok",
          "size": 6,
          "search-hits": 0,
          "sequential-scans": 0,
          "entries": 7,
          "file-size": 10,
          "used-bytes": 1,
          "reclaimable-bytes": 1
        }
      }
    }
Informações sobre a gravação múltipla
Quando um DSA faz parte de um conjunto de replicação de DSAs, o evento de gravação múltipla faz um acompanhamento de cada DSA do par sendo atendido. Um DSA pode ter um ou mais pares e o evento de gravação múltipla fornece uma linha de status separada para cada par.
Observação
nenhum evento será enviado se um DSA não estiver replicando. Se houver vários DSAs de gravação múltipla, cada DSA enviará um evento de gravação múltipla para cada par do conjunto de replicação. Isso pode disparar a uma grande quantidade de tráfego. Por esse motivo, aumente o intervalo de push para reduzir o tráfego de monitoramento.
  • Nome do objeto de estatísticas
    : multiwrite
  • Disparador
    : se
    push-interval
    estiver configurado, este objeto será usado, caso contrário, uma mensagem será enviada a cada 60 segundos.
Nome
Tipo de valor
Formato
Descrição
dsa-name
Sequência
 
Nome do DSA remoto do par de gravação múltipla.
queue-length
Número
>=0
Número de atualizações que foram aplicadas localmente e que devem ser enviadas ao DSA do par de gravação múltipla.
Observação
se esse valor aumentar ao longo do tempo, isso indicará um gargalo na replicação, que precisará de investigação, especialmente se o DISP de gravação múltipla estiver ativado.
status
Número
Enumeração:
unknown
 
ok
Replicando normalmente para
dsa-name
failed
Não é possível fazer contato com 
dsa-name
, uma nova tentativa será feita em 60 segundos
failed-no-remote-dsa
A replicação falhou, pois
dsa-name
foi removido da configuração
serviced-by-hub
Não está replicando para 
dsa-name
, pois é manipulado pelo hub nesse grupo de gravação múltipla do DSA
recovering
A replicação para 
dsa-name
falhou. O DISP de gravação múltipla será usado para recuperação
disp-failed
O dsa-name está no processo de recuperação por meio do uso da gravação múltipla
waiting-for-disp
Inicialização do DISP de gravação múltipla em andamento
queue-purged
O tamanho da fila de gravação múltipla foi excedido
failed-update-sent
Tentando restabelecer conexão com
dsa-name
pending-remote
Número
>=0
Contagem de atualizações que foram enviadas para o DSA do par de replicação
confirmed-local
Número
>=0
Contagem de atualizações na fila para as quais os clientes não estão aguardando confirmação. As atualizações foram confirmadas ou estão replicando de forma assíncrona.
Exemplo de formato de gravação múltipla
O DSA mw1 tem 2 DSAs pares de gravação múltipla (mw2 e mw3), portanto, duas mensagens serão enviadas.
    { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "mw1",
        "time": "20150223.214700.014",
        "multiwrite" : {
          "dsa-name": "mw2",
          "queue-length": 0,
          "status": "ok",
          "pending-remote": 10,
          "confirmed-local": 10
        }
      }
    }
 
    { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "mw1",
        "time": "20150223.214700.014",
        "multiwrite" : {
          "dsa-name": "mw3",
          "queue-length": 1000,
          "status": "failed",
          "pending-remote": 0,
          "confirmed-local": 0
 
        }
      }
    }
Informações sobre as estatísticas internas do DSA
O DSA faz um acompanhamento das informações estatísticas internas de baixo nível que podem ser úteis no controle de problemas operacionais ou de desempenho.
Algumas informações são redefinidas quando um DSA é reiniciado e continua aumentando até que os valores voltem a zero quando MAX_INT sem assinatura (32 bits) é atingido. Outras informações são redefinidas após cada instantâneo. Por esse motivo, push-interval não é suportado para esse evento de monitoramento.
  • Nome do objeto de estatísticas
    : dsastats
  • Disparador
    : mensagem enviada a cada 60 segundos
Nome
Tipo de valor
Formato
Descrição
associations
Número
>=0
Número de conexões ativas com o DSA
nil-credit
Número
>=0
Número de vezes desde a última mensagem quando o processamento de uma operação foi atrasado porque foi atingido o limite de crédito. Esse valor é redefinido a cada 60 segundos.
queued-ops
Número
>=0
Número de operações que o DSA está processando
queued-remote-ops
Número
>=0
Número de operações que foram enviadas para outros DSAs para processamento
ops-processed
Número
>=0
Número de operações que foram processadas desde a última mensagem. Esse valor é redefinido a cada 60 segundos.
entries-returned
Número
>=0
Número de entradas retornadas pelo DSA desde a última mensagem. Esse valor é redefinido a cada 60 segundos.
mw-queue
Número
>=0
O número total de atualizações na fila em todas as filas de gravação múltipla
mw-replicating
Número
>=0
O número total de atualizações que estão aguardando uma resposta dos DSAs do par remoto
ativa
Número
>=0
O percentual aproximado de segmentos ativos no último minuto. Esse valor é redefinido a cada 60 segundos.
memory-trees
Número
>=0
O número de blocos de memória interna em uso
memory-usage
Número
>=0
Quantidade total de memória que o DSA solicitou do sistema operacional
mallocs
Número
>=0
O número de vezes que malloc foi chamado desde a última mensagem. O DSA reutiliza a memória, portanto, ao longo do tempo, o número de chamadas malloc deve ser reduzido. Se essas chamadas não diminuírem, significa que o DSA não está sendo executado com a eficiência total, já que a solicitação de memória do SO afeta o desempenho.
Esse valor é redefinido a cada 60 segundos.
buffers
Número
>=0
O número de buffers de transporte no DSA. Esses buffers são usados ao enviar solicitações e respostas para outros DSAs ou clientes. Se o número de buffers de transporte aumentar, isso pode indicar que o destinatário não está conseguindo lidar com a carga gerada e pode indicar um gargalo
free-buffers
Número
>=0
O número de buffers de transporte que podem ser reutilizados
selects
Número
>=0
O número de vezes que select() foi chamado desde a última mensagem. Este objeto é usado para monitorar eventos de rede (solicitações ou desconexões). Esse valor é redefinido a cada 60 segundos.
write-selects
Número
>=0
O número de vezes select() retornou um evento de gravação. Esses eventos ocorrem quando o DSA tenta enviar uma solicitação ou resposta e a tentativa é bloqueada pelo destinatário. O DSA precisa aguardar a outra extremidade se tornar gravável. Se isso ocorrer com frequência, significa que o destino pode ter um problema de desempenho.
Esse valor é redefinido a cada 60 segundos.
thread-count
Número
>=0
Número de segmentos disponíveis no pool para trabalhar. O DSA não tem mais segmentos de back-end, portanto, esses contadores que aparecem no SNMP foram ignorados.
thread-mean
Número
>=0
Número médio de segmentos ativos dos segmentos disponíveis
Exemplo de formato de estatísticas internas do DSA
    { "dxserver-monitor": {
        "host-name": "hostname.com",
        "dsa-name": "data",
        "time": "20150223.214700.014",
        "dsastats" : {
          "associations": 2,
          "nil-credit": 0,
          "queued-ops": 1,
          "queued-remote-ops": 1,
          "ops-processed": 10,
          "entries-returned": 34,
          "mw-queue": 0,
          "mw-not-sent": 0,
          "busy": 0,
          "memory-trees": 25,
          "memory-usage": 6,
          "mallocs": 0,
          "buffers": 10,
          "free-buffers": 0,
          "selects": 3850,
          "write-selects": 0,
          "thread-count": 8,
          "thread-mean": 0
        }
      }
    }
Formato da resposta
Quando o DSA envia uma solicitação por meio do REST, uma resposta do servidor deve ser enviada de volta ao DSA. Embora não seja uma imposição do DSA, isso pode ser usado para indicar um problema com o processamento da resposta e ajuda a diagnosticar problemas de monitoramento no servidor. Talvez seja mais eficiente para o terminal não enviar respostas.
Atualmente, o DSA espera que as respostas HTTP e o corpo da resposta a seguir sejam ignorados.
Mensagens de resposta
Código de status HTTP
Reason
403
O evento falhou ao realizar a verificação de autorização básica HTTP
200 ou 204
O evento foi processado com êxito