pmlogconf - Online na nuvem

PROGRAMA:

NOME

pmlogconf - criar / editar um arquivo de configuração pmlogger

SINOPSE

$ PCP_BINADM_DIR / pmlogconf [-cqrv] [-d groupdir] [-h hostname] arquivo de configuração

DESCRIÇÃO

pmlogconf pode ser usado para criar e modificar um arquivo de configuração genérico para o PCP
arquivador de log, pmlogger(1).

If arquivo de configuração não existe, pmlogconf irá criar um arquivo de configuração genérico com um
conjunto padrão de métricas habilitadas e intervalos de registro.

Uma vez criado, arquivo de configuração pode ser usado com o -c opção para pmlogger(1) para selecionar
métricas de desempenho e especificar intervalos de registro para um arquivo PCP.

If arquivo de configuração existe, pmlogconf solicitará a entrada do usuário para ativar ou
desabilitar grupos de métricas de desempenho relacionadas e controlar o intervalo de registro para cada
grupo habilitado.

A seleção do grupo requer um simples y (sim ou n (nenhuma) resposta ao prompt Folhas para esse
grupo?.

Outras respostas neste ponto podem ser usadas para selecionar funções de controle adicionais como
segue:

m Relate os nomes das métricas no grupo atual.

q Concluir com a seleção do grupo (sair) e não fazer mais alterações neste grupo ou
qualquer grupo subsequente.

/de cinto de segurança Não faça alterações neste grupo, mas procure um grupo que contenha de cinto de segurança no
descrição do grupo ou os nomes das métricas associadas.

Um intervalo de registro é especificado respondendo ao Logging intervalo? solicitar com o
palavras-chave uma vez or omissão ou um válido pmlogger(1) especificação de intervalo da forma ``cada
N unidades de tempo'' ou simplesmente ``N unidades de tempo '' (O cada é opcional) onde N é um não assinado
inteiro e unidades de tempo é uma das palavras-chave mseg, milissegundo, seca, segundo, minutos, minuto,
hora ou a forma plural de uma das palavras-chave.

Quando executado a partir de processos de configuração de registro automatizados, o -c opção é usada para adicionar uma mensagem
e carimbo de data / hora indicando esse fato. Esta opção não é apropriada para uso interativo de
a ferramenta.

A -q opção suprime a janela de intervalo de registro e preserva o intervalo atual
da arquivo de configuração.

Uma saída mais detalhada pode ser habilitada com o -v opção.

CONFIGURAÇÃO GRUPO ARQUIVOS

Quando uma inicial arquivo de configuração é criado, as especificações padrão vêm de um conjunto de grupos
arquivos abaixo do groupdir especificado com o -d opção (o padrão groupdir is
$ PCP_VAR_DIR / config / pmlogconf que é mais comumente correto, então o -d opção raramente é
usado na prática).

A estrutura de diretório abaixo groupdir é arbitrário, pois todos os arquivos regulares serão encontrados por
descida recursiva e considerada, para que produtos complementares e desenvolvedores de PMDA possam estender facilmente
os padrões disponíveis para pmlogconf adicionando novos diretórios e / ou arquivos de grupo abaixo
groupdir.

Esses arquivos de grupo são processados ​​das seguintes maneiras:

· Quando um novo arquivo de configuração é criado, todos os arquivos do grupo são processados.

· Sempre que pmlogconf é executado com um existente arquivo de configuração, groupdir é percorrido para ver se
quaisquer novos grupos foram definidos e devem ser considerados para inclusão em arquivo de configuração.

· Quando pmlogconf processa um grupo em arquivo de configuração que está habilitado, a lista de métricas
associado ao grupo é retirado do arquivo do grupo (e substitui qualquer lista anterior
de métricas associadas a este grupo em arquivo de configuração).

· Quando o -r (reprobe) opção de linha de comando é especificada, cada grupo (não apenas recentemente
descobertos) é reprocessado para ver se deve ser considerado para inclusão em
arquivo de configuração.

Cada arquivo de grupo é estruturado da seguinte maneira:

· A primeira linha deve conter # pmlogconf-setup 2.0

· Outras linhas começando com # são tratados como comentários.

· As linhas em branco são ignoradas.

· Uma ou mais linhas começando com a palavra-chave identificação são usados ​​para fornecer a
descrição legível do grupo.

· Linhas não em branco começando com espaço em branco definem métricas a serem associadas a este
grupo, um por linha. Cada especificação de métrica segue as regras para um pmlogger(1)
configuração, ou seja, o nome de um nó não folha no PMNS (implicando todos
nomes descendentes no PMNS), ou o nome de um nó folha no PMNS opcionalmente
seguido por um ou mais nomes de instância entre `` ['' e ``] ''.

· Uma linha de controle começando com uma das palavras-chave sonda or força deve estar presente.

· Uma linha opcional de controle de intervalo de registro começa com a palavra-chave delta seguido por um
que acontecerá no marco da pmlogger(1) especificação de intervalo descrita acima.

· sonda as linhas de controle têm o formato:
sonda métrico [condição [regra de estado]]
onde métrico é o nome de uma métrica PCP (deve ser um nó folha no PMNS e não
a especificação da instância é permitida) e o opcional condição é a palavra-chave existe
(verdadeiro se métrico existe, ou seja, é definido no PMNS) ou a palavra-chave valores (verdadeiro se
métrico existe no PMNS e tem um ou mais valores atuais) ou uma expressão do
formulário
op onda
onde op é um dos awk(1) operadores (==, !=, >, >=, <, <=, ~ (expressão regular
combinar) ou !~ (correspondência de expressão regular negada)) e onda é um valor (sequência arbitrária
de caracteres, excluindo um espaço) e o condição é verdade se houver alguma instância
of métrico isso torna a expressão verdadeira.

Se o condição está faltando, o padrão é existe.

Quando um explícito condição é fornecido, também pode haver um opcional regra de estado que acontecerá no marco da
formulário
? estado_verdadeiro : estado_falso
onde estado_verdadeiro (aplica-se se condição é verdade) e estado_falso (aplica-se se condição
é falso) são retirados das palavras-chave incluir (incluir e habilitar o grupo e
as métricas associadas em arquivo de configuração), disponível (incluir e desabilitar o grupo em
arquivo de configuração - uma ação do usuário de y conforme descrito acima, é necessário para habilitar o grupo e
adicione as métricas associadas em arquivo de configuração) ou excluir (o grupo não é considerado para
inclusão em arquivo de configuração).

O padrão regra de estado is
? disponível : excluir

· força as linhas de controle começam com a palavra-chave força seguido por um dos estados definidos
acima, então uma das ações incluir, excluir or disponível é aplicado incondicionalmente
para o grupo.

A sondagem só é feita quando um novo grupo está sendo adicionado ao arquivo de configuração ou quando o -r comando
opção de linha é especificada. A avaliação das condições de sondagem é feita contatando
pmcd(1) em hostname (o padrão é local :).

EXEMPLO

O arquivo de grupo a seguir demonstra todos os elementos sintáticos suportados.

# pmlogconf-setup 2.0
ident Exemplo de arquivo de grupo
ident ... mais descrição
delta 1 minuto
sondar os valores sample.secret.foo.one? incluir excluir
amostra.secreto.foo.one
sample.secret.foo.bar # non-leaf no PMNS
amostra.colour [vermelho verde]

MIGRAÇÃO

A versão atual do pmlogconf (2.0) suporta um formato ligeiramente diferente para arquivo de configuração
em comparação com as versões anteriores. Se uma versão antiga arquivo de configuração é apresentado a pmlogconf it
será convertido para o novo formato.

PCP MEIO AMBIENTE

Variáveis ​​de ambiente com o prefixo PCP_ são usados ​​para parametrizar o arquivo e diretório
nomes usados ​​pelo PCP. Em cada instalação, o arquivo /etc/pcp.conf contém os valores locais
para essas variáveis. o $ PCP_CONF variável pode ser usada para especificar uma alternativa
arquivo de configuração, conforme descrito em pcp.conf(5).

Use pmlogconf online usando serviços onworks.net