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.

Use o comando a seguir para visualizar o conteúdo integral de seus repositórios de log e rastreio:
  • [Windows](Windows) logViewer.bat
  • [AIX HP-UX Solaris](Unix - perfil completo) logViewer.sh
  • [AIX HP-UX Solaris](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]Nos sistemas operacionais z/OS nos quais existem diversos processos, você deve fornecer o ID da instância para identificar a partir de qual processo você deseja visualizar logs e rastreio. O ID da instância de um controlador é representado por um valor numérico, enquanto o ID da instância de um servidor é representado por uma combinação de um valor numérico, um nome da tarefa, um ID da tarefa e um ID do processo. Para obter uma lista de IDs da instância válidos, execute o LogViewer com a opção -listInstances.
  • 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

Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_logviewer
Nome do arquivo: rtrb_logviewer.html