Manuais para a linha de comandos

Man » Manual online do multitail - documentação online detalhada para a página de manual do multitail

🌍
MultiTail - visualize vários arquivos simultaneamente

SINTAXE

multitail [opções]

opções: [-cs|-Cs|-c-] [-s] [-i] arquivo_de_entrada [-i outro_arquivo_de_entrada] [...]

DESCRIÇÃO

O programa MultiTail permite visualizar um ou vários arquivos como o programa tail original. A diferença é que ele cria várias janelas no seu console (com ncurses). Ele também pode monitorar curingas: se outro arquivo que corresponda ao curinga tiver uma data de modificação mais recente, ele automaticamente mudará para esse arquivo. Dessa forma, você pode, por exemplo, monitorar um diretório inteiro de arquivos. É possível mesclar 2 ou mais arquivos de log. Ele também pode usar cores ao exibir os arquivos de log (por meio de expressões regulares), para reconhecimento mais rápido do que é importante e o que não é. Ele também pode filtrar linhas (novamente com expressões regulares). Ele tem menus interativos para editar as expressões regulares fornecidas e excluir e adicionar janelas. Você também pode ter janelas com a saída de scripts de shell e outros softwares. Ao visualizar a saída de software externo, o MultiTail pode imitar a funcionalidade de ferramentas como 'watch' e outras. Quando novos e-mails chegarem para o usuário atual, as linhas de status ficarão verdes. Para redefinir esse estado de "e-mail recebido", pressione ' ' (uma barra de espaço). Para obter ajuda a qualquer momento, pressione F1.

OPÇÕES

-i arquivo

Selecione um arquivo para monitorar. Você pode ter vários parâmetros -i arquivo. Você só precisa adicionar -i arquivo antes de um nome de arquivo se o nome do arquivo começar com um hífen ('-').

-I arquivo

Igual a -i arquivo, mas adiciona a saída à janela anterior (então a saída é mesclada).

-iw arquivo intervalo
-Iw arquivo intervalo Semelhante a '-i'/' -I', mas espera que o parâmetro seja um curinga e o segundo (!) um intervalo. Inicialmente, o MultiTail começará monitorando o primeiro arquivo com o
tempo de modificação mais recente. A cada intervalo, ele verificará se novos arquivos foram criados
(ou modificados) e começará a monitorar esse arquivo. *Não se esqueça* de colocar aspas ao redor do
nome do arquivo, caso contrário, o shell tentará substituí-los!

-l comando

Comando a ser executado em uma janela. O parâmetro é o comando. Não se esqueça de usar aspas simples se o comando externo precisar de um parâmetro! (por exemplo, -l "ping host").

-L comando

Igual a -l, mas adiciona a saída à janela anterior (então a saída é mesclada).

-j

Lê da entrada padrão (pode ser usado apenas uma vez, pois existe apenas 1 entrada padrão).

-J

Igual a -j, mas adiciona a saída à janela anterior (então a saída é mesclada).

--mergeall

Mescla todos os arquivos seguintes na mesma janela (veja '--no-mergeall').


--no-mergeall
Interrompe a mesclagem de todos os arquivos em uma única janela (veja '--mergeall');

--no-repeat
Quando a mesma linha é repetida, ela será suprimida ao imprimir uma mensagem "Última mensagem repetida x vezes".

--mark-interval x
Imprime uma linha de marca a cada 'x' segundos, quando nada mais foi impresso.

-q i path
Verifica o 'path' em busca de novos arquivos com intervalo 'i', todos em novas janelas. É possível inserir caminhos aqui que sejam compreendidos pelo shell. Por exemplo, "/tmp/*". Atenção: não se esqueça de adicionar aspas ao redor do nome do caminho para evitar que o shell o interprete!

-Q i path
Semelhante a -q: mas mescla tudo em uma única janela.

--new-only
Para -q/-Q: cria janelas apenas para arquivos criados após o MultiTail ser iniciado.

--closeidle x
Fecha janelas quando não houver novos dados processados há mais de 'x' segundos.

-a x   Escreve a saída também no arquivo 'x' (como 'tee') APÓS ser filtrada pelo MultiTail. Observe:
você precisa colocar "-a file" ANTES do arquivo que você está monitorando!

-A x   Escreve a saída também no arquivo 'x' (como 'tee') ANTES de ser filtrada pelo MultiTail.
Veja também a nota para "-a".

-g x   Envia a saída também para o comando 'x' APÓS ser filtrada pelo MultiTail.

-G x   Envia a saída também para o comando 'x' ANTES de ser filtrada pelo MultiTail.

-S   Anexa o número da subjanela à saída mesclada.

-t title
Com esta opção, "title" é exibido na linha de status em vez do nome do arquivo ou da linha de comando.

