Ferramenta de Linha de Comandos LogViewer
Use o comando LogViewer para consultar o conteúdo dos repositórios de log e rastreio High Performance Extensible Logging (HPEL). Também é possível usar o comando LogViewer para visualizar novas entradas do repositório de log e rastreio conforme o servidor grava conteúdo neles.
LogViewer
O recurso High Performance Extensible Logging (HPEL) grava nos repositórios de log e rastreio em um formato binário. É possível visualizar, consultar e filtrar o repositório usando o comando LogViewer. O comando LogViewer fornece opções para converter rapidamente logs HPEL em um arquivo de texto em vários formatos, incluindo formato básico, avançado e Common Base Event. O comando também fornece opções para obter os dados necessários a partir dos logs mais facilmente; por exemplo, permitindo filtrar quais registros de log você deseja por nível, nome do criador de logs ou data e hora.
(Windows) logViewer.bat
(Unix - perfil completo) logViewer.sh
(Unix - perfil Liberdade) logViewer
Parâmetros Opcionais
- [Liberty profile] servername
- Especifica o nome do servidor cujos repositórios de dados de log e rastreio você deseja que o comando logViewer use. Esse parâmetro não é necessário nos casos em que existe apenas um servidor de perfil liberdade criado, nem nos casos em que você especifica o caminho para a raiz do repositório de dados de log e rastreio usando o parâmetro -repositoryDir.
- -repositoryDir directory_name
- Especifica o caminho para o diretório do repositório. No caso em que deseja consultar os dados de log e rastreio juntos, forneça o caminho para o diretório-pai, que contém os dados do log e os diretórios de dados de rastreio. Se você usar o local do repositório padrão, profile_root/logs/application_server/, e executar esta ferramenta a partir do diretório bin do perfil, este argumento será opcional. A ferramenta verifica o local padrão se um não é fornecido. Se diversos servidores de aplicativos existirem neste perfil com repositórios HPEL, será solicitado que você selecione qual log do servidor e repositório de rastreio deseja visualizar.
- -outLog file_name
- Especifica o nome do arquivo no qual deseja que a saída de texto seja gravada. Se você não fornecer estas informações, a saída de texto será exibida no console.
- -format basic | advanced | cbe-1.0.1
- Especifica o formato de saída. Os formatos suportados incluem o formato básico, avançado e CBE-1.0.1. Se você não fornecer estas informações, a saída ficará no formato básico.
- -monitor [integer]
- Especifica que você deseja que o logViewer monitore continuamente o repositório e envie novas entradas do registro de log conforme elas são criadas. É possível fornecer um argumento de número inteiro opcional após este parâmetro para especificar com que frequência você deseja que a ferramenta LogViewer consulte o repositório para obter novos registros. Por padrão, o logViewer consulta o repositório para obter novos registros a cada 5 segundos. Quando usado com outras opções de filtragem, somente esses novos registros que correspondem aos critérios de filtro são exibidos.
- -help
- Use este parâmetro para que a ferramenta LogViewer liste o conjunto integral de opções que estão disponíveis.
- -startDatedate_time
- É possível filtrar os resultados que são exibidos a partir do repositório por data e hora. Use o parâmetro startDate para filtrar entradas de log que ocorreram após a data ou a data e hora fornecidas como um argumento. Forneça uma data ou uma data e hora, inseridas no formato MM/dd/aa ou no formato MM/dd/aa H:m:s:S z. Com z se referindo ao fuso horário.
- -stopDate date_time
- Use este usar para filtrar entradas de log que ocorreram antes da data ou da data e hora especificadas. Forneça o argumento no mesmo formato que a opção -startDate.
- -level level_name
- Especifica que você deseja que a ferramenta exiba somente os eventos de log que correspondam ao nome do nível fornecido como um argumento. Os valores válidos para o nome do nível são FINEST, FINER, FINE, DETAIL, CONFIG, INFO, AUDIT, WARNING, SEVERE, FATAL.
- -minLevel level_name
- Especifica que você deseja que a ferramenta exiba somente registros que estão no nível especificado ou acima dele. Os valores válidos para o nome do nível são FINEST, FINER, FINE, DETAIL, CONFIG, INFO, AUDIT, WARNING, SEVERE, FATAL.
- -maxLevel level_name
- Especifica que você deseja que a ferramenta exiba somente registros que estão no nível especificado ou abaixo dele. Os valores válidos para o nome do nível são FINEST, FINER, FINE, DETAIL, CONFIG, INFO, AUDIT, WARNING, SEVERE, FATAL.
- -includeLoggers logger_name
- Quando esta opção é usada, somente eventos de log dos criadores de logs especificados são incluídos na saída LogViewer. Separe diversas entradas com uma vírgula. O símbolo * pode ser usado como um curinga para incluir todos os criadores de logs abaixo de um criador de logs pai. Quando usado em combinação com a opção -excludedLoggers, a correspondência mais específica determina se o evento de log é incluído ou excluído.
- -excludeLoggers logger_name
- Use esta opção para excluir eventos de log dos criadores de logs especificados na saída LogViewer. Separe diversas entradas com uma vírgula. O símbolo * pode ser usado como um curinga para incluir todos os criadores de logs abaixo de um criador de logs pai. Quando usado em combinação com a opção -includeLoggers, a correspondência mais específica determina se o evento de log é incluído ou excluído.
- -thread thread_id
- Use esta opção para restringir a saída do LogViewer apenas àqueles eventos de log a partir de um encadeamento específico. Quaisquer mensagens de log que não foram criadas pelo ID de encadeamento fornecido como um argumento para esta opção não serão exibidas. Especifique o ID de encadeamento no formato hexa.
- -extractToNewRepositorydirectory_name
- Esta opção redireciona registros de log e rastreio de um repositório binário para um novo repositório binário no local especificado. É possível usar esta opção com outras opções de filtragem para obter um subconjunto de registros de log e rastreio no novo repositório. Esta opção usa o caminho do diretório no qual o novo repositório deve ser gravado como um argumento. Portanto, o diretório deve ficar vazio. Se o diretório não existir, ele será criado. No entanto, erros que ocorrem durante a criação do diretório podem criar diretórios estranhos.
- -listInstances
- Use esta opção para listar os IDs de instâncias de processo do servidor que estão disponíveis para uso com a opção -instance. Após executar o LogViewer com a opção -listInstances, é possível, então, usar a opção -instance para chamar o LogViewer com um dos IDs da instância do processo do servidor como um argumento. Como esta opção não processa nenhum registro de log ou rastreio, todas as outras opções são ignoradas quando você especifica esta opção.
- -instance instance_id
- Use esta opção para recuperar os dados de log e rastreio para uma determinada instância do processo do servidor fornecendo o ID da instância do servidor. Execute o LogViewer, juntamente com a opção -listInstances, antes de usar esta opção para obter um ID da instância válido. Esta opção é requerida ao visualizar logs e rastreio a partir de um ambiente que contém subprocessos, tal como o sistema operacional z/OS.
- Se esta opção for combinada com -latestInstance, -instance será ignorado.
- -latestInstance
- Use esta opção para recuperar os dados de log e rastreio da instância do servidor mais recente. Se esta opção for usada com a opção -instance, a opção -instance será ignorada.
- -message match_string
- Use esta opção para recuperar somente dados de log e rastreio com um campo da mensagem que corresponde ao texto solicitado.
- -includeExtensions name[=value][,name[=value]]*
- Use esta opção para recuperar os dados de log e rastreio com um nome de extensão que corresponda ao nome solicitado e um valor de extensão que corresponda ao valor solicitado. Também é possível usar esta opção para recuperar os dados de log e rastreio com um nome de extensão que corresponda ao nome solicitado e um valor de extensão que corresponda a qualquer valor, se você omitir a parte =value da opção.
- Qualquer nome de extensão mostrado no formato avançado pode ser usado. Observe que 'source', 'class' e 'method' não são armazenados nos repositórios de log/rastreio como extensões e, portanto, não podem ser filtrados com esta opção.
- Separe diversos argumentos name=value com uma vírgula. Especifique '==' (dois sinais de igual) no lugar de '=' (um sinal de igual) nos casos em que o nome ou valor deve conter um sinal de igual. Especifique ',,' (duas vírgulas) no lugar de ',' (uma vírgula) nos casos em que o nome ou valor deve conter uma vírgula.
- -encoding character_set
- Especifica o conjunto de caracteres que o comando LogViewer usará para saída de texto.
Considerações sobre Filtragem
Esteja ciente das otimizações de filtragem do LogViewer. A ferramenta LogViewer está apta a filtrar dados de log e rastreio de forma mais eficiente quando usada com as opções de filtro a seguir:
- startDate
- stopDate
- thread
- level
- minLevel
- maxLevel
Exemplo de uso
Consulte os exemplos a seguir dos comandos LogViewer usados com servidores de perfil completo nos sistemas baseados em UNIX. Os exemplos mostram como executar o LogViewer a partir do diretório bin do perfil no qual o parâmetro repositoryDir não é necessário.
- Gravar todos os registros no repositório padrão entre 19 de Julho de
2009 e 2 de Agosto de 2009 em um arquivo chamado /tmp/promo.logs.
logViewer.sh -outLog /tmp/promo.logs -startDate 07/19/2009 -stopDate 08/02/2009
- Exibir novos registros cujo nível especificado é AVISO ou superior
usando o formato avançado conforme o servidor os grava no repositório de log.
logViewer.sh -monitor -minLevel WARNING -format advanced
- Gravar somente aquelas mensagens de log que foram gravadas no fluxo de
erros de um repositório específico em um arquivo chamado logged_errors.txt.
logViewer.sh -repositoryDir /apps/server1/logs -includeLoggers SystemErr -outLog logged_errors.txt
- Visualizar eventos do repositório padrão que ocorreu antes de
14 de Setembro de 2009 16h28 horário do leste.
logViewer.sh -stopDate "09/14/2009 16:28:00:000 EDT"
- Gravar eventos do repositório padrão
que contêm uma extensão 'thread' com o valor 'WebContainer : 6'
logViewer.sh -includeExtensions thread="WebContainer : 6" -format advanced
- Gravar eventos do repositório padrão que faziam parte da
solicitação com requestID a856cb2c-79ed-4d62-a3cf-a9908b2db07b.
logViewer.sh -includeExtensions requestID=a856cb2c-79ed-4d62-a3cf-a9908b2db07b
- Gravar eventos do repositório padrão que foram criados em
um encadeamento que serve o aplicativo PlantsByWebSphere.
logViewer.sh -includeExtensions appName=PlantsByWebSphere
![[z/OS]](../images/ngzos.gif)
- Chamar o LogViewer com a opção -listInstances; por exemplo:
logViewer.sh -listInstances
O exemplo a seguir é uma lista de IDs da instância a partir de um controlador e três servidores:
Instance ID Start Date 1280334046 5/10/10 18:53:12:770 GMT 1280334046/000001BC00000002_BBOS1S_STC003119 5/10/10 18:53:39:220 GMT 1280334046/000001B400000002_BBOS1S_STC003120 5/10/10 18:54:44:339 GMT 1280334046/000001C000000001_BBOS1S_STC003121 5/10/10 18:55:43:520 GMT
-
Chamar o LogViewer com a opção -instance usando um dos IDs da instância do exemplo anterior. O tipo de ID é um controlador; por exemplo:
logViewer.sh -instance 1280334046
- Chamar o LogViewer com a opção -instance para uma instância do servidor;
por exemplo:
logViewer.sh -instance 1280334046/000001BC00000002_BBOS1S_STC003119