xymon - Online na nuvem

PROGRAMA:

NOME

xymon - programa de comunicação do cliente Xymon

SINOPSE

xímon [opções] RECIPIENTE mensagem

DESCRIÇÃO

xímon(1) é o programa cliente usado para se comunicar com um servidor Xymon. É frequente
usado por sistemas cliente Xymon para enviar mensagens de status e alertas de pager em testes locais.

No Xymon, o programa xymon também é usado para fins administrativos, por exemplo, para renomear ou
excluir hosts ou desabilitar hosts que estão inativos por longos períodos de tempo.

OPÇÕES E PARÂMETROS

--depurar
Habilite a depuração. Isso imprime detalhes sobre como a conexão com o Xymon
servidor está sendo estabelecido.

--proxy =http://PROXYSERVER:PORTA PROXY/
Ao enviar as mensagens de status via HTTP, use este servidor como um proxy HTTP
de se conectar diretamente ao servidor Xymon.

--timeout = N
Especifica o tempo limite para conexão com o servidor Xymon, em segundos. O padrão
é 5 segundos.

--resposta
O utilitário xymon normalmente sabe quando esperar uma resposta do servidor, portanto,
opção não é necessária. No entanto, isso fará com que qualquer resposta do servidor seja
exibido.

--mesclar
Mesclar o texto da mensagem da linha de comando com os dados fornecidos na entrada padrão e
envie o resultado para o servidor Xymon. O texto da mensagem fornecido na linha de comando
torna-se a primeira linha da mensagem mesclada.

RECIPIENTE
A RECIPIENTE parâmetro define qual servidor recebe a mensagem. Se RECIPIENT for
dado como "0.0.0.0", a mensagem é enviada a todos os servidores listados no
Variável de ambiente XYMSERVERS.

Normalmente, um cliente usará "$ XYMSRV" para o RECIPIENTE parâmetro, pois este é
definido para que os scripts do cliente contenham automaticamente o valor correto.

A RECIPIENTE parâmetro pode ser um URL para um servidor da web que tem o xymoncgimsg.cgi
ou script semelhante instalado. Isso canaliza as mensagens Xymon para o servidor Xymon
usando o protocolo HTTP padrão. o xymoncgimsg.cgi(8) Ferramenta CGI (incluída no Xymon)
deve ser instalado no servidor web para que o transporte HTTP funcione.

MENSAGEM
A mensagem parâmetro é a mensagem a ser enviada ao servidor Xymon.
As mensagens devem ser colocadas entre aspas, mas, ao fazer isso, podem abranger várias linhas.
O tamanho máximo de uma mensagem é definido pelo comprimento máximo permitido de seu
linha de comando do shell e é normalmente 8-32 KB.

Se precisar enviar mensagens de status mais longas, você pode especificar "@" como a mensagem:
O xymon irá então ler a mensagem de status de seu stdin.

XIMON MENSAGEM SINTAXE

Esta seção lista as mensagens mais comumente usadas no protocolo Xymon.

Cada mensagem deve começar com um dos comandos Xymon. Onde um HOSTNAME é especificado, ele
deve ter qualquer ponto no nome do host alterado para vírgulas se a configuração FQDN do Xymon estiver habilitada
(que é o padrão). Portanto, o host "www.foo.com", por exemplo, relataria como
"www, foo, com".

status [+ LIFETIME] [/ grupo: GROUP] HOSTNAME.TESTNAME COLOR
Isso envia uma mensagem de status para um único teste (coluna) em um único host.
TESTNAME é o nome da coluna onde este teste aparecerá; qualquer nome é válido
exceto que usar pontos no testname não funcionará. COLOR deve ser um dos
cores válidas: "verde", "amarelo", "vermelho" ou "transparente". As cores "azul" e "roxo"
- embora cores válidas - não devem ser enviadas em uma mensagem de status, pois são
manipulado especialmente pelo servidor Xymon. Como um caso especial (para apoiar mais velhos
clientes), "cliente" pode ser usado como o nome da cor. Isso faz com que o status
mensagem a ser tratada pelo Xymon como uma mensagem de dados do "cliente", e o TESTNAME
parâmetro é usado como o "id do coletor".
O "texto adicional" normalmente inclui um carimbo de data / hora local e um resumo do teste
resultado na primeira linha. Quaisquer linhas após a primeira são de formato livre e podem
inclua qualquer informação que possa ser útil para diagnosticar o problema que está sendo relatado.
O LIFETIME define por quanto tempo esse status é válido após ser recebido pelo
Servidor Xymon. O padrão é 30 minutos, mas você pode definir o período de sua preferência. Por exemplo
para um teste personalizado que é executado uma vez por hora, você deve definir isso para pelo menos 60
minutos - caso contrário, o status ficará roxo após 30 minutos. É uma boa ideia
para definir LIFETIME para um pouco mais do que o intervalo entre seus testes, para
permitir variações no tempo que leva para o teste ser concluído. O LIFETIME está em
minutos, a menos que você adicione um "h" (horas), "d" (dias) ou "w" (semanas) imediatamente após
o número, por exemplo, "status + 5h" para um status válido por 5 horas.
A opção GRUPO é usada para direcionar alertas do status para um grupo específico. Isto
é usado atualmente para o status gerado a partir dos dados dos clientes Xymon, por exemplo, para direcionar
alertas para um status "procs" para pessoas diferentes, dependendo exatamente de qual processo
está para baixo.

