xymongen - Online na nuvem

PROGRAMA:

NOME

xymongen - gerador de página da web Xymon

SINOPSE

xímongen -?
xímongen --Socorro
xímongen --versão
xímongen [opções] [diretório de saída]
(Consulte a seção OPÇÕES para obter uma descrição das opções de linha de comando disponíveis).

DESCRIÇÃO

xímongen gera as páginas da web de visão geral para o monitor Xymon. Estas são as páginas da web
que mostram o status geral de seus hosts, não as páginas de status detalhadas de cada teste.

Observação: os dados das páginas da web são recuperados do xymond(8) daemon, e xymongen usa
os valores das variáveis ​​de ambiente XYMSRV / XYMSERVERS para determinar a rede
endereço onde xymond pode ser alcançado. Se você tiver mais de um servidor listado em
XYMSERVERS, certifique-se de que o primeiro é o servidor Xymon local - este é o que
xymongen irá consultar os dados.

OPÇÕES

xymongen tem um grande número de opções de linha de comando. As opções podem ser usadas para mudar
o comportamento de xymongen e afetam as páginas da web geradas por ele.

SUPORTE OPÇÕES

--ajuda ou -?
Fornece um resumo das opções de linha de comando disponíveis.

--versão
Imprime o número da versão do xymongen

--docurl = URL
Esta opção está obsoleta, use a configuração HOSTDOCURL em xymonserver.cfg(5)
ao invés.

--doccgi = URL
Esta opção está obsoleta, use a configuração HOSTDOCURL em xymonserver.cfg(5)
ao invés.

--doc-janela
Faz com que links para documentação de hosts e serviços sejam abertos em uma nova janela. o
o padrão é mostrar a documentação na mesma janela do navegador que o status do Xymon.

--htmlextension = .EXTENSION
Define a extensão do nome de arquivo usada para as páginas da web geradas por xymongen. Por
padrão, uma extensão de ".html" é usada. Observe que você precisa especificar o "ponto".

--report [= COLUMNNAME]
Com esta opção, o xymongen irá enviar uma mensagem de status com detalhes de quantos
hosts foram processados, quantas páginas foram geradas, quaisquer erros que ocorreram
durante a execução e algumas estatísticas de tempo. O nome da coluna padrão é "xymongen".

--htaccess [= htaccess-filename]
Crie arquivos .htaccess quando novos diretórios de páginas da web forem criados. O conteúdo de
os arquivos .htaccess são determinados pela variável de ambiente XYMONHTACCESS (para
o diretório de nível superior com xymon.html e nongreen.html); pelo
Variável XYMONPAGEHTACCESS (para os diretórios de nível de página); e pelo
Variável XYMONSUBPAGEHTACCESS para diretórios de subpágina e subparent. o
nome do arquivo dos arquivos .htaccess padrão para ".htaccess" se nenhum nome de arquivo for fornecido com
esta opção. A variável XYMONHTACCESS é copiada literalmente para o nível superior
arquivo .htaccess. A variável XYMONPAGEHTACCESS pode conter um "% s" onde o nome
da página é inserido. A variável XYMONSUBPAGEHTACCESS pode conter dois "% s"
instâncias: o primeiro é substituído pelo nome da página, o segundo pelo
nome da subpágina.

--max-eventcount = N
Limite o log de eventos na página "Todos os não verdes" a apenas N eventos. Padrão: 100.

--max-eventtime = N
Limite o log de eventos na página "Todos os não verdes" para eventos que aconteceram dentro do
nos últimos N minutos. Padrão: 240.

--no-eventlog
Desative o log de eventos normalmente exibido na página "Todos os não verdes"

--max-ackcount = N
Limite o registro de confirmação na página "Todos os não verdes" a apenas N eventos. Predefinição:
25.

--max-acktime = N
Limite o registro de reconhecimento na página "Todos os não verdes" para acks que aconteceram
nos últimos N minutos. Padrão: 240.

--no-acklog
Desative o registro de confirmação normalmente exibido na página "Todos os não verdes".

