Configurando terminais externos

Você pode configurar terminais de monitoramento externos usando os arquivos de configuração de DSA. O comando set external-monitor permite configurar vários terminais.
cad140br
Você pode configurar terminais de monitoramento externos usando os arquivos de configuração de DSA. O comando
set external-monitor
permite configurar vários terminais.
As seguintes opções de configuração são usadas para o monitoramento externo:
clear external-monitor;
get external-monitor;
set external-monitor <label> = { <monEndPointDef> <monEventDef>
                                  <monVersionDef> <monCredDef> <monOptionsDef>
                                  <monFormatDef> <monPushInterval> };
<label>              ::=     <string>
<monEendPointDef>    ::=     endpoint = <string>
<monEventDef>        ::=     monitor-events = <event-list>
<monCredDef>         ::=     credentials = username <string> password <string> | NULL
 <monOptionsDef>      ::=     options = no-http-header | NULL
 <monPushInterval>    ::=     push-interval = <num> | NULL
 <event-list>         ::=     <event> | <event> , <event-list>
 <event>              ::=     alarm-log-all | alarm-log-information | alarm-log-critical |
                              alarm-log-caution | update-log | query-log |
                              auth-failures | account-susp | op-error | mw-error |
                              multiwrite | cache | stats | dsastats
clear external-monitor;
Essa opção limpa a lista atual de terminais de monitoramento externos. Essa ação é necessária quando a configuração é recarregada por
dxserver init
.
get external-monitor;
Essa opção exibe uma lista de terminais configurados pelo
DXconsole
.
set external-monitor ...
label (obrigatório)
Um rótulo para identificar exclusivamente o bloco de configuração atual do terminal.
endpoint (obrigatório)
O formato do terminal é: http[s]://host:port[/uri]
Quando https é especificado, o DSA transmite mensagens de monitoramento por um link SSL criptografado. Essa transmissão por meio do link SSL requer a seguinte configuração adicional do DSA:
  • Certificado de personalidade do DSA para cada DSA
  • $DXHOME/config/ssld/trusted.pem deve incluir o certificado de autoridade de certificação de raiz pública proveniente do servidor que está recebendo as informações de monitoramento. Esse certificado é verificado pelo DSA durante o handshake SSL.
O componente uri opcional é anexado a dxmonitor/v1 uri, no local do objeto de monitoramento.
Observação:
todos os DSAs configurados para monitoramento externo exigem acesso (roteamento) ao hostname do terminal configurado.
monitor-events (obrigatório)
A tabela a seguir descreve os diversos eventos, disparadores e o objeto de monitoramento.
monitor-events
Descrição
Objeto de monitoramento produzido
Disparador
alarm-log-critical
Recebe mensagens de alarme crítico.
alarm
Evento de alarme
alarm-log-caution
Recebe mensagens de alarme de advertência.
alarm
Evento de alarme
alarm-log-information
Recebe mensagens de alarme informativo.
alarm
Evento de alarme
alarm-log-all
Recebe todas as mensagens de alarme.
alarm
Evento de alarme
query-log
Recebe informações de solicitação/resposta para cada operação de diretório.
log
Todas as solicitações de diretório e de resposta
update-log
Recebe detalhes de atualizações para solicitações de atualizações aplicadas com êxito.
log
Atualização bem-sucedida
auth-failures
Recebe mensagens para usuários que não conseguiram se autenticar.
event
Recusa de autenticação (vinculação)
account-susp
Recebe mensagens para os usuários que tiveram suas contas suspensas.
event
Conta suspensa devido à política de senha
op-error
Recebe informações sobre as operações com falha.
event
Solicitação com falha
mw-error
Recebe informações sobre as entradas que apresentaram falha ao atualizar quando replicadas. Isso pode indicar uma inconsistência nos dados.
event
Falha na replicação de gravação múltipla devido a um erro secundário
cache
Recebe informações estatísticas do cache.
cache
Timer:
push-interval
configurado (padrão: 60 segundos)
dsastats
Recebe informações estatísticas internas do DSA.
dsastats
Timer: 60 segundos
multiwrite
Recebe o status da fila de gravação múltipla. Uma mensagem é enviada para cada par de gravação múltipla.
multiwrite
Timer:
push-interval
configurado (Padrão: 60 segundos)
stats
Recebe um número de contadores que abrangem todas as operações do diretório.
stats
Timer:
push-interval
configurado (Padrão: 60 segundos)
              
Aviso:
tenha cuidado ao usar as opções
query-log
e
update-log
em ambientes de volume grande. O volume de tráfego gerado pode afetar seriamente o desempenho e a utilização da memória. Se a consolidação do log for necessária, uma ferramenta de plano de fundo atuando diretamente nos arquivos query-log e update-log files é a melhor opção.
credentials (opcional)
As credenciais usam este formato:
username <string> password <string>
Quando configurados, o nome de usuário e a senha são incluídos no cabeçalho de autorização HTTP (básico). Isso protege o terminal contra o registro de eventos desnecessários.
Uma senha pode ser codificada e incluída pelo comando
dxpassword -P CADIR password
.
Exemplo:
% dxpassword -P CADIR password
{CADIR}2RqNRjmDUKw=
….
credentials = username monitorUser password {CADIR}2RqNRjmDUKw=
….
options (opcional)
Veja a seguir as opções adicionais:
no-http-header
Esta opção envia somente a linha PUT da solicitação HTTP e o corpo da solicitação. Essa ação pode ajudar alguns terminais com o processamento de eventos sendo recebidos.
message-dates-gmt
Esta opção envia mensagens de monitoramento com as datas no formato GMT. Esse formato ajuda a sequenciar as mensagens onde os DSAs são executados em fusos horários diferentes.
push-interval (opcional)
Essa opção define o número de segundos para envio de eventos acionados por temporizador. Para evitar o excesso de tráfego de monitoramento, o valor deve ser maior ou igual a 5 segundos.
Observação:
ao usar monitoring-event = dsastats, você não poderá configurar essa opção, pois ela compartilha os cálculos de estatísticas internas existente que são redefinidos entre instantâneos a cada 60 segundos. 
Os seguintes eventos suportam essa opção:
monitoring-event = multiwrite, stats, cache.
Exemplo de configuração
clear external-monitor;
set external-monitor STATS = {
endpoint = "http://hostname.com:8080/rest"
monitor-events = stats, cache, multiwrite
credentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="
push-interval = 120
};
# dsastats must occur every 60 seconds
set external-monitor DSASTATS = {
endpoint = "http://hostname.com:8080/rest"
monitor-events = dsastats
credentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="
};
set external-monitor EVENTS = {
endpoint = "http:// hostname.com:8080/rest"
monitor-events = auth-failures, account-susp, op-error, mw-error
credentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="
};
# protect confidential information
set external-monitor ENCRYPTED = {
endpoint = "https://hostname.com:8443/rest"
monitor-events = alarm-log-all, update-log, query-log
options = no-http-header, message-dates-gmt
credentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="
};