Configure uma política de eventos para executar comandos de modo operacional
Os comandos de modo operacional realizam uma operação ou fornecem saída de diagnóstico em um dispositivo que executa o Junos OS. Eles permitem que você visualize estatísticas e informações sobre o status operacional atual de um dispositivo. Eles também permitem que você tome ações corretivas, como reiniciar processos de software, tirar uma placa de interface física (PIC) offline e voltar a funcionar, mudar para interfaces redundantes e ajustar a largura de banda do Protocolo de Comutação de Rótulos (LSP). Para obter mais informações sobre comandos de modo operacional, consulte o CLI Explorer.
Você pode configurar uma política de eventos que executa comandos de modo operacional e envia a saída desses comandos para um local especificado para análise, incluindo as seguintes declarações no nível de [edit event-options]
hierarquia:
[edit event-options] policy policy-name { events [ events ]; then { execute-commands { commands { "command"; } output-filename filename; output-format (text | xml); destination destination-name; } } }
events
No comunicado, você pode listar vários eventos. Se um ou mais eventos listados ocorrerem, o processo eventuado executará os comandos de modo operacional configurados para a commands
declaração. Inclua cada comando entre aspas (" "
). O processo eventuais emite os comandos na ordem em que eles aparecem na configuração. Por exemplo, na configuração a seguir, a execução faz policy1
com que o show interfaces
comando seja emitido primeiro, seguido pelo show chassis alarms
comando:
[edit event-options policy policy1 then execute-commands] user@host# show commands { "show interfaces"; "show chassis alarms"; }
Você pode incluir variáveis no comando para permitir que os dados do evento de acionamento sejam incluídos automaticamente na sintaxe de comando. O processo eventuais substitui cada variável por valores contidos no caso de acionar a política. Você pode usar variáveis de comando dos seguintes formulários:
-
{$$.attribute-name}
— A notação do sinal de dólar duplo ($$
) representa o evento que aciona a política. Quando combinada com um nome de atributo, a variável resolve o valor do atributo associado ao evento de acionamento. Por exemplo,{$$.interface-name}
resolve o nome da interface associado ao evento de acionamento. -
{$event.attribute-name}
— O sinal de dólar único com o nome do evento ($event
) indicação representa o evento mais recente que correspondeevent
. Quando combinada com um nome de atributo, a variável resolve o valor do atributo associado a esse evento. Por exemplo, quando uma política emite oshow interfaces {$COSD_CHAS_SCHED_MAP_INVALID.interface-name}
comando, a{$COSD_CHAS_SCHED_MAP_INVALID.interface-name}
variável se resolve para o nome da interface associado ao evento mais recenteCOSD_CHAS_SCHED_MAP_INVALID
em cache pelo processo de evento. -
{$*.attribute-name}
— O sinal em dólar com a notação de asterisco ($*
) representa o evento mais recente que corresponde a qualquer um dos eventos correlacionais. A variável resolve o valor do atributo associado ao evento mais recente que corresponde a qualquer um dos eventos correlacionados especificados na configuração da política.
Para um determinado evento, você pode ver uma lista de atributos de eventos que você pode fazer referência em um comando de modo operacional emitindo o help syslog event
comando:
user@host> help syslog event
Por exemplo, na saída de comando a seguir, suportes de texto em ângulo (< >
) mostram que classifier-type
é um atributo do cosd_unknown_classifier
evento:
user@host> help syslog cosd_unknown_classifier Name: COSD_UNKNOWN_CLASSIFIER Message: rtsock classifier type <classifier-type> is invalid ...
Outra maneira de ver uma lista de atributos de evento é emitir o comando do set attributes-match event?
modo de configuração no nível de [edit event-options policy policy-name]
hierarquia:
[edit event-options policy policy-name] user@host# set attributes-match event ?
Por exemplo, na saída de comando a seguir, a event.attribute
lista mostra que classifier-type
é um atributo do cosd_unknown_classifier
evento:
[edit event-options policy policy-name] user@host# set attributes-match cosd_unknown_classifier? Possible completions: <from-event-attribute> First attribute to compare cosd_unknown_classifier.classifier-type
Neste set
comando, não há espaço entre o nome do evento e o ponto de interrogação (?
).
Para ver uma lista de todos os atributos de evento que você pode mencionar, emita o comando do set attributes-match ?
modo de configuração no nível de [edit event-options policy policy-name]
hierarquia:
[edit event-options policy policy-name] user@host# set attributes-match ? Possible completions: <from-event-attribute> First attribute to compare acct_accounting_ferror acct_accounting_fopen_error ...
Quando o processo eventuais executa os comandos, ele faz o upload do arquivo com a saída de comando para o local especificado na destination
declaração. destination
Na declaração, inclua um nome de destino configurado no nível de [edit event-options destinations]
hierarquia. Para obter mais informações, veja exemplo: definir destinos para o arquivamento de arquivos por políticas de eventos.
output-filename
Na declaração, defina uma seqüência descritiva que será incluída no nome do arquivo. Cada arquivo carregado também inclui o nome de host e o tempotamp no nome de arquivo para garantir que cada nome de arquivo seja único. Se uma política for acionada várias vezes em um período de 1 segundo, um número de índice é adicionado ao nome do arquivo para garantir que os nomes dos arquivos ainda sejam únicos. A faixa de número do índice é de 001 a 999.
A partir do Junos OS Release 14.1R3, a convenção de nomeação e o formato do arquivo de saída gerados por eventuais alterações. Quando eventuais executam os comandos definidos no nível de [edit event-options policy policy-name then execute-commands commands]
hierarquia e geram um arquivo contendo a saída de comando, o nome do arquivo depende da versão do Junos OS em execução no dispositivo. Antes do Junos OS Release 14.1R3, o nome do arquivo tem a seguinte convenção de nomeação:
hostname_output-filename_YYYYMMDD_HHMMSS_index-number
Começando no Junos OS Release 14.1R3, o nome de arquivo coloca a output-filename seqüência após o tempotamp.
hostname_YYYYMMDD_HHMMSS_output-filename_index-number
Por exemplo, em um dispositivo chamado r1 que executa o Junos OS Release 14.1R3 ou uma versão posterior, se você configurar a output-filename
declaração como eventos de ifl, e essa política de evento for acionada três vezes em 1 segundo, os arquivos são nomeados:
eventos de r1_20060623_132333_ifl
events_001 de r1_20060623_132333_ifl
r1_20060623_132333_ifl-events_002
Por padrão, o formato de saída de comando é Junos Extensible Markup Language (XML). Configure a output-format text
declaração para formatar a saída de comando como texto ASCII .