Filtragem da saída de comando operacional
O símbolo | do pipe permite que você (o administrador da rede) filtre a saída de comando nos modos operacional e de configuração.
Sobre o uso do tubo (|) Símbolo para filtrar a saída de comando
Você pode filtrar a saída do comando adicionando o símbolo pipe | () ao entrar no comando.
Exemplo:
user@host> show rip neighbor ?
Possible completions:
<[Enter]> Execute this command
<name> Name of RIP neighbor
instance Name of RIP instance
logical-system Name of logical system, or 'all'
| Pipe through a command
O exemplo a seguir lista os filtros que você pode usar com o símbolo pipe ( | ):
user@host> show interfaces | ?
user@host> show interfaces | ?
Possible completions:
append Append output text to file
count Count occurrences
display Show additional kinds of information
except Show only text that does not match a pattern
find Search for first occurrence of pattern
hold Hold text without exiting the --More-- prompt
last Display end of output only
match Show only text that matches a pattern
no-more Don't paginate output
refresh Refresh a continuous display of the command
request Make system-level requests
resolve Resolve IP addresses
save Save output text to file
tee Write to standard output and file
trim Trim specified number of columns from start of lineSomente para o comando, você pode combinar o símbolo do pipe e o ponto de dúvida para show configuration exibir um filtro de comparação adicional:
user@host> show configuration | ?
Possible completions:
compare Compare configuration changes with prior version
...
Você pode inserir qualquer um dos filtros de tubo em combinação. Por exemplo:
user@host>command | match regular-expression | save filename
Este tópico descreve apenas os filtros que você pode usar para a saída do comando do modo operacional.
Exemplo: Use expressões regulares com o pipe (|) Símbolo para filtrar a saída de comando
Você usa o except . find e match filtros com o símbolo de pipe para empregar expressões regulares para filtrar a saída. Juniper Networks usa as expressões regulares como definidas no POSIX 1003.2. Se uma expressão regular contiver espaços, operadores ou caracteres de caracteres curinga, estando a expressão entre aspas.
|
Operador |
Função |
|---|---|
|
|
Indica que uma combinação pode ser um dos dois termos de cada lado do tubo. |
|
|
Usado no início de uma expressão para indicar onde uma partida deve começar. |
|
|
Usado ao final de uma expressão para indicar que um termo deve ser igualado exatamente ao ponto do caractere $. |
|
|
Especifica uma variedade de letras ou dígitos a fim de combinar. Para separar o início e a ponta de um intervalo, use um hífen ( |
|
|
Especifica um grupo de termos para combinar. |
Por exemplo, se um comando produzir a seguinte saída:
user@host> show chassis hardwareHardware inventory:Item Version Part number Serial number DescriptionChassis F0632 MX80Midplane REV 09 711-031594 ZW0568 MX80PEM 0 Rev 04 740-028288 VK09886 AC Power Entry ModuleRouting Engine BUILTIN BUILTIN Routing EngineTFEB 0 BUILTIN BUILTIN Forwarding Engine ProcessorQXM 0 REV 06 711-028408 ZW4288 MPC QXMFPC 0 BUILTIN BUILTIN MPC BUILTINMIC 0 BUILTIN BUILTIN 4x 10GE XFPPIC 0 BUILTIN BUILTIN 4x 10GE XFPXcvr 0 REV 02 740-014289 C825XU010 XFP-10G-SRXcvr 1 REV 03 740-014289 CB25BQ0WD XFP-10G-SRXcvr 2 REV 01 740-011571 C739XJ039 XFP-10G-SRFPC 1 BUILTIN BUILTIN MPC BUILTINMIC 1 *** Hardware Not Supported ***Fan Tray Fan Tray
Um filtro de tubo | match "FPC-1" exibe a seguinte saída:
FPC 1 BUILTIN BUILTIN MPC BUILTIN
Um filtro de tubo | except "FPC 1" exibe a seguinte saída:
Hardware inventory:Item Version Part number Serial number DescriptionChassis F0632 MX80PEM 0 Rev 04 740-028288 VK09886 AC Power Entry ModuleRouting Engine BUILTIN BUILTIN Routing EngineTFEB 0 BUILTIN BUILTIN Forwarding Engine ProcessorFPC 0 BUILTIN BUILTIN MPC BUILTINFan Tray Fan Tray
Exemplo: Pipe (|) Filtrar funções na interface de linha de comando
Este tópico descreve e fornece exemplos das funções de filtro pipe (|) compatíveis com Junos OS a CLI.
- Exemplos de configurações e suas diferenças em texto
- Exemplos de configurações e suas diferenças em XML
- Exemplo de contar o número de linhas de saída
- Exemplo de saída exibido no formato de tags XML
- Exemplo de exibição de dados de configuração estática
- Exemplo de exibição de dados de configuração efêmera
- Exemplo de exibição de saída no formato JSON
- Exemplo de exibição da configuração com scripts de tradução YANG aplicados
- Exemplo de exibição das tags RPC para um comando
- Exemplo de ignorar uma saída que não combina com uma expressão regular
- Exemplo de exibição da saída da primeira combinação de uma expressão regular
- Exemplo de retenção de saída após a última tela
- Exemplo de exibição da saída começando com as últimas entradas
- Exemplo de exibição de saída que combina com uma expressão regular
- Exemplo de impedir que a saída seja paginada
- Exemplo de envio de saída de comando para outros usuários
- Exemplo de resolução de endereços IP
- Exemplo de como salvar a saída em um arquivo
- Exemplo de saída pendente em um arquivo
- Exemplo de exibição de saída na tela e escrita em um arquivo
- Exemplo de como aparar a saída especificando a coluna inicial
- Exemplo de como atualizar a saída de um comando
Exemplos de configurações e suas diferenças em texto
O compare filtro compara a configuração do candidato com a configuração comprometida atual ou um arquivo de configuração. Ele também exibe as diferenças entre as duas configurações com caracteres de texto.
Para comparar os arquivos de configuração, você entra compare depois do símbolo pipe (|) da seguinte forma:
show | compare [rollback n | filename]
A rollback variável n é o índice na lista de configurações previamente comprometidas. A configuração mais recentemente economizada é 0. Caso você não especifique argumentos, a configuração do candidato será comparada ao arquivo de configuração ativo (), que é o mesmo que comparar /config/juniper.conf com rollback o índice 0.
O caminho completo (ou URL) para um arquivo de configuração é o nome do arquivo.
A saída de comparação usa as seguintes convenções:
-
As declarações que estão na configuração do candidato apenas são prefixadas com um sinal de mais (+).
-
As declarações que estão no arquivo de comparação apenas são prefixadas com um sinal de menos (-).
-
Declarações inalteradas são prefixadas com um único espaço em branco ( ).
Exemplo:
user@host> show configuration system | compare rollback 9
[edit system]
+ host-name device;
+ backup-router 192.168.71.254;
- ports {
- console log-out-on-disconnect;
- }
[edit system name-server]
+ 172.17.28.11;
172.17.28.101 { ... }
[edit system name-server]
172.17.28.101 { ... }
+ 172.17.28.100;
+ 172.17.28.10;
[edit system]
- scripts {
- commit {
- allow-transients;
- }
- }
+ services {
+ ftp;
+ rlogin;
+ rsh;
+ telnet;
+ }
Aprimoramos a saída do comando para refletir com mais show | compare precisão as mudanças de configuração. Esse aprimoramento inclui o tratamento mais inteligente das mudanças de ordem nas listas. Por exemplo, considere nomes de grupo reordenados da seguinte forma:
groups {
groups {
group_xmp; group_xmp;
group_cmp; group_grp:
group_grp; group_cmp;
}
}
Nas primeiras versões, a saída do show | compare comando parecia a seguinte:
[edit groups] - group_xmp; - group_cmp; - group_grp; + group_xmp; + group_grp; + group_cmp;
Agora, a saída do show | compare comando se parece com a seguinte:
[edit groups]
group_xmp {...}
! group_grp {...}
Exemplos de configurações e suas diferenças em XML
O filtro compara a configuração do candidato com a configuração comprometida atual e exibe as diferenças entre compare | display xml as duas configurações em XML. Para comparar configurações, você entra depois do símbolo compare | display xml pipe (|) no modo operacional ou de configuração.
Exemplo no modo operacional:
user@host> show configuration | compare | display xml
Exemplo no modo de configuração:
[edit]
user@host# show | compare | display xml
Você pode entrar em uma hierarquia de configuração específica antes de usar o | compare comando. No modo de configuração, você pode navegar até uma hierarquia na qual o comando é aplicado.
Exemplo de contar o número de linhas de saída
Para contar o número de linhas na saída do comando, insira count o símbolo do pipe (|). Por exemplo:
user@host> show configuration | count
Count: 269 lines
Exemplo de saída exibido no formato de tags XML
Para exibir a saída de comando no formato de tags XML, você entra display xml depois do símbolo de pipe (|).
O exemplo a seguir exibe a saída show cli directory de comando como tags XML:
user@host> show cli directory | display xml
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/7.5I0/junos">
<cli>
<working-directory>/var/home/user</working-directory>
</cli>
<cli>
<banner></banner>
</cli>
</rpc-reply>
Se os dados de configuração ou a saída de comando contiver caracteres que estejam fora do conjunto de caracteres ASCII de 7 bits, a CLI exibirá a referência equivalente de caracteres decimais UTF-8 para esses caracteres na saída XML.
Exemplo de exibição de dados de configuração estática
Você pode ver os dados de configuração e informações herdados sobre o grupo de origem do qual a configuração foi herdada em relação ao banco de dados de configuração estática. Para exibir esses dados, você emitirá o show configuration | display inheritance comando.
user@host> show configuration | display inheritance
## Last commit: 2018-03-29 15:54:17 PDT
version 16.2R2;
system {
...
}Exemplo de exibição de dados de configuração efêmera
Juniper Extension Toolkit (JET) aplicativos, Protocolo de Configuração de Rede (NETCONF) e aplicativos cliente de protocolo Junos XML podem configurar o banco de dados de configuração efêmera. O banco de dados efêmera é um banco de dados de configuração alternativo que fornece uma interface programática rápida para realizar atualizações de configuração.
Para exibir a configuração pós-herança completa mesclada aos dados de configuração em todas as instâncias do banco de dados efêmera, use o show ephemeral-configuration merge comando.
user@host> show ephemeral-configuration merge
## Last changed: 2019-02-01 09:47:20 PST
version 18.2R1;
system {
...
}Exemplo de exibição de saída no formato JSON
Você pode exibir a configuração ou a saída de comando no formato JSON (JavaScript Object Notation, Notação de objeto de JavaScript) inserindo depois o símbolo display json do pipe (|).
O exemplo a seguir exibe a show cli directory saída de comando no formato JSON:
user@host> show cli directory | display json
{
"cli" : [
{
"working-directory" : [
{
"data" : "/var/home/username"
}
]
}
]
}Se a saída de comando operacional contiver caracteres que estejam fora do conjunto de caracteres ASCII de 7 bits, a CLI exibirá a referência equivalente de caracteres decimais UTF-8 para esses caracteres na saída JSON.
Exemplo de exibição da configuração com scripts de tradução YANG aplicados
Você pode carregar módulos YANG em dispositivos em execução para aumentar a hierarquia de configuração com modelos de dados que não são compatíveis com a omissão. dá suporte à tradução Junos OSJunos OS desses Junos OS modelos.. As configurações ativas e as configurações do candidato contêm os dados de configuração de modelos de dados YANG não nativos na sintaxe definida por esse modelo. Essas configurações não mostram explicitamente a sintaxe traduzida correspondente, que Junos OS é comprometida como uma mudança transitória.
O filtro exibe a configuração pós-herança completa, com os dados de configuração traduzidos de todos os scripts de tradução | display translation-scripts ativados incluídos explicitamente na saída. Para exibir a configuração com todos os scripts de tradução YANG ativados aplicados, aplique o filtro ao comando no modo operacional ou | display translation-scripts ao comando em modo de show configurationshow configuração. Por exemplo:
user@host> show configuration | display translation-scriptsPara exibir apenas os dados de configuração não nativos após a tradução, você usa o filtro no modo | display translation-scripts translated-config operacional ou no modo de configuração.
user@host> show configuration | display translation-scripts translated-configNo modo de configuração, você pode exibir apenas as diferenças de configuração nas hierarquias correspondentes a modelos de dados YANG não nativos antes ou depois que os scripts de tradução são aplicados. Para exibir essas diferenças, você anexa a configured-delta palavra-chave translated-delta ou, respectivamente, ao show | display translation-scripts comando. Em ambos os casos, a saída XML exibe os dados de configuração excluídos, seguidos pelos novos dados de configuração.
user@host# show | display-translation-scripts (configured-delta | translated-delta)O exemplo a seguir exibe uma configuração de amostra com e sem scripts de tradução aplicados. O show comando exibe a configuração, que inclui os dados de configuração não nativos na sintaxe definida pelo modelo de dados YANG. O filtro exibe os dados de configuração não nativos na sintaxe definida pelo modelo de dados | display translation-scripts YANG e na sintaxe Junos OS traduzida. Ambos os comandos exibem toda a configuração, que foi truncada por uma brevidade neste exemplo. No entanto, o comando retorna a configuração de show pré-inertância, enquanto o show | display translation-scripts comando retorna a configuração pós-herança.
user@host# show
...
myint:intconfig {
interfaces {
interface ge-0/0/0 {
config {
description test;
}
}
}
}
...user@host# show | display translation-scripts
...
interfaces {
ge-0/0/0 {
description test;
gigether-options {
no-flow-control;
}
}
}
...
myint:intconfig {
interfaces {
interface ge-0/0/0 {
config {
description test;
}
}
}
}
...Exemplo de exibição das tags RPC para um comando
Para exibir as tags XML de chamada de procedimento remoto (RPC) para um comando do modo operacional,você entra depois do símbolo display xml rpc do pipe (|).
O exemplo a seguir exibe as tags RPC do show route comando:
user@host> show route | display xml rpc
<rpc-reply xmlns:junos="http://xml.juniper.net/junos/10.1I0/junos">
<rpc>
<get-route-information>
</get-route-information>
</rpc>
<cli>
<banner></banner>
</cli>
</rpc-reply>Exemplo de ignorar uma saída que não combina com uma expressão regular
Para ignorar texto que corresponde a uma expressão regular, especifique o comando após o símbolo except do pipe (|). Se a expressão regular contiver espaços, operadores ou caracteres de caracteres curinga, estendo-a entre aspas.
O exemplo a seguir mostra todos os usuários que estão conectados ao roteador, exceto o root usuário:
user@host> show system users | except root
8:28PM up 1 day, 13:59, 2 users, load averages: 0.01, 0.01, 0.00
USER TTY FROM LOGIN@ IDLE WHAT
user p0 device1.example.com 7:25PM - cli
Exemplo de exibição da saída da primeira combinação de uma expressão regular
Para exibir a saída a partir da primeira ocorrência de texto que combina com uma expressão regular, você entra depois do símbolo find do pipe (|). Se a expressão regular contiver espaços, operadores ou caracteres de caracteres curinga, estendo-a entre aspas.
O exemplo a seguir mostra as rotas na tabela de roteamento a partir do endereço 208.197.169.0 IP:
user@host> show route | find 208.197.169.0
208.197.169.0/24 *[Static/5] 1d 13:22:11
> to 192.168.4.254 via so-3/0/0.0
224.0.0.5/32 *[OSPF/10] 1d 13:22:12, metric 1
iso.0: 1 destinations, 1 routes (1 active, 0 holddown, 0 hidden)
+ = Active Route, - = Last Active, * = Both
47.0005.80ff.f800.0000.0108.0001.1921.6800.4015.00/160
*[Direct/0] 1d 13:22:12
> via lo0.0
O exemplo a seguir mostra a primeira entrada CCC na tabela de encaminhamento:
user@host> show route forwarding-table | find ccc
Routing table: ccc
MPLS:
Interface.Label Type RtRef Nexthop Type Index NhRef Netif
default perm 0 rjct 3 1
0 user 0 recv 5 2
1 user 0 recv 5 2
32769 user 0 ucst 45 1 fe-0/0/0.534
fe-0/0/0. (CCC) user 0 indr 44 2
10.0.16.2 Push 32768, Push
Exemplo de retenção de saída após a última tela
Você pode manter a saída e a role ou pesquisá-la segurando-a em vez de retornar imediatamente ao prompt da CLI após a visualização da última tela de saída. Para manter a saída, você entra hold depois do símbolo do pipe (|). O exemplo a seguir impede o retorno à solicitação de CLI depois de ter visualizado a última tela de saída do show log log-file-1 comando:
user@host> show log log-file-1 | holdExemplo de exibição da saída começando com as últimas entradas
Você pode exibir arquivos de log nos quais a ponta do arquivo contém as entradas mais recentes. Para exibir texto a partir da ponta da saída, você entra depois do símbolo last <lines> do pipe (|).
O exemplo a seguir exibe as últimas entradas do log-file-1 arquivo:
user@host> show log log-file-1 | last Quando o número de linhas requerida é inferior ao número de linhas que a configuração de comprimento da tela permite exibir, o sistema retornará um subconjunto. O sistema retorna o máximo de linhas permitida pela configuração de comprimento da tela. Ou seja, se o comprimento da tela for definido como 20 linhas e você tiver solicitado apenas as últimas 10 linhas, o sistema retornará as últimas 19 linhas em vez das últimas 10 linhas.
Exemplo de exibição de saída que combina com uma expressão regular
Para exibir uma saída que corresponde a uma expressão regular, você entra matchregular-expression depois do símbolo de pipe (|). Se a expressão regular contiver espaços, operadores ou caracteres de caracteres curinga, estendo-a entre aspas.
O exemplo a seguir combina com todas as interfaces do modo de transferência assíncrona (ATM) na configuração:
user@host> show configuration | match at-
at-2/1/0 {
at-2/1/1 {
at-2/2/0 {
at-5/2/0 {
at-5/3/0 {
Exemplo de impedir que a saída seja paginada
Por padrão, se a saída for maior do que o comprimento da tela do terminal, você receberá uma mensagem ---(more)--- para exibir a saída restante. Para exibir a saída restante, você pressionar Space.
Para evitar que a saída seja paginada, você entra depois do símbolo no-more do pipe (|).
O exemplo a seguir exibe a saída do show configuration comando de uma só vez:
user@host> show configuration | no-moreEsse recurso é útil se você quiser copiar toda a saída e conhe-la em uma mensagem de e-mail.
Exemplo de envio de saída de comando para outros usuários
Para exibir a saída de comando no terminal de um usuário específico conectado ao roteador ou nos terminais de todos os usuários conectados ao roteador, você entra depois do símbolo do pipe request message (all | user account@terminal) (|).
Se você está solucionando problemas no roteador e falando com um representante de atendimento ao cliente no telefone, você pode compartilhar a saída do comando. Você usa o comando para enviar ao seu representante a saída de comando request message visualizada no momento no seu terminal.
O exemplo a seguir envia a saída do show interfaces comando que você entra no seu terminal até o terminal do root@ttyp1 usuário:
user@host> show interfaces | request message user root@ttyp1O usuário root@ttyp1 vê a seguinte saída aparecer na tela do terminal:
Message from user@host on /dev/ttyp0 at 10:32 PST... Physical interface: dsc, Enabled, Physical link is Up Interface index: 5, SNMP ifIndex: 5 Type: Software-Pseudo, MTU: Unlimited...
Exemplo de resolução de endereços IP
Somente no modo operacional, se a saída de um comando exibir um endereço IP não resolvido, você pode entrar depois do comando para exibir o nome associado ao | resolve endereço IP. O resolve filtro permite que o sistema realize uma análise reversa de DNS do endereço IP. Caso o DNS não seja ativado, a olhada falha e nenhuma substituição é realizada.
Para realizar uma análise de DNS reversa de um endereço IP não resolvido, você entra depois do símbolo resolve <full-names> do pipe (|). Caso você não especifique a opção, o nome será truncado para atender a quaisquer limitações de largura de campo full-names aplicadas ao endereço IP.
O exemplo a seguir realiza uma busca de DNS em quaisquer endereços IP não resolvidos na saída do show ospf neighbors comando:
user@host> show ospf neighbors | resolve Exemplo de como salvar a saída em um arquivo
Quando a saída de comando é longa, quando você precisa armazenar ou analisar a saída, ou quando você precisar enviar a saída em uma mensagem de e-mail ou por FTP, você pode salvar a saída em um arquivo. Por padrão, o arquivo é colocado em seu diretório doméstico no roteador.
Para salvar a saída de comando em um arquivo, você entra save filename depois do símbolo de pipe (|).
O exemplo a seguir economiza a saída do request support information comando para um arquivo chamado my-support-info.txt:
user@host> request support information | save my-support-info.txt
Wrote 1143 lines of output to ‘my-support-info.txt’Exemplo de saída pendente em um arquivo
Quando a saída de comando é exibida, você pode salvar a saída em um arquivo, o que sobregrava o conteúdo existente desse arquivo, ou você pode anexar o texto de saída a um arquivo específico.
Para anexar a saída de comando ao arquivo, você entra depois do símbolo append filename de pipe (|).
O exemplo a seguir anexa a saída do request support information comando a um arquivo chamado my-support-info.txt:
user@host> request support information | append my-support-info.txt
Wrote 2247 lines of output to 'my-support-info.txt'Exemplo de exibição de saída na tela e escrita em um arquivo
Quando a saída de comando é exibida, você também pode escrever a saída para um arquivo. Para exibir a saída e escrevê-la em um arquivo, você entra tee filename depois do símbolo do pipe (|).
O exemplo a seguir exibe a saída do comando (exibindo informações sobre o status das show interfaces ge-* terse interfaces Ethernet Gigabit no dispositivo) e desvia a saída para um arquivo chamado ge-interfaces.txt :
user@host> show interfaces ge-* terse | tee ge-interfaces.txt
Interface Admin Link Proto Local Remote
ge-0/1/0 up down
ge-0/1/1 up up
ge-0/1/2 up down
ge-0/1/3 up upAo contrário do comando UNIX, só é exibido uma mensagem de erro se o arquivo não puder ser aberto (em vez de exibir a saída e, em seguida, a tee mensagem de erro).
user@host> show interfaces ge-* terse | tee /home/user/test.txt
error: tee failed: file /home/user/test.txt could not be opened
user@host> Exemplo de como aparar a saída especificando a coluna inicial
A saída aparece na tela do terminal em termos de linhas e colunas. O primeiro caractere alfanumérico a partir da esquerda da tela está na coluna 1, o segundo caractere está na coluna 2 e assim por diante. Para exibir a saída a partir de uma coluna específica (assim, ao aparar a porção mais esquerda da saída), você entra depois do símbolo trim columns do pipe (|). O trim filtro é útil para aparar a data e a hora desde o início das mensagens de log do sistema.
O exemplo a seguir exibe a saída do show system storage comando, filtrando as primeiras 10 colunas:
user@host> show system storage | trim 11O trim comando não aceita valores negativos.
Exemplo de como atualizar a saída de um comando
Você pode executar um comando do modo operacional com a opção de pipe para atualizar a saída | refresh exibida na tela periodicamente. A atualização padrão ocorre a cada segundo. Entretanto, você também pode especificar explicitamente um intervalo de atualização de 1 a 604.800 segundos. Por exemplo, para atualizar a saída do show interfaces comando a cada 5 segundos, você executará o seguinte comando:
user@host> show interfaces | refresh 5Filtrar a saída de comando do modo operacional em um sistema QFabric
Ao emitir um comando de modo operacional em um sistema QFabric, a saída gerada pode ser bastante ampla devido ao número de componentes contidos no sistema. Para tornar a saída mais acessível, você pode filtrar a saída com a opção ao | filter final da maioria dos comandos.