-n number_of_lines
Número de linhas a serem exibidas inicialmente. O padrão depende do tamanho da janela do terminal.

-N number_of_lines
Semelhante a -n, mas este parâmetro será usado para todos os arquivos/comandos que você monitorar após este parâmetro.

-r interval
Reinicia o comando (iniciado com -l/-L) após ele ter sido encerrado. Com o intervalo, você pode definir quanto tempo esperar antes de reiniciar.

-R interval
Reinicia um comando como -r, mas mostra apenas a diferença na saída em comparação com a execução anterior.

-rc / -Rc interval
Semelhante a -r / -R, mas limpa a janela antes de cada iteração.

-h   A ajuda.

-f   Segue o nome do arquivo, não o descritor.

--follow-all
Para todos os arquivos após esta opção: segue o nome do arquivo, não o descritor.

-fr filter
Usa o filtro(s) predefinido(s) do arquivo de configuração.

-e   Usa a próxima expressão regular no arquivo seguinte.

-ex  Usa a expressão regular no arquivo seguinte e executa o comando quando ela corresponder. O comando recebe como parâmetro da linha de comando a linha correspondente inteira.

-eX  Semelhante a '-ex', mas fornece apenas a substring correspondente como parâmetro. Isso requer uma expressão regular com '(' e ')'.

-ec  Usa a expressão regular no arquivo seguinte e exibe as correspondências.

-eC  Usa a expressão regular no arquivo seguinte, mas exibe tudo e exibe as correspondências de forma invertida.

-E   Usa a próxima expressão regular nos arquivos seguintes.

-v   Nega a próxima expressão regular.

-s x   Divide a tela verticalmente em 'x' colunas.

-sw x  Em qual posição dividir a tela. Por exemplo, '-sw 20,40,,10' (=4 colunas).

-sn x   Quantos painéis por coluna para divisão vertical (usar com -s ou -sw). Ex: '-sn 3,,2'.

-wh x   Define a altura de uma janela (informativo: se não couber, a altura será ajustada).

-cS esquema
Mostra o próximo arquivo dado usando o esquema de cores selecionado com 'esquema' (conforme definido em multitail.conf).

-CS esquema
Mostra todos os arquivos subsequentes usando o esquema de cores selecionado com 'esquema' (conforme definido em multitail.conf).

-csn    Opção extra para os seguintes parâmetros; não usar cores invertidas.

-cs Mostra o próximo arquivo dado em cores (syslog).

-c  Mostra o próximo arquivo dado em cores.

-Cs Mostra todos os arquivos subsequentes em cores (através do esquema syslog).

-C  Mostra todos os arquivos subsequentes em cores.

-Cf índice_campo delimitador
Mostra todos os arquivos subsequentes em cores, dependendo do campo selecionado com índice_campo. Os campos são delimitados pelo delimitador definido.

-cf índice_campo delimitador
Mostra o próximo arquivo em cores, dependendo do campo selecionado com índice_campo. Os campos são delimitados pelo delimitador definido.

-ci cor
Usa uma cor específica. Útil ao mesclar várias saídas.

-cT modo_terminal
Interpreta códigos de terminal. Somente ANSI é suportado neste momento.

-c- NÃO colorir o arquivo seguinte.

-C- NÃO colorir os arquivos seguintes.

-ts Adiciona um timestamp a cada linha (o formato é configurável em multitail.conf).

-Z cor
Especifica os atributos de cor para a linha de marcador.

-T  Um timestamp será colocado na linha de marcador.

-d  NÃO atualizar a linha de status.

-D  Não exibir uma linha de status.

-du Colocar a linha de status acima da janela de dados.

-z  Não exibir janelas "fechadas".

-u  Define o intervalo de atualização da tela (para links lentos).

-m nlinhas
Define o tamanho do buffer. Defina nlinhas para 0 (zero) se você quiser limites ilimitados no buffer.

-mb x   Define o tamanho do buffer de retrocesso (em bytes, use xKB/MB/GB).

-M nlinhas
Define o tamanho do buffer em TODOS os arquivos subsequentes.

-p x [y]
Define o modo de quebra de linha: a = imprimir tudo, incluindo a quebra de linha. l = apenas mostrar tudo, começando na esquerda até o lado direito da janela. r = mostrar tudo, começando na direita da linha. s = mostrar tudo, começando com o nome do processo. S = mostrar tudo, começando após o nome do processo. o = mostrar tudo, começando no deslocamento 'y'.

-P x [y]
Semelhante a -p, mas para todas as janelas subsequentes.

-ke x   Remove partes da entrada usando a expressão regular 'x'.

-kr x y
Remove partes da entrada começando no deslocamento x e terminando (não incluindo!) no deslocamento y.

-kc x y
Remove partes da entrada: remove a coluna 'y' com o delimitador 'x'.

