Trace o processamento de script SNMP em dispositivos que executam o Junos OS
As operações de rastreamento de script SNMP rastreiam as operações de script SNMP e as registram em um arquivo de log. As descrições de erro registradas fornecem informações detalhadas para ajudar você a resolver problemas mais rapidamente.
No Junos OS, a operação padrão do rastreamento de scripts SNMP é registrar eventos importantes, que incluem erros, avisos, mensagens de progresso e eventos de processamento de scripts, no arquivo /var/log/snmp.log no dispositivo. Quando o arquivo snmp.log atinge 128 kilobytes (KB), ele é renomeado com um número 0 a 9 (em ordem crescente) apensado ao final do arquivo e depois comprimido. Os arquivos resultantes são snmp.log.0.gz e depois snmp.log.1.gz, até que haja 10 arquivos de rastreamento. Em seguida, o arquivo de rastreamento mais antigo (snmp.log.9.gz) é sobreescrito.
O Junos OS Evolved captura rastreamento de dados para todos os aplicativos por padrão e coleta os dados para todos os tipos de script em arquivos de rastreamento que correspondem ao cscript
aplicativo. Para visualizar os dados de rastreamento, emita o show trace application cscript
comando. Para obter mais informações, veja Trace Script Processing em dispositivos que executam o Junos OS Evolved.
Configuração mínima para habilitar traceoptions para scripts SNMP
Se nenhuma opção de rastreamento de script de SNMP estiver configurada, a maneira mais simples de visualizar a saída de rastreamento de um script SNMP é configurar a bandeira de output
rastreamento e emitir o show log snmp.log | last
comando. Para fazer isso, execute as seguintes etapas:
Se você ainda não o tiver feito, habilite um script SNMP incluindo a
file
declaração no nível hierárquica[edit system scripts snmp]
.[edit system scripts snmp] user@host# set file filename oid oid
Habilite opções de rastreamento incluindo a
traceoptions flag output
declaração no nível de[edit system scripts snmp]
hierarquia.[edit system scripts snmp] user@host# set traceoptions flag output
Confirmar a configuração.
[edit] user@host# commit and-quit
Para exibir as mensagens de rastreamento resultantes gravadas no final do arquivo /var/log/snmp.log , emita o comando do
show log snmp.log | last
modo operacional.user@host> show log snmp.log | last
A Tabela 1 resume comandos de filtragem úteis que exibem partes selecionadas do snmp.log
arquivo.
Tarefa |
Comando |
---|---|
Exibir dados de registro associados a todo o processamento de script SNMP. |
|
Exibir processamento apenas para a operação mais recente. |
|
Exibir processamento para erros de script. |
|
Exibir processamento para um script específico. |
|
Exemplo: Configuração mínima para habilitar traceoptions para scripts SNMP
Exibir a saída de rastreamento do arquivo de script SNMP sample_snmp.slax no arquivo de log de script SNMP padrão:
[edit] system { scripts { snmp { file sample_snmp.slax { oid .1.3.6.1.4.1.2636.13.61.1.9.1.1; } traceoptions { flag output; } } }
[edit] user@host# commit and-quit
user@host> show snmp mib get .1.3.6.1.4.1.2636.13.61.1.9.1.1.1 juniperMIB.13.61.1.9.1.1.1 = 211 user@host> show log snmp.log | last Mar 1 11:00:09 snmp script processing begins Mar 1 11:00:09 running snmp script 'sample_snmp.slax' Mar 1 11:00:09 opening snmp script '/var/run/scripts/snmp//sample_snmp.slax' Mar 1 11:00:09 snmp script input Mar 1 11:00:09 begin dump <?xml version="1.0" standalone="yes"?> <snmp-script-input> <snmp-action>get</snmp-action> <snmp-oid>.1.3.6.1.4.1.2636.13.61.1.9.1.1.1</snmp-oid> </snmp-script-input> Mar 1 11:00:09 end dump Mar 1 11:00:09 reading snmp script 'sample_snmp.slax' Mar 1 11:00:09 snmp script output Mar 1 11:00:09 begin dump <?xml version="1.0"?> <snmp-script-results> <snmp-oid>.1.3.6.1.4.1.2636.13.61.1.9.1.1.1</snmp-oid> <snmp-type>Integer32</snmp-type> <snmp-value>211</snmp-value> </snmp-script-results> Mar 1 11:00:09 end dump Mar 1 11:00:09 inspecting snmp output 'sample_snmp.slax' Mar 1 11:00:09 sample_snmp.slax triggered for oid = .1.3.6.1.4.1.2636.13.61.1.9.1.1.1, with type = Integer32, and with value = 211 Mar 1 11:00:09 finished snmp script 'sample_snmp.slax' Mar 1 11:00:09 snmp script processing ends
Configure o rastreamento de scripts SNMP
Você não pode alterar o diretório (/var/log) para o qual os arquivos de rastreamento estão escritos. No entanto, você pode personalizar outras configurações de arquivo de rastreamento, incluindo as seguintes declarações no nível de [edit system scripts snmp traceoptions]
hierarquia:
[edit system scripts snmp traceoptions] file <filename> <files number> <size size> <world-readable | no-world-readable>; flag all; flag events; flag input; flag offline; flag output; flag rpc; flag xslt; no-remote-trace;
Essas declarações são descritas nas seguintes seções:
- Configure o nome de arquivo de log de script SNMP
- Configure o número e o tamanho dos arquivos de log de script SNMP
- Configure o acesso aos arquivos de log de script SNMP
- Configure as operações de rastreamento de script SNMP
Configure o nome de arquivo de log de script SNMP
Por padrão, o nome do arquivo que registra a saída de rastreamento de scripts SNMP é snmp.log. Você pode especificar um nome diferente, incluindo a file
declaração no nível de [edit system scripts snmp traceoptions]
hierarquia.
[edit system scripts snmp traceoptions] file filename;
Configure o número e o tamanho dos arquivos de log de script SNMP
Por padrão, quando o arquivo de rastreamento atinge 128 KB em tamanho, ele é renomeado e comprimido para filename.0.gz, depois filename.1.gz e assim por diante, até que haja 10 arquivos de rastreamento. Em seguida, o arquivo de rastreamento mais antigo (filename.9.gz) é sobreescrito.
Você pode configurar os limites do número e do tamanho dos arquivos de rastreamento, incluindo as seguintes declarações no nível de [edit system scripts snmp traceoptions file filename]
hierarquia:
[edit system scripts snmp traceoptions file filename] files number size size;
Por exemplo, definir o tamanho máximo do arquivo para 640 KB e o número máximo de arquivos para 20. Quando o arquivo que recebe a saída da operação de rastreamento (filename) chega a 640 KB, ele é renomeado e comprimido para filename.0.gz, e um novo arquivo chamado filename é criado. Quando filename chega a 640 KB, filename.0.gz é renomeada filename.1.gz, e filename é renomeada e compactada para filename.0.gz. Esse processo se repete até que haja 20 arquivos de rastreamento. Em seguida, o arquivo mais antigo (filename.19.gz) é sobreescrito.
O número de arquivos pode variar de 2 a 1000 arquivos. O tamanho do arquivo pode variar de 10 KB a 1 gigabyte (GB).
Se você definir um tamanho máximo de arquivo ou um número máximo de arquivos de rastreamento, você também deve especificar o outro parâmetro e um nome de arquivo.
Configure o acesso aos arquivos de log de script SNMP
Por padrão, o acesso ao arquivo de log de script SNMP é restrito ao proprietário. Você pode configurar o acesso manualmente incluindo a declaração ou no-world-readable
a world-readable
declaração no nível de [edit system scripts snmp traceoptions file filename]
hierarquia.
[edit system scripts snmp traceoptions file filename] (world-readable | no-world-readable);
A no-world-readable
declaração restringe o acesso de log de script SNMP ao proprietário. A world-readable
declaração permite acesso irrestrito ao arquivo de log de script SNMP.
Configure as operações de rastreamento de script SNMP
Por padrão, a bandeira de traceoptions events
é ativada, independentemente das configurações de configuração, e apenas eventos importantes são registrados. Isso inclui erros, avisos, mensagens de progresso e eventos de processamento de scripts. Você pode configurar as operações de rastreamento a serem registradas, incluindo as seguintes declarações no nível de [edit system scripts snmp traceoptions]
hierarquia:
[edit system scripts snmp traceoptions] flag all; flag events; flag input; flag offline; flag output; flag rpc; flag xslt;
A Tabela 2 descreve o significado das bandeiras de rastreamento de scriptSNMP.
Bandeira |
Descrição |
Configuração padrão |
---|---|---|
|
Trace todas as operações. |
Desligado |
|
Rastreie eventos importantes, incluindo erros, avisos, mensagens de progresso e eventos de processamento de scripts. |
Em |
|
Trace dados de entrada de script SNMP. |
Desligado |
|
Gere dados para o desenvolvimento offline. |
Desligado |
|
Trace dados de saída de script SNMP. |
Desligado |
|
Trace RPCs de script SNMP. |
Desligado |
|
Trace a biblioteca Extensible Stylesheet Language Transformations (XSLT). |
Desligado |