notificar HOSTNAME.TESTNAME
Isso aciona uma mensagem informativa a ser enviada para aqueles que recebem alertas para
esta combinação HOSTNAME + TESTNAME, de acordo com as regras definidas em Alert.cfg(5)
Isso é usado pelo enadis.cgi(1) ferramenta para notificar as pessoas sobre hosts sendo desativados
ou habilitado, mas também pode servir como uma forma geral de notificar os administradores do servidor.

dados HOSTNAME.DATANAME
A mensagem "dados" permite que as ferramentas enviem dados sobre um host, sem que apareça como
uma coluna nas páginas da web do Xymon. Isso é usado, por exemplo, para relatar estatísticas
sobre um host, por exemplo, dados vmstat, que por si só não representam algo que
tem uma identidade vermelha, amarela ou verde. É usado por módulos de alimentação inferior RRD, entre
outros. No Xymon, as mensagens de dados são, por padrão, processadas apenas pelo xymond_rrd(8)
módulo. Se você quiser lidar com mensagens de dados usando um aplicativo externo, você pode
deseja habilitar o xymond_filestore(8) módulo para mensagens de dados, para armazenar dados
mensagens em um formato compatível com a forma como o daemon do Big Brother faz.

desativar HOSTNAME.TESTNAME DURATION
Desativa um teste específico por DURATION minutos. Isso fará com que o status deste
teste a ser listado como "azul" no servidor Xymon, e nenhum alerta para este host / teste
será gerado. Se DURATION for dado como um número seguido por s / m / h / d, é
interpretado como sendo em segundos / minutos / horas / dias, respectivamente. Para desativar um
teste até ficar OK, use "-1" como a DURAÇÃO. Para desativar todos os testes de um
host, use um asterisco "*" para TESTNAME.

habilitar HOSTNAME.TESTNAME
Reativa um teste que foi desativado.

consulta HOSTNAME.TESTNAME
Consulte o servidor Xymon para obter o status mais recente relatado para este teste específico. Se
o status do host / teste é conhecido, a resposta é a primeira linha do relatório de status
- a cor atual será a primeira palavra da linha. Linhas adicionais de texto
que pode estar presente na mensagem de status não pode ser recuperado.
Isso permite que qualquer cliente Xymon determine o status de um teste específico, seja
é aquele pertencente ao host onde o cliente está sendo executado, algum outro host ou
talvez o resultado de um teste combinado de vários hosts gerenciados por estado combinado(1)
Isso normalmente será útil para scripts de extensão de cliente Xymon, que precisam
determinar o status de outros hosts, por exemplo, para decidir se um
ação de recuperação deve ser iniciada.

configuração FILENAME
Recupere um dos arquivos de configuração do Xymon do servidor. Este comando permite
um cliente para puxar arquivos do diretório $ XYMONHOME / etc / no servidor, permitindo
para atualizações semiautomáticas da configuração do cliente. Desde a configuração
arquivos são projetados para ter um arquivo comum para a configuração de todos os hosts no
sistema - e esta é de fato a maneira recomendada de configurar seus clientes - este
torna mais fácil manter os arquivos de configuração sincronizados.

largar HOSTNAME
Remove todos os dados armazenados sobre o host HOSTNAME. Presume-se que você tenha
já excluiu o host do arquivo de configuração hosts.cfg.

largue HOSTNAME TESTNAME
Remova os dados sobre um único teste (coluna).

renomear OLDHOSTNAME NEWHOSTNAME
Renomeie todos os dados de um host que teve seu nome alterado. Você deve fazer isso depois
alterando o nome do host no arquivo de configuração hosts.cfg.

renomear HOSTNAME OLDTESTNAME NEWTESTNAME
Renomeie os dados sobre um único teste (coluna).