-ks x   Usa o esquema de edição 'x' do arquivo de configuração.

-w  Não usar cores.

-b n    Define a largura da TAB.

--config nome_arquivo
Carrega a configuração do nome de arquivo fornecido.

-x  Define o título do xterm: %f será substituído pelo último arquivo alterado, %h pelo nome do host, %l pela carga do sistema, %m por "Novo e-mail!" quando o usuário atual tiver novo e-mail, %u pelo usuário efetivo atual, %t pelo timestamp do último arquivo alterado, %% por um %.

-o configfile-item

Processa um item do arquivo de configuração pela linha de comando, caso você não possa editar o arquivo de configuração padrão.

--cont Reconecte as linhas com um '´ no final.

--mark-interval interval

Quando nada for recebido, imprima uma linha '---mark---' a cada 'interval' segundos.

--mark-change

Quando vários arquivos são mesclados e o multitail alterna entre duas janelas, imprima uma linha de marcador com o nome do arquivo.

--no-mark-change

NÃO imprima a linha de marcador quando o arquivo for alterado (substitui o arquivo de configuração).

--label text

Coloque "text" na frente de cada linha. Útil ao mesclar vários arquivos e/ou comandos.

--retry

Continue tentando abrir o arquivo seguinte se ele estiver inacessível.

--retry-all

Semelhante a --retry, mas para todos os arquivos seguintes.

-cv x Use o esquema de conversão 'x' (consulte multitail.conf).

--basename

Exiba apenas o nome do arquivo (e não o caminho) na linha de status.

-F file

Use 'file' como arquivo de configuração (em vez do arquivo de configuração padrão).

--no-load-global-config

NÃO carregue o arquivo de configuração global.

--beep-interval x

Faça com que o terminal emita um bipe para cada x-ésima linha processada. Pressione 'i' no menu principal para ver quantas vezes ele emitiu um bipe.

--bi x Semelhante a '--beep-interval', mas apenas para a janela (sub) atual. As estatísticas sobre o número de bipes podem ser encontradas nas estatísticas desta janela (sub). Pressione 't' no menu principal.

-H Mostre o heartbeat (para manter suas sessões ativas).

-V Mostre a versão e saia.

TECLAS

Você pode pressionar algumas teclas enquanto o programa está em execução. Para ver uma lista delas, pressione F1 (ou ^h). Você pode pressionar F1 (ou ^h) a qualquer momento: ele fornece informações relacionadas ao contexto. Pressione 'q' para sair do programa.

EXEMPLOS

Veja http://www.vanheusden.com/multitail/examples.html para mais exemplos.

multitail /var/log/apache/access_log logfile -i -filestartingwithdatsh

Isso cria três janelas. Uma com o conteúdo de /var/log/apache/access_log, uma com o conteúdo de logfile e assim por diante.

multitail -R 2 -l "netstat -t"

Isso executa netstat a cada 2 segundos e, em seguida, mostra o que mudou desde a execução anterior. Dessa forma, você pode ver novas conexões sendo feitas e conexões fechadas desaparecendo.

multitail logfile -l "ping 192.168.1.3"

Isso cria duas janelas. Uma com o conteúdo de logfile, outra com a saída de 'ping 192.168.1.3'.

multitail /var/log/apache/access_log -I /var/log/apache/error_log

Isso cria uma janela com o conteúdo de /var/log/apache/access_log mesclado com o conteúdo de /var/log/apache/error_log.

multitail -M 0 /var/log/apache/access_log -I /var/log/apache/error_log

Semelhante ao exemplo anterior. Este exemplo armazenará todas as entradas registradas em um buffer para que você possa posteriormente navegar por elas (pressionando ' b ').

ARQUIVOS

${XDG_CONFIG_HOME}/multitail/config

Se ${XDG_CONFIG_HOME} estiver definido.

${HOME}/.multitailrc

Se ${HOME} estiver definido.

~/.multitailrc
Quando nem ${XDG_CONFIG_HOME} nem ${HOME} estiverem definidos, o que usará (struct passwd*)pp->pw_dir do cabeçalho padrão pwd.h.

BUGS

À medida que este programa crescia e se tornava cada vez maior ao longo do tempo, com novas funcionalidades adicionadas de forma ad hoc, alguns bugs podem ter sido introduzidos. Por favor, notifique _ se encontrar algum.

Bem, exceto para o redimensionamento da janela do seu terminal. O programa pode falhar ao realizar tais ações. A atualização da biblioteca ncurses para a versão 5.3 ou superior pode ajudar nesse caso.

VEJA TAMBÉM

http://www.vanheusden.com/multitail/

NOTAS

Esta página descreve o MultiTail conforme encontrado no pacote multitail instalado; outras versões podem diferir ligeiramente. Envie correções e adições para _. Relate bugs no programa para _.