--cricitcallog [= coluna de registro crítica]
Isso gera um registro baseado em texto do que é mostrado na página de status critical.html,
e envia uma mensagem de status para o próprio servidor Xymon refletindo a cor do
Página de status crítico. Isso permite que você acompanhe quando surgiram problemas no
página de status crítico. O arquivo de log é armazenado em $ XYMONSERVERLOGS / criticalstatus.log

--loadhostsfromxymond
Em vez de ler o arquivo hosts.cfg, o xymongen carregará o arquivo hosts.cfg
configuração do daemon xymond. Isso elimina a necessidade de ler o
hosts.cfg, e se você tiver xymond e xymongen em execução em hosts diferentes, ele também
elimina a necessidade de copiar o arquivo hosts.cfg entre os sistemas. Observe que o
A opção "dispinclude" em hosts.cfg é ignorada quando esta opção está habilitada.

PAGE LAYOUT OPÇÕES

Essas opções afetam como as páginas da web geradas por xymongen aparecem no navegador.

--páginas-último
Coloque links de página e subpágina após os hosts.

--páginas-primeiro
Coloque links de página e subpágina antes dos hosts (padrão).

Essas duas opções decidem se uma página com links para subpáginas e hosts tem o
hosts ou as subpáginas primeiro.

--subpagecolumns = N
Determina o número de colunas usadas para links para páginas e subpáginas. O padrão
é N = 1.

--maxrows = N
Os títulos das colunas em uma página são, por padrão, mostrados apenas no início de uma página,
subpágina ou grupo de hosts. Esta opção faz com que os títulos das colunas se repitam para
cada N hosts mostrados.

--showemptygroups

--no-showemptygroups
Quando os grupos são hosts são feitos, exibe a tabela e os nomes dos hosts, mesmo se houver
nenhum teste presente para qualquer um dos hosts em questão. Use --no-showemptygroups para
ocultar. (Padrão: sim)

--pagetitle-links
Normalmente, apenas os "pontos" coloridos próximos a uma página ou subpágina agem como links para o
a própria página. Com esta opção, o título da página também terá um link para a página.

--pagetext-cabeçalhos
Use o texto de descrição das tags "página" ou "subpágina" como um título para o
página, em vez de "Páginas hospedadas localmente" ou outro título padrão.

--não-sublinhado-cabeçalhos
Normalmente, os cabeçalhos das páginas são sublinhados usando uma tag HTML "régua horizontal". Esse
opção desativa o sublinhado de títulos.

--recentgifs [= MINUTES]
Use imagens chamadas COLOR-recent.gif para testes, onde o status do teste foi alterado
nas últimas 24 horas. Esses arquivos GIF precisam ser instalados no
Diretório $ XYMONHOME / www / gifs /. Por padrão, o limite é definido para 24 horas - se
se você quiser de forma diferente, também pode especificar o limite de tempo. Por exemplo
"--recentgifs = 3h" mostrará os GIFs recentes por apenas 3 horas após uma mudança de status.

--sort-group-only-items
Em uma diretiva normal "somente grupo", você pode especificar a ordem em que os testes
são exibidos, da esquerda para a direita. Se você preferir ter os testes listados em
ordem alfabética, use esta opção - a página irá gerar "apenas para o grupo"
grupos como ele gera grupos normais e classifica os testes em ordem alfabética.

--dialupskin = URL
Se você quiser mostrar visualmente que um teste é um teste dial-up, você pode usar um alternativo
conjunto de ícones para o verde / vermelho / amarelo> / etc. imagens especificando esta opção. o
O parâmetro de URL especificado aqui substitui a configuração normal de XYMONSKIN
variável de ambiente, mas apenas para testes dial-up.

--reverseskin = URL
O mesmo que "--dialupskin", mas para testes reversos (testes com '!' Na frente).

