Rastreamento de eventos L2TP para solução de problemas
O recurso de rastreamento do Junos OS rastreia operações L2TP e registra eventos em um arquivo de log. As descrições de erro capturadas no arquivo de log fornecem informações detalhadas para ajudá-lo a resolver problemas.
Este tópico refere-se ao rastreamento de operações L2TP em roteadores da Série MX. Para rastrear operações L2TP em roteadores da Série M, consulte Rastreamento de operações L2TP.
Por padrão, nada é rastreado. Quando você habilita a operação de rastreamento, o comportamento de rastreamento padrão é o seguinte:
Eventos importantes são registrados em um arquivo localizado no
/var/logdiretório. Por padrão, o roteador usa o nomejl2tpdde arquivo . Você pode especificar um nome de arquivo diferente, mas não pode alterar o diretório no qual os arquivos de rastreamento estão localizados.Quando o arquivo
filenamede log de rastreamento atinge 128 kilobytes (KB), ele é compactado e renomeadofilename.0.gzcomo . Os eventos subsequentes são registrados em um novo arquivo chamadofilename, até que ele atinja a capacidade novamente. Neste ponto,filename.0.gzé renomeadofilename.1.gzefilenameé compactado e renomeadofilename.0.gz. Esse processo se repete até que o número de arquivos arquivados atinja o número máximo de arquivos. Em seguida, o arquivo de rastreamento mais antigo — aquele com o número mais alto — é substituído.Opcionalmente, você pode especificar o número de arquivos de rastreamento de 2 a 1000. Você também pode configurar o tamanho máximo do arquivo para ser de 10 KB a 1 gigabyte (GB). (Para obter mais informações sobre como os arquivos de log são criados, consulte o Explorador de Logs do Sistema.)
Por padrão, somente o usuário que configura a operação de rastreamento pode acessar arquivos de log. Opcionalmente, você pode configurar o acesso somente leitura para todos os usuários.
Os tópicos a seguir descrevem como configurar todos os aspectos do rastreamento de operações L2TP:
Configurando o nome do arquivo de log de rastreamento L2TP
Por padrão, o nome do arquivo que registra a saída de rastreamento para L2TP é jl2tpd. Você pode especificar um nome diferente com a file opção.
Para configurar o nome do arquivo para operações de rastreamento L2TP:
Especifique o nome do arquivo usado para a saída de rastreamento.
[edit services l2tp traceoptions] user@host# set file l2tp_logfile_1
Configurando o número e o tamanho dos arquivos de log L2TP
Opcionalmente, é possível especificar o número de arquivos de log de rastreamento compactados e arquivados de 2 a 1000. Você também pode configurar o tamanho máximo do arquivo para ser de 10 KB a 1 gigabyte (GB); o tamanho padrão é de 128 kilobytes (KB).
Os arquivos arquivados são diferenciados por um sufixo no formato .number.gz. O arquivo arquivado mais recente é .0.gz e o arquivo arquivado mais antigo é .(maximum number)-1.gz. Quando o arquivo de log de rastreamento atual atinge o tamanho máximo, ele é compactado e renomeado, e todos os arquivos arquivados existentes são renomeados. Esse processo se repete até que o número máximo de arquivos arquivados seja atingido, momento em que o arquivo mais antigo é substituído.
Por exemplo, você pode definir o tamanho máximo do arquivo como 2 MB e o número máximo de arquivos como 20. Quando o arquivo que recebe a saída da operação de rastreamento, filename, atinge 2 MB, filename é compactado e renomeado filename.0.gz, e um novo arquivo chamado filename é criado. Quando o novo filename atinge 2 MB, filename.0.gz é renomeado filename.1.gz e filename é compactado e renomeado filename.0.gz. Esse processo se repete até que haja 20 arquivos de rastreamento. Em seguida, o arquivo mais antigo, filename.19.gz, é simplesmente substituído quando o próximo arquivo filename.18.gz mais antigo é compactado e renomeado para filename.19.gz.
Para configurar o número e o tamanho dos arquivos de rastreamento:
Especifique o nome, o número e o tamanho do arquivo usado para a saída de rastreamento.
[edit services l2tp traceoptions] user@host# set file l2tp_1 _logfile_1 files 20 size 2097152
Configurando o acesso ao arquivo de log L2TP
Por padrão, somente o usuário que configura a operação de rastreamento pode acessar os arquivos de log. Você pode permitir que todos os usuários leiam o arquivo de log e pode definir explicitamente o comportamento padrão do arquivo de log.
Para especificar que todos os usuários podem ler o arquivo de log:
Configure o arquivo de log para ser legível por todos.
[edit services l2tp traceoptions] user@host# set file l2tp_1 _logfile_1 world-readable
Para definir explicitamente o comportamento padrão, somente o usuário que configurou o rastreamento pode ler o arquivo de log:
Configure o arquivo de log para não ser legível por todos.
[edit services l2tp traceoptions] user@host# set file l2tp_1 _logfile_1 no-world-readable
Configuração de uma expressão regular para que mensagens L2TP sejam registradas
Por padrão, a saída da operação de rastreamento inclui todas as linhas relevantes para os eventos registrados.
Você pode refinar a saída incluindo expressões regulares a serem correspondidas.
Para configurar expressões regulares a serem correspondidas:
Configure a expressão regular.
[edit services l2tp traceoptions] user@host# set file l2tp_1 _logfile_1 match regex
Configurando a filtragem de assinantes para operações de rastreamento L2TP
A partir do Junos OS Release 14.1, você pode aplicar filtros ao L2TP para limitar o rastreamento a assinantes ou domínios específicos. A filtragem de assinantes simplifica a solução de problemas em um ambiente dimensionado, permitindo que você se concentre em um conjunto reduzido de resultados de rastreamento.
Para nomes de usuário de assinante que têm a forma esperada de user@domain, você pode filtrar o usuário, o domínio ou ambos. Você pode usar um asterisco (*) como um curinga para substituir caracteres no início ou no final de um dos termos ou de ambos os termos para corresponder a um número maior de assinantes.
Você não pode filtrar resultados usando um curinga no meio dos termos de usuário ou domínio. Por exemplo, não há suporte para os seguintes usos do curinga: tom*25@example.com, tom125@ex*.com.
Quando você habilita a filtragem por nome de usuário, os rastreamentos que não têm informações suficientes para determinar o nome de usuário são excluídos automaticamente.
Para configurar a filtragem de assinantes:
Especifique o filtro.
[edit services l2tp traceoptions] user@host# set filter user user@domain
Observação:Essa sintaxe é diferente da sintaxe usada para filtrar assinantes em roteadores da Série M.
Considere os seguintes exemplos de uso do curinga para filtragem:
Filtre os resultados do assinante específico com o nome de usuário tom@example.com.
[edit services l2tp traceoptions] user@host# set filter user tom@example.com
Filtre os resultados para todos os assinantes cujo nome de usuário comece com tom.
[edit services l2tp traceoptions] user@host# set filter user tom*
Filtre os resultados para todos os assinantes cujo nome de usuário termina com tom.
[edit services l2tp traceoptions] user@host# set filter user *tom
Filtre os resultados para assinantes com o nome de usuário tom em todos os domínios começando com ex.
[edit services l2tp traceoptions] user@host# set filter user tom@ex*
Filtre os resultados de todos os assinantes em todos os domínios que terminam com ample.com.
[edit services l2tp traceoptions] user@host# set filter user *ample.com
Filtre os resultados de todos os assinantes cujo nome de usuário começa com tom em domínios que terminam com example.com.
[edit services l2tp traceoptions] user@host# set filter user tom*@*example.com
Configurando os sinalizadores de rastreamento L2TP
Por padrão, apenas eventos importantes são registrados. Você pode especificar quais eventos e operações são registrados especificando um ou mais sinalizadores de rastreamento.
Para configurar os sinalizadores dos eventos a serem registrados:
Configure os sinalizadores.
[edit services l2tp traceoptions] user@host# set flag flag
Configurando o nível de gravidade para filtrar quais mensagens L2TP são registradas
As mensagens associadas a um evento registrado são categorizadas de acordo com o nível de gravidade. Você pode usar o nível de gravidade para determinar quais mensagens são registradas para o tipo de evento. Um nível de gravidade baixo é menos restritivo — filtra menos mensagens — do que um nível mais alto. Quando você configura um nível de gravidade, todas as mensagens nesse nível e todos os níveis mais altos (mais restritivos) são registrados.
A lista a seguir apresenta os níveis de gravidade em ordem do mais baixo (menos restritivo) ao mais alto (mais restritivo). Essa ordem também representa o significado das mensagens; Por exemplo, error as mensagens são mais preocupantes do que info as mensagens.
verboseinfonoticewarningerror
O nível de gravidade que você configura depende do problema que você está tentando resolver. Em alguns casos, você pode estar interessado em ver todas as mensagens relevantes para o evento registrado, então você especifica all. Você também pode especificar verbose com o mesmo resultado, porque verbose é o nível de gravidade mais baixo (menos restritivo); não tem nada a ver com a concisão ou verbosidade das mensagens. Qualquer uma das opções gera uma grande quantidade de saída. Você pode especificar um nível de gravidade mais restritivo, como notice ou info para filtrar as mensagens. Por padrão, a saída da operação de rastreamento inclui apenas mensagens com um nível de gravidade de error.
Para configurar o tipo de mensagens a serem registradas:
Configure o nível de gravidade da mensagem.
[edit services l2tp traceoptions] user@host# set level severity
Tabela de histórico de alterações
A compatibilidade com recursos é determinada pela plataforma e versão utilizada. Use o Explorador de recursos para determinar se um recurso é compatível com sua plataforma.