xymondlog HOSTNAME.TESTNAME
Recupere o log de status do Xymon para um único teste. A primeira linha da resposta
contém uma série de campos separados por uma barra vertical:

hostname O nome do hospedeiro

nome de teste O nome do teste

cor Cor do status (verde, amarelo, vermelho, azul, claro, roxo)

sinalizadores de teste Para testes de rede, os sinalizadores indicam detalhes sobre o teste (usado por
xímongênio).

última mudança Carimbo de data / hora Unix quando a cor de status foi alterada pela última vez.

tempo de registro Timestamp Unix quando a mensagem de log foi recebida.

Tempo válido Timestamp Unix quando a mensagem de log não é mais válida (fica roxo em
desta vez).

tempo de confirmação Ou -1 ou carimbo de data / hora Unix quando uma confirmação ativa expira.

tempo da desgraça Ou -1 ou carimbo de data / hora Unix quando o status não está mais desabilitado.

transmissor Endereço IP de onde o status foi recebido.

biscoito -1 ou o valor do cookie usado para reconhecer um alerta.

agradecimento Vazio ou a mensagem de confirmação enviada quando o status foi confirmado.
Nova linha, barras verticais e barras invertidas são escapadas com uma barra invertida, estilo C.

mensagem Vazio ou a mensagem enviada quando o status foi desabilitado. Nova linha, sinais de tubulação
e as barras invertidas são escapadas com uma barra invertida, estilo C.

Após a primeira linha, vem o registro de status completo em formato de texto simples.

xymondxlog HOSTNAME.TESTNAME
Recupera uma string XML contendo o log de status como no comando "xymondlog".

xymondboard [CRITÉRIOS] [campos = FIELDLIST]
Recupera um resumo do status de todos os testes conhecidos disponíveis para o daemon Xymon.

Por padrão - se nenhum CRITÉRIO for fornecido - ele retorna uma linha para todos os status
mensagens que são encontradas em Xymon. Você pode filtrar a resposta por seleção específica
página, host, teste, cor ou vários outros campos. O PAGEPATH, NETWORK, HOSTNAME,
Os parâmetros TESTNAME e * MSG são interpretados como expressões regulares compatíveis com perl;
o parâmetro COLOR aceita várias cores separadas por vírgulas; os valores * TIME
aceitar carimbos de data / hora unix epoch. Outras variáveis ​​identificadas em xymon-xmh(5) também pode
ser usado.

Como a filtragem do host é feita antes da filtragem de teste, é mais eficiente (com
conjuntos de dados muito grandes) para usar PAGEPATH, HOSTNAME, NETWORK e outros filtros XMH_
quando possível, antes de filtrar globalmente com COLOR, * MSG, * TIME ou TESTNAME.

Você pode filtrar, por exemplo, um nome de host e um nome de teste.

page = PAGEPATH Incluir apenas testes de hosts encontrados na página PAGEPATH no
arquivo hosts.cfg.

net = NETWORK Incluir apenas testes de hosts com esta tag NET:

ip = IPEndereço Inclui apenas testes de hosts com este endereço IP. Este é um regex,
não CIDR.

host = HOSTNAME Inclui apenas testes do host HOSTNAME

test = TESTNAME Inclui apenas testes com o testname TESTNAME

color = COLORNAME Inclui apenas testes em que a cor do status é COLORNAME

tag = TAGNAME Inclui apenas hosts com uma determinada tag especificada no hosts.cfg(5)
linha. Observe que apenas os itens conhecidos pelos componentes do xymon estão incluídos aqui; arbitrário
texto não está incluído

XMH_string = VALUE Inclui apenas hosts com um xymon-xmh(5) variável correspondente a esta
valor

Filtragem Avançada

msg = MENSAGEM Incluir apenas testes com conteúdo completo que corresponda a MESSAGE. Use "\ s" para
espaços de escape (ou outras strings PCRE)

ackmsg = MENSAGEM Incluir apenas testes com MENSAGEM de reconhecimento (s). Use "\ s" para
espaços de escape (ou outras strings PCRE)

dismsg = MENSAGEM Inclui apenas testes que foram desativados com correspondência de strings
MENSAGEM. Use "\ s" para escapar espaços (ou outras strings PCRE). (É mais eficiente
para emparelhar com color = blue.)

Filtros de carimbo de data / hora

Certos campos (explicados abaixo) podem ser filtrados com carimbos de data / hora unix e com o
seguintes desigualdades:> => <= <=! =

Esses filtros são: lastchange, logtime, validtime, acktime, disabletime