--tooltips = [sempre, nunca, principal]
Determina quais páginas usam dicas de ferramentas para mostrar a descrição do host (do
Entrada COMENTÁRIO no hosts.cfg(5) Arquivo). Se definido para sempre, dicas de ferramentas são usadas em todos
Páginas. Se definido para nunca, dicas de ferramentas nunca são usadas. Se definido para principal, dicas são usadas
nas páginas principais, mas não nas páginas "Todos os não verdes" ou "Sistemas críticos".

COLUNA SELEÇÃO OPÇÕES

Essas opções afetam quais colunas (testes) são incluídos nas páginas da web geradas por
xímongênio.

--ignorecolumns = test [, test]
As colunas fornecidas serão completamente ignoradas por xymongen ao gerar páginas da web.
Pode ser usado para gerar relatórios onde você elimina alguns dos testes mais barulhentos,
como "msgs".

--critical-reds-somente
Apenas as colunas de status vermelhas serão incluídas na página Crítico. Por padrão, o
A página crítica conterá hosts com status vermelho, amarelo e transparente.

--nongreen-colors = COLOR [, COLOR]
Define quais cores fazem com que um teste apareça na página de status "Todos não verdes".
A COR é vermelha, amarela ou roxa. O padrão é incluir todos os três.

--nongreen-ignorecolumns = test [, test]
O mesmo que --ignorecolumns, mas se aplica a hosts apenas na página "Todos os não verdes".

--nongreen-ignoreroxos
Obsoleto, use "--nongreen-colors" no lugar.

--nongreen-ignoreialups
Ignore todos os hosts de discagem na página "Todos os não verdes", incluindo o log de eventos.

- sem páginas
Não gere as páginas normais (normalmente usado para gerar apenas as páginas não verdes
página).

--não-não-verde
Não gere a página "Todos não verdes".

--includecolumns = test [, test]
Sempre inclua essas colunas na página "Todos os não verdes" Irá incluir certas colunas
na página nongreen.html, independentemente de sua cor. Normalmente, nongreen.html descarta um
coluna de teste, se todos os testes forem verdes. Isso pode ser usado, por exemplo, para sempre ter um link para
a coluna de tendências (com os gráficos RRD) de sua página nongreen.html.

--eventignore = teste [, teste]
Ignore esses testes na exibição do log de eventos "Todos os não verdes".

STATUS PROPAGAÇÃO OPÇÕES

Essas opções suprimem a propagação normal de um status para cima na hierarquia da página.
Assim, você pode ter um teste com status amarelo ou vermelho, mas ainda ter a página inteira verde.
É útil para testes que não precisam causar um alarme, mas onde você ainda deseja saber o
Situação atual. Essas opções definem padrões globais para todos os hosts; você pode usar o NOPROPRED
e tags NOPROPYELLOW no hosts.cfg(5) arquivo para aplicar limites semelhantes em um por host
base.

--nopropyellow = test [, test] ou --noprop = test [, test]
Desabilite a propagação de status para cima quando AMARELO. A opção "--noprop" está obsoleta
e não deve ser usado.

--noproppurple = test [, test]
Desative a propagação de status para cima quando PURPLE.

--nopropred = test [, test]
Desabilite a propagação de status para cima quando VERMELHO ou AMARELO.

--nopropack = test [, test]
Desative a propagação de status para cima quando o status for confirmado. Se você quiser
para desativar a propagação de todos os testes reconhecidos, use "--nopropack = *".

PURPLE STATUS OPÇÕES

Os status roxos ocorrem quando o relatório de um status de teste é interrompido. Um status de teste é válido para um
quantidade limitada de tempo - normalmente 30 minutos - e após este tempo, o teste torna-se
roxa.

--purplelog = FILENAME
Gere um arquivo de log de todas as mensagens de status roxas.

ALTERNATE CONJUNTO DE PÁGINAS OPÇÕES

--pageset = PAGESETNAME
Crie páginas da web para um conjunto de páginas alternativo ao padrão. Veja a seção PAGESETS
abaixo.

--template = TEMPLATE
Use um modelo alternativo para arquivos de cabeçalho e rodapé. Normalmente usado junto com o
a opção "--pageset"; veja a seção PAGESETS abaixo.

