onde a documentação do formato XML rrddump é?

Question

Estou usando o rrdtools para armazenar métricas do meu servidor e quero despejar este rrd para XML usando Comando rrddump. então a documentação deste formato XML é necessária, onde posso encontrar isso?

    

Answer 1

Não há documentação específica para o formato XML de arquivos RRD, mas pode ser derivada da documentação no formato binário RRD da seguinte forma:

este guia foi elaborado a partir de informações nos seguintes sites:

• link
• link

Consulte também a documentação no site da rrdtool.

A estrutura básica do arquivo XML RRD é:

<rrd> <version /> <step /> <lastupdate />
  <ds> <name /> <type /> <step /> <minimal_heartbeat /> <min /> <max /> <last_ds /> <value /> <unknown_sec /> </ds> ...
  <rra> <cf /> <pdp_per_row /> <xff />
    <cdp_prep> <ds> <value /> <unknown_datapoints /> </ds> ... <cdp_prep>
    <database> <row> <v /> ... </row> ... </database>
  </rra>... 
</rrd>

Nesta definição de sintaxe ad hoc, usei elipses (...) para indicar que a cardinalidade do elemento é 1 ou mais.

Essa estrutura pode ser descrita como: cada base de dados Round Robin (< rrd >) possui uma ou mais fontes de dados (< ds >) e um ou mais arquivos Round Robin (< rra >). Cada < rra > contém um banco de dados (< database >) que possui várias linhas (< row >). Cada < linha > tem v�ios valores (< v >), cujo n�ero corresponde ao n�ero de fontes de dados (< ds >) definido para o < rrd >.

O elemento Fonte de dados (< ds >) define as características de dados de cada fonte de dados (DS) que será monitorada:

• < nome & gt ;: nome do texto livre para o DS
• < step & gt ;: a taxa de amostragem, em segundos, para a coleta de dados. Cada PDP (Primary Data Point, Ponto de Dados Primário) é usado para armazenar dados em um momento exato, desde os segundos desde o último PDP. Se não for especificado, o valor padrão 300 será usado.
• < tipo & gt ;: o tipo de medição capturado - {COUNTER | DERIVE | ABSOLUTO | GAUGE} Um DS declarado como COUNTER salvará a taxa de alteração do valor em um período de etapa. Isso pressupõe que o valor está sempre aumentando (a diferença entre o valor atual e o valor anterior é maior que 0). Os contadores de tráfego em um roteador são candidatos ideais para usar o COUNTER como DST. DERIVE é o mesmo que COUNTER, mas também permite valores negativos. Se você quiser ver a taxa de alteração no espaço livre em disco em seu servidor, convém usar o tipo de dados DERIVE. ABSOLUTE também salva a taxa de alteração, mas assume que o valor anterior está definido como 0. A diferença entre o valor atual e o valor anterior é sempre igual ao valor atual. GAUGE não salva a taxa de alteração. Ele salva o próprio valor real. Não há divisões ou cálculos. O consumo de memória em um servidor é um exemplo típico de medidor.
• < minimal_heartbeat & gt ;: o tempo máximo (em segundos) podemos ir sem uma atualização. Por exemplo, se minimal_heartbeat = 120 e passarmos mais de 120 segundos sem ouvir um valor, os Pontos de Dados Primários desse intervalo serão definidos como UNKNOWN.
• < min & gt ;: o valor mínimo gravável para a fonte de dados
• < max & gt ;: o valor máximo gravável para a fonte de dados
• < last_ds & gt ;:
• < valor & gt ;:

O elemento Round Robin Archive (< rra >) define as características de medição de cada arquivo no RRD.

Um arquivo consiste em vários valores ou estatísticas de dados para cada uma das fontes de dados definidas (DS). Os elementos de um < rra > são:

• < cf & gt ;: a função de consolidação do arquivo - {AVERAGE | MIN | MAX | ÚLTIMO }. Os PDPs são agregados ou filtrados com base na função de consolidação.
• < pdp_per_row & gt ;: o número de PDPs que comporão o valor registrado. Se pdp_per_row for maior que 1, os PDPs serão agregados ou filtrados com base na tag < cf & gt ;. O produto de < pdp_per_row > e DS < etapa > fornece a taxa de amostragem em segundos para cada registro na tag < rra & gt ;. Por exemplo, se o DS < etapa > = 300 e < pdp_per_row > = 6 a taxa de amostragem para o < rra > = 1800 segundos.
• < xff & gt ;: o "Fator XFiles (XFF)". A porcentagem de PDPs que podem ser desconhecidos sem tornar o valor registrado desconhecido.
• < cdp-prep & gt ;:
• < banco de dados & gt ;: os dados armazenados pelo < rra & gt ;. A < banco de dados > consiste em vários < linha > elementos, cada um com um número de < v > elementos iguais ao número de elementos da fonte de dados (< ds >) definidos para os < rrd & gt ;. O < v > os elementos armazenam os dados amostrados que são gravados em um arquivo RRD pela chamada de função rrdupdate - em outras palavras, os dados produzidos pela ferramenta de monitoramento com a qual o RRD está interagindo.

Existem alguns elementos para os quais não consegui encontrar uma explicação. Eles estão marcados ??.

    

Answer 2

Se você examinar o XML produzido pelo rrddump e tiver um conhecimento básico de como o rrdtool funciona, o formato é bastante autodescritivo. Não tenho conhecimento de nenhuma documentação.