A resposta é uma linha para cada status que corresponda aos CRITÉRIOS ou todos os status
se nenhum critério for especificado. A linha é composta por vários campos, separados
por um sinalizador. Você pode selecionar quais campos recuperar, listando-os no
FIELDLIST. Os seguintes campos estão disponíveis:

hostname O nome do hospedeiro

nome de teste O nome do teste

cor Cor do status (verde, amarelo, vermelho, azul, claro, roxo)

bandeiras Para testes de rede, os sinalizadores indicam detalhes sobre o teste (usado por
xímongênio).

última mudança Carimbo de data / hora Unix quando a cor de status foi alterada pela última vez.

tempo de registro Timestamp Unix quando a mensagem de log foi recebida.

Tempo válido Timestamp Unix quando a mensagem de log não é mais válida (fica roxo em
desta vez).

tempo de confirmação Ou -1 ou carimbo de data / hora Unix quando uma confirmação ativa expira.

tempo da desgraça Ou -1 ou carimbo de data / hora Unix quando o status não está mais desabilitado.

transmissor Endereço IP de onde o status foi recebido.

biscoito -1 ou o valor do cookie usado para reconhecer um alerta.

line1 Primeira linha do registro de status.

agradecimento Vazio (se nenhuma confirmação estiver ativa), ou o texto da confirmação
mensagem.

mensagem Vazio (se o status estiver ativado no momento), ou o texto da desativação
mensagem.

msg O texto completo da mensagem de status atual.

cliente Mostra "S" se houver dados do cliente disponíveis, "N" se não houver.

clntstamp Timestamp quando a última mensagem do cliente foi recebida, em Unix "época"
formato.

lista de ack Lista dos reconhecimentos atuais de um teste. Esta é uma string de texto com
vários campos, delimitados por dois pontos. Existem 5 campos: Timestamp para
quando o ack foi gerado e quando ele expira; o "nível de confirmação"; o usuário que
enviou o ack; e o texto de confirmação.

flapinfo Diz se o status está oscilando. 5 campos, delimitados por "/": Um "0" se o
o status não está oscilando e "1" se estiver oscilando; carimbo de data / hora quando o status mais recente
a mudança foi registrada e quando a primeira mudança de status foi registrada; e os dois
cores entre as quais o status está oscilando.

stats Número de mudanças de status que foram registradas para este status desde xymond
Começou.

modificadores Lista todos os modificadores ativos para este status (ou seja, atualizações enviadas usando um
comando "modificar").

XMH_ * As tags XMH referem-se ao Xymon hosts.cfg(5) definições de configuração. Um cheio
lista destes pode ser encontrada no xymon-xmh(5) página do manual.

Os campos ackmsg, dismsg e msg têm certos caracteres codificados: Newline é "\ n",
TAB é "\ t", retorno de carro é "\ r", uma barra vertical é "\ p" e uma barra invertida é "\\".

Se o parâmetro "fields" for omitido, um conjunto padrão de
hostname, testname, color, flags, lastchange, logtime, validtime, acktime, disabletime, sender, cookie, line1
é usado.

xymondxboard
Recupera uma string XML com o resumo de todos os logs de status para o
comando "xymondboard".

hostinfo [CRITÉRIOS]
Recupera a configuração atual de um host (ou seja, o hosts.cfg(5) definição).
CRITÉRIOS seleciona quais hosts (s) para relatar, e é idêntico aos CRITÉRIOS no
comando xymondboard.

A resposta é uma linha para cada host que corresponda aos CRITÉRIOS, ou todos os hosts se
nenhum critério é especificado. A linha é composta por vários campos, separados por
um sinal de tubo. Os primeiros dois campos serão sempre o nome do host e o endereço IP.
Os campos restantes - se houver - são as tags hosts.cfg em nenhuma ordem específica.

baixar FILENAME
Baixe um arquivo do diretório de download do servidor Xymon.

cliente [/ COLLECTORID] HOSTNAME.OSTYPE [HOSTCLASS]
Usado para enviar uma mensagem de "cliente" ao servidor Xymon. As mensagens do cliente são geradas
pelo cliente Xymon; quando enviados para o servidor Xymon, eles são comparados com o
regras no análise.cfg(5) arquivo de configuração e mensagens de status são geradas
para os testes do lado do cliente. O COLLECTORID é usado ao enviar dados do cliente que
são adições aos dados do cliente padrão. Os dados serão concatenados com o
dados normais do cliente.

clientlog HOSTNAME [seção = SECTIONNAME [, SECTIONNAME ...]]
Recupera a última mensagem bruta do cliente enviada pela última vez por HOSTNAME. O opcional
O filtro "seção" é usado para selecionar seções específicas dos dados do cliente.