ALTERNATE SAÍDA FORMATOS

--wml [= test1, test2, ...]
Esta opção faz com que o xymongen gere um conjunto de arquivos WML "cartão" que podem ser
acessado por um dispositivo WAP (telefone celular, PDA etc.) Os arquivos gerados contêm o
hosts que têm um status VERMELHO ou AMARELO nos testes especificados. Esta opção pode definir
os testes padrão a serem incluídos - os padrões podem ser substituídos ou alterados usando o
"WML:" ou "NK:" tags no hosts.cfg(5) Arquivo. Se nenhum teste for especificado, todos os testes
será incluso.

--nstab = FILENAME
Gere um arquivo HTML adequado para uma entrada da barra lateral do Netscape 6 / Mozilla. Para realmente
permitir que seus usuários obtenham essa entrada da barra lateral, você precisa deste código Javascript em
uma página da web (por exemplo, você pode incluí-la no arquivo $ XYMONHOME / web / stdnormal_header):


<!--
function addNetscapePanel () {
if ((typeof window.sidebar == "objeto") &&
(typeof window.sidebar.addPanel == "function"))
window.sidebar.addPanel ("Xymon",
"http://your.server.com/nstab.html"," ");
outro
alert ("Barra lateral apenas para Mozilla ou Netscape 6+");
}
// ->


e então você pode incluir um link "Adicionar isto à barra lateral" usando isto como um modelo:

Adicionar à barra lateral

ou se você preferir ter o botão padrão "Adicionar guia" do Netscape, você o faria
com


<IMG SRC="/gifs/add-button.gif" HEIGHT=45 WIDTH=100
ALT = "[Adicionar barra lateral]" STYLE = "borda: 0">


O "add-button.gif" está disponível no Netscape em
http://developer.netscape.com/docs/manuals/browser/sidebar/add-button.gif.

Se FILENAME não começar com uma barra, o arquivo da barra lateral do Netscape é colocado no
Diretório $ XYMONHOME / www /.

--nslimit = COR
A cor mínima a ser incluída na barra lateral do Netscape - o padrão é "vermelho", o que significa
apenas alertas críticos são incluídos. Se você quiser incluir avisos também, use
"--nslimit = amarelo".

--rss Gera fluxo de entrega de conteúdo RSS / RDF de seus alertas Xymon. Este formato de saída
pode ser incorporado dinamicamente em outras páginas da web, muito parecido com os feeds de notícias ao vivo, muitas vezes
visto em sites da web. Dois arquivos RSS serão gerados, um reflete o "Todos os não
página verde ", a outra reflete a página" Crítica ". Eles estarão na
Arquivos "nongreen.rss" e "critical.rss", respectivamente. Além disso, um arquivo RSS
será gerado para cada página e / ou subpágina listando os hosts presentes naquele
página ou subpágina.
O parâmetro FILENAME permitido anteriormente na opção --rss agora está obsoleto.
Para obter mais informações sobre feeds de conteúdo RSS / RDF, consulte
http://www.syndic8.com/.

--rssextension = .EXTENSION
Define a extensão do nome de arquivo usada para os arquivos RSS gerados por xymongen. Por
padrão, uma extensão de ".rss" é usada. Observe que você precisa especificar o "ponto".

--rssversão = {0.91 | 0.92 | 1.0 | 2.0}
O formato de saída desejado do feed RSS / RDF. A versão 0.91 parece ser a mais
formato comumente usado e é o padrão se esta opção for omitida.

--rsslimit = COR
A cor mínima a ser incluída no feed RSS - o padrão é "vermelho", significando apenas
alertas críticos são incluídos. Se você quiser incluir avisos também, use
"--rsslimit = amarelo".

OPÇÕES USAVA BY CGI TERMINA EM FRENTE

