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, multiwritecredentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="push-interval = 120};# dsastats must occur every 60 secondsset external-monitor DSASTATS = {endpoint = "http://hostname.com:8080/rest"monitor-events = dsastatscredentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="};set external-monitor EVENTS = {endpoint = "http:// hostname.com:8080/rest"monitor-events = auth-failures, account-susp, op-error, mw-errorcredentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="};# protect confidential informationset external-monitor ENCRYPTED = {endpoint = "https://hostname.com:8443/rest"monitor-events = alarm-log-all, update-log, query-logoptions = no-http-header, message-dates-gmtcredentials = username "dxmonitor" password "{CADIR}2RqNRjmDUKw="};