ping Tenta entrar em contato com o servidor Xymon. Se for bem-sucedido, o ID da versão do servidor Xymon é
relatado.

puxar cliente
Esta mensagem é usada ao buscar dados do cliente por meio do mecanismo "pull" implementado
by xymonfetch(8) e msgcache(8) para clientes que não podem se conectar diretamente ao
Servidor Xymon.

lista fantasma
Relate uma lista de fantasma clientes vistos pelo servidor Xymon. Fantasmas são sistemas que
relatar dados para o servidor Xymon, mas não estão listados no arquivo hosts.cfg.

agendar [COMANDO TIMESTAMP]
Agenda um comando enviado ao servidor Xymon para execução posterior. Por exemplo
usado para programar a desativação de um host ou serviço em algum momento no futuro. COMANDO
é um comando Xymon completo, como os listados acima. TIMESTAMP é o Unix
época em que o comando será executado.
Se nenhum parâmetro for fornecido, as tarefas agendadas atualmente são listadas no
resposta. A resposta é uma linha por comando agendado, com o id do trabalho, o
hora em que o comando será executado, o endereço IP de onde foi enviado,
e a string de comando completa.
Para cancelar um comando previamente agendado, "cronograma cancelar ID DE TRABALHO" pode ser usado.
JOBID é um número fornecido como o primeiro item na saída da lista de programação.

notas FILENAME
O texto da mensagem será armazenado em $ XYMONHOME / notes / FILENAME que é então usado como
hiperlinks de nomes de host ou nomes de coluna. Isso requer que a tarefa "notas de armazenamento"
está habilitado em tasks.cfg (é desabilitado por padrão). FILENAME não pode conter nenhum
caminho do diretório - eles são removidos automaticamente.

ID do usuário
Essas mensagens serão retransmitidas diretamente para os módulos ouvindo no canal do "usuário"
do daemon Xymon. Isso se destina à comunicação personalizada entre o lado do cliente
módulos e o servidor Xymon.

modificar HOSTNAME.TESTNAME COLOR SOURCE CAUSE
Modifica a cor de um status específico, sem gerar um status completo
mensagem. Isso é para processadores de back-end (por exemplo, gráficos RRD) que podem substituir o
cor de um status com base em alguns critérios determinados fora do fluxo normal de um
status. Por exemplo, o status normal "conn" pode parecer verde, uma vez que apenas verifica
sobre se um host pode receber ping ou não; o manipulador RRD pode então usar um "modificar"
comando para substituir este é o tempo de resposta real do ping excede um determinado limite.
(Veja a definição de configuração "DS" em análise.cfg(5) para saber como fazer isso). FONTE
é alguma identificação do módulo que gera a mensagem "modificar" - futuro
as modificações devem usar a mesma fonte. Pode haver várias fontes que modificam
o mesmo status (o status mais grave torna-se então a cor real do
status). CAUSE é uma string de texto de uma linha explicando a razão para substituir o
cor de status normal - será exibida na página de status da web.

EXEMPLO

Envie uma mensagem de status normal para o servidor Xymon, usando o protocolo Xymon padrão em TCP
porta 1984:
$ $ XYMON $ XYMSRV "status www, foo, com.http green` date` Web OK "

Envie a mesma mensagem de status, mas usando o protocolo HTTP por meio do xymoncgimsg.cgi do servidor da web
script:
$ $ XYMON http://bb.foo.com/cgi-bin/xymoncgimsg.cgi "status www, foo, com.http verde
`data` Web OK"

Use a mensagem "query" para determinar a cor do teste "www" e reinicie o Apache se estiver
vermelho:

$ WWW = `$ XYMON $ XYMSRV" consulta www, foo, com.www "| awk '{print $ 1}' `
$ if ["$ WWW" = "vermelho"]; então /etc/init.d/apache restart; fi

Use a mensagem "config" para atualizar um arquivo local mytest.cfg (mas apenas se obtivermos uma resposta):

$ $ XYMON $ XYMSRV "config mytest.cfg"> /tmp/mytest.cfg.new
$ if [-s /tmp/mytest.cfg.new]; então
mv /tmp/mytest.cfg.new $ XYMONHOME / etc / mytest.cfg
fi

Envie uma mensagem de status muito grande que foi construída no arquivo "statusmsg.txt". Em vez de
de fornecê-lo na linha de comando, passe-o via stdin para o comando xymon:

$ cat statusmsg.txt | $ XYMON $ XYMSRV "@"

Use xymon online usando serviços onworks.net