--reportopts = START: END: DYNAMIC: STYLE
Chame xymongen no modo de geração de relatório. Isso normalmente é usado pelo
relatório.cgi(1) Script CGI, mas também pode ser usado diretamente ao pré-gerar
relatórios. O parâmetro START é a hora de início para o relatório em Unix time_t
formato (segundos desde 1º de janeiro de 1970 00:00 UTC); END é a hora de término do relatório;
DYNAMIC é 0 para um relatório pré-criado e 1 para um relatório dinâmico (on-line); ESTILO é
"crit" para incluir apenas eventos críticos (vermelhos), "nongr" para incluir todos os não verdes
eventos e "todos" para incluir todos os eventos.

--csv = FILENAME
Usado junto com --reportopts, faz com que o xymongen gere uma disponibilidade
relatório na forma de um arquivo de valores separados por vírgula (CSV). Este formato é comumente
usado para importação em planilhas para processamento posterior.
O arquivo CSV inclui carimbos de data / hora Unix. Para exibi-los como tempos legíveis por humanos em
Excel, a fórmula = C2 / 86400 + DATEVALUE (1-jan-1970) (se você tiver o carimbo de data / hora Unix
na célula C2). A célula de resultado deve ser formatada como data / hora
campo. Observe que os carimbos de data / hora estão em UTC, então você também pode precisar lidar com
problemas de fuso horário e horário de verão.

--csvdelim = DELIMITER
Por padrão, uma vírgula é usada para delimitar campos na saída CSV. Alguns não ingleses
planilhas usam um delimitador diferente, normalmente ponto e vírgula. Para gerar um CSV
arquivo com o delimitador adequado, você pode usar esta opção para definir o caractere usado
como delimitador. Por exemplo, "--csvdelim =;" - observe que normalmente deve ser em dobro
aspas, para evitar que o shell Unix interprete o caractere delimitador como um
delimitador de linha de comando.

--snapshot = TIME
Gere um instantâneo das páginas do Xymon, como elas apareceram às TIME. TIME é dado como
segundos desde 1º de janeiro de 1970 às 00:00 UTC. Normalmente usado por meio do instantâneo.cgi(1) CGI
script.

DEPURAÇÃO OPÇÕES

--depurar
Faz com que o xymongen despeje grandes quantidades de saída de depuração em stdout, se fosse
compilado com o -DDEBUG habilitado. Ao relatar um problema com o xymongen, por favor
tente reproduzir o problema e fornecer a saída da execução do xymongen com este
opção.

--cronometragem
Despeje informações sobre o tempo gasto por várias partes do xymongen para o stdout. Esse
é útil para ver qual parte do processamento é responsável pelo tempo de execução do
xímongênio.
Nota: Esta informação também é fornecida na saída enviada para o display Xymon
ao usar a opção "--report".

EMPREENDIMENTO ALTERNATE CONJUNTOS DE PÁGINAS

Com a versão 1.4 do xymongen vem a possibilidade de gerar vários conjuntos de páginas de
os mesmos dados.
Suponha que você tenha dois grupos de pessoas olhando para as páginas da web do Xymon. O Grupo A deseja
têm os hosts agrupados pelo cliente a que pertencem. É assim que você configurou o Xymon -
o conjunto de páginas padrão. Agora o grupo B quer ter os hosts agrupados por sistema operacional -
vamos chamá-lo de conjunto "os". Em seguida, você adicionaria o layout da página a hosts.cfg assim:

ospage ganhar Microsoft Windows
ossubpage win-nt4 MS Windows NT 4
Servidores de arquivo osgroup NT4
Servidores de correio osgroup NT4
ossubpage win-xp MS Windows XP
ospage unix Unix
ossubpage unix-sun Solaris
ossubpage unix-linux Linux

Isso define um conjunto de páginas com uma página de nível superior (a página xymon.html), duas páginas
com links de xymon.html (win.html e unix.html) e, por exemplo, da página win.html, existem
subpáginas win-nt4.html e win-xp.html
A sintaxe é idêntica às diretivas normais de "página" e "subpágina" em hosts.cfg, mas
a diretiva é prefixada com o nome do conjunto de páginas. Não coloque nenhum host entre a página
e diretivas de subpágina - basta adicionar todas as diretivas no início do arquivo hosts.cfg.
Como você adiciona hosts às páginas, então? Simples - basta colocar uma tag "OS: win-xp" no host
linha de definição. O "SO" deve ser o mesmo que o prefixo usado para os nomes dos conjuntos de páginas, mas em
maiúsculas. O "win-xp" deve corresponder a uma das páginas ou subpáginas definidas neste
conjunto de páginas. Por exemplo

207.46.249.190 www.microsoft.com # OS: win-xp http://www.microsoft.com/
64.124.140.181 www.sun.com # OS: unix-sun http://www.sun.com/

Se você deseja que o host apareça dentro de um grupo definido nessa página, você deve identificar o
agrupar por número, começando em 1. Por exemplo, para colocar um host dentro do grupo "NT4 Mail servers" em
no exemplo acima, use "OS: win-nt4,2" (o segundo grupo na página "win-nt4").
Se você quiser que o host apareça na página inicial em vez de uma subpágina, use "OS: *".

Tudo isso apenas define o layout do novo conjunto de páginas. Para gerá-lo, você deve executar
xymongen uma vez para cada conjunto de páginas que você definir - ou seja, crie um script de extensão como este:

#!/ Bin / sh

XYMONWEB = "/ xymon / os" $ XYMONHOME / bin / xymongen \
--pageset = os --template = os \
$ XYMONHOME / www / os /

Salve-o em $ XYMONHOME / ext / os-display.sh e configure-o para ser executado como uma extensão Xymon;
isso significa adicionar uma seção extra ao tasks.cfg para executá-lo.

Isso gera as páginas. Existem algumas opções importantes usadas aqui:
* XYMONWEB = variável de ambiente "/ xymon / os" e o
A opção "$ XYMONHOME / www / os /" funciona em conjunto e coloca o
novos arquivos HTML do conjunto de páginas em um subdiretório fora do normal
Webroot Xymon. Se você normalmente acessa as páginas do Xymon como
"http://xymon.acme.com/xymon/", você irá acessar
o novo conjunto de páginas como "http://xymon.acme.com/xymon/os/"
NB: O diretório fornecido como XYMONWEB deve conter um símbolo
link para o diretório $ XYMONHOME / www / html / ou links para
mensagens de status individuais não funcionarão. Links semelhantes
deve ser feito para os gifs /, ajuda / e notas /
diretórios.
* "--pageset = os" diz ao xymongen para estruturar as páginas da web
usando o layout "os", em vez do layout padrão.
* "--template = os" diz ao xymongen para usar um conjunto diferente de
modelos de cabeçalho e rodapé. Normalmente, o xymongen usa o
modelo padrão em $ XYMONHOME / web / stdnormal_header e
... / stdnormal_footer - com esta opção, ele usará
os arquivos "os_header" e "os_footer" do
Diretório $ XYMONHOME / web /. Isso permite que você personalize
cabeçalhos e rodapés para cada conjunto de páginas. Se você só quer
para usar o modelo normal, você pode omitir esta opção.

USANDO XIMONGÊNIO PARA RELATÓRIOS

O relatório xymongen é implementado por meio de substituições imediatas para o Xymon padrão
scripts de relatórios (report.sh e reportlog.sh) instalados em seus servidores da web cgi-bin
diretório.

Esses dois scripts de shell foram substituídos por dois pequenos scripts de shell, que apenas
configurar as variáveis ​​de ambiente Xymon e invocar o relatório.cgi(1) or reportlog.cgi(1)
scripts em $ XYMONHOME / bin /

Você pode usar as opções de linha de comando do xymongen ao gerar relatórios, por exemplo, para excluir certos
tipos de testes (por exemplo, "--ignorecolumns = msgs") dos relatórios, para especificar o nome do
colunas de tendências e informações que não deveriam estar no relatório, ou para formatar o relatório
diferentemente (por exemplo, "--subpagecolumns = 2"). Se você quiser que certas opções sejam usadas quando um
relatório é gerado a partir da interface da web, coloque essas opções em seu
Arquivo $ XYMONHOME / etc / xymonserver.cfg na variável de ambiente XYMONGENREPOPTS.

Os arquivos de relatório gerados por xymongen são armazenados em diretórios individuais (um por
relatório) abaixo do diretório $ XYMONHOME / www / rep /. Eles devem ser limpos automaticamente
- à medida que novos relatórios são gerados, os antigos são removidos.

Após a instalação, tente gerar um relatório. Você provavelmente verá que os links no
canto superior esquerdo (para ack.html, nongreen.html etc.) não funciona mais. Para consertar isso, mude
seu arquivo $ XYMONHOME / web / repnormal_header para que esses links não se refiram a "& XYMONWEB", mas
ao prefixo de URL normal para suas páginas Xymon.

SLA RELATÓRIOS

Os relatórios xymongen permitem a geração de um verdadeiro SLA (Acordo de Nível de Serviço)
relatórios, também para períodos de serviço que não sejam 24 horas por dia, 7 dias por semana. Isso é habilitado definindo um
Tag "REPORTTIME: timespec" para os hosts definirem o período de serviço e, opcionalmente, um
Tag "WARNPCT: level" para definir a disponibilidade acordada.

Nota: Veja hosts.cfg(5) para a sintaxe exata dessas opções.

"REPORTTIME: timespec" especifica a hora do dia em que o serviço deve estar ativo e
correndo. Por padrão, isso é 24 horas por dia, todos os dias da semana. Se o seu SLA cobre apenas
De segunda a sexta, das 7h às 8h, você define isso como "REPORTTIME = W: 0700: 2000" e o gerador de relatórios
irá então calcular a disponibilidade 24x7 normal, mas também uma "disponibilidade SLA" que
leva em consideração apenas o status do host durante o período de SLA.

O parâmetro DOWNTIME: timespec afeta o cálculo de disponibilidade do SLA. Se uma interrupção
ocorre durante o tempo definido como possível "DOWNTIME", então a falha é relatada com um
status de "azul". (A mesma cor é usada se você "desabilitar" e depois hospedar usando o Xymon
função "desabilitar"). O momento em que o status do teste é "azul" não está incluído no SLA
cálculo, nem na quantidade de tempo em que o host é considerado inativo, nem na
quantidade total de tempo que o relatório cobre. Portanto, o tempo "azul" é efetivamente ignorado pelo
Cálculo de disponibilidade de SLA, permitindo que você tenha tempo de inatividade planejado sem afetar o
disponibilidade de SLA relatada.

Exemplo: Um host tem "DOWNTIME: *: 0700: 0730 REPORTTIME = W: 0600: 2200" porque foi reinicializado
todos os dias das 7h às 7.30h6, mas o serviço deve estar disponível das 10h às XNUMXh. Para
no dia do relatório, caiu das 7h10 às 7h15 (a reinicialização planejada), mas também
das 9h53 às 10h15. Portanto, os eventos do dia são:

0700: verde por 10 minutos (600 segundos)
0710: azul por 5 minutos (300 segundos)
0715: verde por 14 horas 38 minutos (52680 segundos)
2153: vermelho por 22 minutos (1320 segundos)
2215: verde

O serviço está disponível por 600 + 52680 = 53280 segundos. Ele está abaixado (vermelho) por 420 segundos
(o tempo de 21:53 até 22:00, quando o período de SLA termina). O tempo total incluído no
relatório é de 15 horas (7h - 10h), exceto o azul de 5 minutos = 53700 segundos. Portanto, o SLA
a disponibilidade é 53280/53700 = 99,22%

A tag "WARNPCT: level" é compatível com o arquivo hosts.cfg, para definir a disponibilidade
limite em uma base host por host. Este limite determina se um teste é relatado como
verde, amarelo ou vermelho nos relatórios. Um valor padrão pode ser definido para todos os hosts com a via
a variável de ambiente XYMONREPWARN, mas substituída por esta tag. O nível é dado como
uma porcentagem, por exemplo, "WARNPCT: 98.5"

PRÉ-GERADO RELATÓRIOS

Normalmente, o xymongen produz relatórios com links para páginas da web geradas dinamicamente com o
status detalhado de um teste (por meio do script reportlog.sh CGI).

É possível fazer com que o xymongen produza um relatório sem esses links dinâmicos, então o
o relatório pode ser exportado para outro servidor. Também pode ser útil pré-gerar o
relatórios, para diminuir a carga, fazendo com que vários usuários gerem os mesmos relatórios.

Para fazer isso, você deve executar o xymongen com a opção "--reportopts" para selecionar o tempo
intervalo que o relatório cobre, o estilo de relatório (crítico, não verde ou todos os eventos),
e solicitar que nenhuma página dinâmica seja gerada.

A sintaxe é:

xymongen --reportopts = starttime: endtime: nodyinamic: style

"starttime" e "endtime" são especificados como valores Unix time_t, ou seja, segundos desde 1º de janeiro
1970 00:00 GMT. Felizmente, isso pode ser facilmente calculado com o utilitário GNU date se você
use a opção de saída "+% s". Se você não tem o utilitário GNU date, escolha-o
em www.gnu.org; ou você pode usar o utilitário "etime" para a mesma finalidade, que é
disponível no arquivo em www.deadcat.net.

"nodinâmico" é 0 (para páginas dinâmicas, o padrão) ou 1 (para não dinâmicas, ou seja, pré-
gerado, páginas).

"estilo" é "crit" (inclui eventos críticos, ou seja, vermelhos apenas), "nongr" (inclui todos
eventos não verdes) ou "todos" (inclui todos os eventos).

Outras opções do xymongen podem ser usadas, por exemplo, "--ignorecolumns" se você deseja excluir certos
testes do relatório.

Normalmente, você também precisará especificar a variável de ambiente XYMONWEB (deve corresponder
o URL base de onde o relatório estará acessível) e um diretório de saída
onde os arquivos de relatório são salvos. Se você especificar XYMONWEB, provavelmente também deve
definir as variáveis ​​de ambiente XYMONHELPSKIN e XYMONNOTESSKIN. Devem apontar para
a URL onde seus arquivos de ajuda e notas do Xymon estão localizados; se eles não forem definidos, o
links para arquivos de ajuda e notas apontarão para dentro do diretório de relatórios e provavelmente
não funciona.

Portanto, uma invocação típica de xymongen para um relatório estático seria:

INÍCIO = `data +% s --date =" 22 de junho de 2003 00:00:00 "`
END = `data +% s --date =" 22 de junho de 2003 23:59:59 "`
XYMONWEB = / reports / bigbrother / daily / 2003/06/22 \
XYMONHELPSKIN = / xymon / help \
XYMONNOTESSKIN = / xymon / notes \
xymongen --reportopts = $ START: $ END: 1: crit \
--subpagecolumns = 2 \
/ var / www / docroot / reports / xymon / daily / 2003/06/22

A configuração "XYMONWEB" significa que o relatório estará disponível com um URL de
"http://www.server.com/reports/xymon/daily/2003/06/22". O relatório contém
links que usam este URL, portanto, não pode ser facilmente movido para outro local.

O último parâmetro é o diretório físico correspondente em seu servidor da web que corresponde ao
URL XYMONWEB. Você pode, é claro, criar os arquivos de relatório em qualquer lugar que desejar - talvez em
outra máquina - e depois mova-os para o servidor web.

Observe como o dados(1) utilitário é usado para calcular os parâmetros de tempo inicial e final.

MEIO AMBIENTE VARIÁVEIS

FILTRO DE PLACA
Filtro usado para selecionar quais hosts / testes são incluídos nas páginas da web, por meio de filtragem
os dados recuperados de xymond vi o comando xymondboard. Ver xímon(1) para detalhes
na sintaxe do filtro. Por padrão, nenhuma filtragem é feita.

Use xymongen online usando serviços onworks.net