Configurando Aplicativos para Geração de Arquivos de Log

Aplicativos, tais como Apache HTTP Server, IBM WebSphere Application Server, IBM DB2 Universal Database e IBM HTTP Server, podem ser configurados para gerar logs no formato apropriado para análise com os analisadores de logs.

Segue uma lista de configurações de aplicativos que ajudam a formatar logs para que possam ser analisados pelos analisadores fornecidos com as ferramentas.

Nota: Eventos de log que estão contidos nestes arquivos de log podem ser analisados utilizando um banco de dados de análise de sintomas para interpretar eventos conhecidos e condições de erros. Um banco de dados de análise de sintomas é utilizado para localizar informações detalhadas sobre resolução de erros e significância de eventos. Para obter informações adicionais sobre bancos de dados de análise de sintomas e instruções sobre como importar e utilizá-los, consulte os tópicos relacionados no final deste arquivo.

Configuração do Arquivo de Log de Atividades e Rastreio do Apache HTTP Server para iSeries

O arquivo de configuração do Apache é chamado /www/apachedft/conf/httpd.conf no servidor iSeries. Ele deve ter as seguintes diretivas para ativar adequadamente os logs de acessos e erros:

# ErrorLog: The location of the error log file. If this does not start
# with /, ServerRoot is prepended to it.

ErrorLog ./logs/error.log

# LogLevel: Control the number of messages logged to the error.log.
# Possible values include: debug, info, notice, warn, error, crit,
# alert, emerg.

LogLevel warn

# The following directives define some format nicknames for use with
# a CustomLog directive (see below).

LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
LogFormat "%h %l %u %t \"%r\" %>s %b" common
LogFormat "%{Referer}i -> %U" referer
LogFormat "%{User-agent}i" agent

# The location of the access logfile (Common Logfile Format).
# If this does not start with /, ServerRoot is prepended to it.


CustomLog ./logs/access.log common

As duas seções em negrito acima definem onde os logs de erros e acessos do Apache estão localizados, respectivamente. Neste caso, por exemplo, com ServerRoot como /www/apachedft, os logs apareceriam no subdiretório /www/apachedft/logs/ e seriam chamados error.log.* e access.log.*, respectivamente. O sufixo final no nome do arquivo dependerá da data (ou seja, o primeiro error.log. para 31 de dezembro de 2003 pode ser nomeado de algo como Q103123100).

Após alterar o arquivo de configuração do Apache, é necessário reiniciar o servidor Apache para refletir esta alteração. A partir da linha de comandos do OS400, digite STRTCPSVR SERVER(*HTTP) INSTANCE(APACHEDFT)

Por outro lado, a finalização do servidor Apache pode ser feita com o seguinte comando na linha de comandos do OS400: ENDTCPSVR SERVER(*HTTP) INSTANCE(APACHEDFT)

Configuração do Arquivo de Log de Atividades do IBM WebSphere Application Server V4.0

  1. Edite as seguintes entradas no arquivo de configuração de registro <WAS_HOME>\properties\logging.properties:
     #-----------------------------------------------------------------------------------------------
     # Activity Log Properties
     #
     # WARNING Before changing any of the Activity Log properties, all servers on the physical
     # node, including AdminServers must be stopped. 
     #
     # com.ibm.ws.ras.AcvitityLogEnabled : A property used to determine whether or not the servers on 
     # this node will write Ras events to the activity log or not. Valid values are true and false, 
     # with true the default. Turning off this logging may have serious serviceability impacts.
     #
     # com.ibm.ws.ras.ActivityLogSize : Size of the activity log in kilobytes. The default value
     # is 1024, which yields a log size of 1 megabyte. See the Problem Determination guide for
     # guidelines on setting the size of this log.
     #------------------------------------------------------------------------------------------------
    

    com.ibm.ws.ras.ActivityLogEnabled=true
    com.ibm.ws.ras.ActivityLogSize=1024


  2. Salve as alterações no arquivo de configuração.
  3. Reinicie o servidor de aplicativos.

Notas:

Configuração do Arquivo de Log de Rastreio do IBM WebSphere Application Server V4.0 (Administrative Console Independente)

  1. Abra o Administrative Console do IBM WebSphere Application Server.
  2. Selecione WebSphere Administrative Domain (Domínio Administrativo do WebSphere) > Nodes (Nós) > node_name > Application Servers (Servidores de Aplicativos) > server_name > Services (Serviços) > Trace Service (Serviço de Rastreio), em que node_name é o nome do nó e server_name é o nome do servidor para o qual a configuração do log de rastreio será aplicada.
  3. Dê um clique duplo em server_name e escolha a guia Serviços.
  4. Destaque o Serviço de Rastreio e clique em Edit Properties (Editar Propriedades).
  5. Clique em Browse (Procurar) e selecione os grupos ou componentes, ou uma combinação de ambos, para rastrear.
  6. Certifique-se de que os seguintes componentes estão ativados como mostrado abaixo:

    com.ibm.ws.http.HttpConnection=entry
    Exit=enabled:
    com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
    Exit=enabled,
    event=enabled


  7. Clique em OK.
  8. Defina o Trace File (Arquivo de Rastreio) em um caminho de arquivo local.
  9. Clique em OK.
  10. Salve as alterações na configuração.
  11. Reinicie o servidor de aplicativos.

Configuração do Arquivo de Log de Rastreio do IBM WebSphere Application Server V4.0 (Administrative Console com Base em Servlets)

  1. Abra o Administrative Console do IBM WebSphere Application Server.
  2. Selecione Domínio do WebSphere Administrative > Nós > node_name > Servidores de Aplicativos > server_name > Serviço de Rastreio, em que node_name é o nome do nó e server_name é o nome do servidor para o qual a configuração do log de rastreio será aplicada.
  3. Ative a Cadeia de Rastreio e inclua os componentes desejados a serem rastreados.
  4. Certifique-se de que os seguintes componentes estão ativados como mostrado abaixo:

    com.ibm.ws.http.HttpConnection=entry
    Exit=enabled:
    com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
    Exit=enabled,
    event=enabled


  5. Defina o Arquivo de Rastreio em um caminho de arquivo local.
  6. Clique em OK.
  7. Salve as alterações na configuração.
  8. Reinicie o servidor de aplicativos.

Configuração do Arquivo de Log de Atividades do IBM WebSphere Application Server V5.0 ou V6.0

  1. Abra o Administrative Console do IBM WebSphere Application Server.
  2. Selecione Troubleshooting (Resolução de Problemas) > Logs and Trace (Logs e Rastreio) > server_name > IBM Service Logs (Logs de Serviço da IBM), em que server_name é o nome do nó para o qual a configuração do log de atividades será aplicada.
  3. Ative o log de serviços.
  4. Defina o File Name (Nome do Arquivo) para um caminho de arquivo local.
  5. Clique em Apply (Aplicar) ou OK.
  6. Salve as alterações na configuração.
  7. Reinicie o servidor de aplicativos.

Nota: Por padrão, ${LOG_ROOT} é WAS_HOME\logs\, em que WAS_HOME é o seguinte:

Configuração do Arquivo de Log de Rastreio do IBM WebSphere Application Server V5.0 ou V6.0

  1. Abra o Administrative Console do IBM WebSphere Application Server.
  2. Selecione Troubleshooting (Resolução de Problemas) > Logs and Trace (Logs e Rastreio) > server_name > Diagnostic Trace (Rastreio de Diagnóstico), em que server_name é o nome do nó para o qual a configuração do log de rastreio será aplicada.
  3. Ative o Rastreio e inclua a Especificação de Rastreio desejada.
  4. Certifique-se de que os seguintes componentes estão ativados como mostrado abaixo:

    Para V5.0:

    com.ibm.ws.http.HttpConnection=entry
       Exit=enabled:   com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry   Exit=enabled,   event=enabled

    Para V6.0:

    com.ibm.ws.http.HttpConnection=entry
       Exit=enabled:   com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry   Exit=enabled,   event=enabledcom.ibm.ws.http.HttpConnection=finer:com.ibm.ws.webcontainer.srp.ServletRequestProcessor=finer
  5. Defina o Trace Output File (Arquivo de Saída do Rastreio) para um caminho de arquivo local.
  6. Clique em Apply (Aplicar) ou OK.
  7. Salve as alterações na configuração.
  8. Reinicie o servidor de aplicativos.

Nota: Por padrão, ${SERVER_LOG_ROOT} é WAS_HOME\logs\server_name\, em que server_name é o nome do nó para o qual a configuração de log de rastreio será aplicada e WAS_HOME é o seguinte:

Configurando o Tamanho do Arquivo de Log de Rastreio do WebSphere Application Server

  1. Abra o Administrative Console do IBM WebSphere Application Server.
  2. Selecione Troubleshooting (Resolução de Problemas) > Logs and Trace (Logs e Rastreio) > server_name > Diagnostic Trace (Rastreio de Diagnóstico).
  3. Sob Saída de Rastreio, selecione File (Arquivo) e digite o tamanho máximo do arquivo desejado. O tamanho recomendado do arquivo de log de rastreio deve ser menos que 10 MB.
  4. Clique em Aplicar para salvar as alterações.
  5. Reinicie o servidor de aplicativos.

Configuração do Arquivo de Log de Erros do IBM WebSphere Application Server para z/OS

O IBM WebSphere Application Server para z/OS pode ser configurado para gravar eventos do log de erros em um fluxo de log ou no conjunto de dados SYSOUT do job MVS do WebSphere Application Server. Siga as instruções abaixo para copiar os eventos do log de erros para um arquivo que possa ser analisado e importado no Log Analyzer. O Log Analyzer pode analisar e importar arquivos de log de erros das versão 4.0 e 5.0 do WebSphere Application Server para z/OS.

Nota: Os arquivo de log de erros do IBM WebSphere Application Server para z/OS não podem ser importados a partir de conjuntos de dados MVS. Eles devem estar no sistema de arquivos System Services do UNIX

Nota: As horas dos eventos do log de erros são analisadas no padrão de horas GMT. É necessário configurar o WebSphere Application Server para z/OS para gravar horas GMT nos eventos do log de erros. Esta é a configuração padrão. Se ele estiver configurado para gravar a hora local dos eventos do log de erros, as informações de fuso horário mostradas na propriedade creationTime dos eventos do log de erros na Visualização de Log serão incorretas.

Nota:Os arquivos do log de erros do IBM WebSphere Application Server para z/OS podem ser associados apenas por hora.

Configuração do Arquivo de Log de Acessos do IBM HTTP Server V1.3.19.3 para V2.0.42.1

  1. Edite a seguinte entrada no arquivo de configuração do servidor HTTP IHS_HOME\conf\httpd.conf:

       # The location of the access logfile (Common Logfile Format).
    # If this does not start with /, ServerRoot is prepended to it.
       CustomLog logs/access.log common
  2. Salve as alterações no arquivo de configuração.
  3. Reinicie o HTTP Server.

Notas:

Configuração do Arquivo de Log de Erros do IBM HTTP Server V1.3.19.3 para V2.0.42.1

  1. Edite a seguinte entrada no arquivo de configuração do servidor HTTP IHS_HOME\conf\httpd.conf:
       # ErrorLog: The location of the error log file. If this does not start
    # with /, ServerRoot is prepended to it.
       ErrorLog logs/error.log
    # LogLevel: Control the number of messages logged to the error.log.
       # Possible values include: debug, info, notice, warn, error, crit, alert, emerg. 
    LogLevel warn
    
  2. Salve as alterações no arquivo de configuração.
  3. Reinicie o HTTP Server.

Notas:

Configuração do Arquivo de Log de Diagnóstico do IBM DB2 Universal Database V8.1 a V8.2

A configuração padrão de DB2 grava todas as mensagens de erro e de aviso em um arquivo de log chamado db2diag.log. Este arquivo encontra-se no seguinte local:

Para ambientes suportados por Windows:

Para ambientes baseados em UNIX: INSTHOME/sqllib/db2dump, em que INSTHOME é o diretório home do proprietário da instância.

A variável DIAGPATH, especificada na configuração do gerenciador do banco de dados, fornece o caminho completo para o diretório de armazenamento de FFDC (Captura de Dados da Primeira Falha). O valor padrão para DIAGPATH é uma cadeia nula. Para alterar o valor DIAGPATH, utilize o seguinte comando:

DB2 UPDATE DBM CFG USING DIAGPATH path

Verificando o Nível Atual da Captura de Erros de Diagnósticos

Execute as seguintes etapas:

  1. Abra uma janela de comandos do DB2.
  2. Digite
    db2 get dbm cfg
  3. Leia o valor de "Nível da captura de erros dos diagnósticos (DIAGLEVEL)".

Configurando a Quantidade de Informações Gravadas como Eventos

A quantidade de informações que estão sendo gravadas no arquivo de log de diagnóstico (db2diag.log) pode ser configurada pelas seguintes etapas:

  1. Abra uma janela de comandos do DB2.
  2. Digite:
    db2 update dbm cfg using DIAGLEVEL [level]
    em que [level] é o valor que controla a quantidade de informações a serem gravadas. O valor padrão é 3. Os valores válidos e seus significados são os seguintes:
    0 = Nenhum dado de diagnóstico capturado
    1 = Apenas erros graves
    2 = Todos os erros
    3 = Todos os erros e avisos
    4 = Todos os erros, avisos e mensagens informacionais
  3. Se o valor for atualizado, a alteração terá efeito imediatamente.

Configuração do Arquivo de Log de Rastreio JCC do IBM DB2 Universal Database V8.1.2 ou V8.2 (Aplicativo da Web em Execução no WebSphere Application Server)

O Administrative Console do WebSphere Application Server permite configurar como as informações relacionadas ao JDBC são gravadas como eventos. Há duas maneiras de gravar eventos de mensagens no log do JCC:

  1. Direcione todas as mensagens JCC para o arquivo de log de rastreio do WAS V5.0.
  2. Direcione todas as mensagens JCC para um arquivo de log separado.

Direcionando Mensagens JCC para o Arquivo de Rastreio do WAS V5.0

Execute as seguintes etapas:

  1. Abra o Administrative Console do IBM WebSphere Application Server V5.0.
  2. Selecione Troubleshooting (Resolução de Problemas) > Logs and Trace (Logs e Rastreio) > server_name > Diagnostic Trace (Rastreio de Diagnóstico).
  3. Clique no botão Modify (Modificar) sob Trace Specification (Especificação de Rastreio). Uma janela é aberta.
  4. Sob a guia Grupos, certifique-se de que os seguintes grupos estão selecionados:
    1. WAS.database
    2. WAS.j2c
    3. RRA
  5. Clique no botão Apply (Aplicar). A janela é fechada.
  6. Clique em Apply (Aplicar) na guia Configuração da janela principal.
  7. Salve as alterações na configuração.
  8. Selecione Resources (Recursos) > JDBC Providers (Provedores JDBC) > DB2 Universal JDBC Driver Provider (Provedor de Driver JDBC do DB2 Universal) > Data Sources (Origens de Dados) > data_source_name > Custom Properties (Propriedades Personalizadas).
  9. Na tabela Custom Properties (Propriedades Personalizadas), certifique-se de que a propriedade traceFile não esteja definida.
  10. Se um nome de arquivo estiver especificado sob traceFile, clique em traceFile. Remova o texto no campo Valor e clique em OK.
  11. Salve as alterações nas propriedades personalizadas.
  12. Reinicie o servidor de aplicativos.

Direcionando Mensagens JCC para um Arquivo de Log Separado

Execute as seguintes etapas:

  1. Abra o Administrative Console do IBM WebSphere Application Server V5.0.
  2. Selecione Troubleshooting (Resolução de Problemas) > Logs and Trace (Logs e Rastreio) > server_name > Diagnostic Trace (Rastreio de Diagnóstico).
  3. Clique no botão Modify (Modificar) sob Trace Specification (Especificação do Rastreio). Uma janela é aberta. Sob a guia Grupos da janela pequena, certifique-se de que o grupo RRA esteja selecionado.
  4. Clique no botão Apply (Aplicar). A janela é fechada.
  5. Clique em Apply (Aplicar) na guia Configuração da janela principal.
  6. Salve as alterações na configuração.
  7. Selecione Resources (Recursos) > JDBC Providers (Provedores JDBC) > DB2 Universal JDBC Driver Provider (Provedor de Driver JDBC do DB2 Universal) > Data Sources (Origens de Dados) > data_source_name > Custom Properties (Propriedades Personalizadas).
  8. Sob a coluna Name (Nome) da tabela Custom Properties (Propriedades Personalizadas), clique em traceFile.
  9. Digite o caminho absoluto do arquivo de rastreio no campo Value (Valor) e clique em OK.
  10. Sob a coluna Name (Nome) da tabela Custom Properties (Propriedades Personalizadas), clique em traceLevel.
  11. Digite o valor de traceLevel apropriado no campo Value (Valor). Os possíveis níveis de rastreio e seus significados estão documentados na propriedade Description (Descrição), log abaixo do campo Value (Valor).
  12. Clique em OK.
  13. Salve as alterações nas propriedades personalizadas.
  14. Reinicie o servidor de aplicativos.

Configuração do Arquivo de Log de Rastreio JCC do IBM DB2 Universal Database V8.1.2 ou V8.2 (Aplicativo Independente)

Para a conectividade do JDBC 2 a partir da origem de dados, utilize os métodos setLogWriter() e setTraceLevel() no objeto com.ibm.db2.jcc.DB2SimpleDataSource. Estes métodos ativam completamente o nível de rastreio padrão.

É possível ativar o rastreio do JDBC 1 com o gerenciador de drivers java.sql.DriverManager.setLogWriter() ou, como alternativa, um traceFile pode ser incorporado em uma URL do banco de dados do JDBC 1.
Por exemplo:
String databaseURL = "jdbc:db2://hal:50000/sample:traceFile=c:/temp/foobar.txt;traceLevel=" + (com.ibm.db2.jcc.DB2BaseDataSource.TRACE_DRDA_FLOWS | com.ibm.db2.jcc.DB2BaseDataSource.TRACE_CONNECTS) + ";";


 

Tanto para a conectividade JDBC 1 como para JDBC 2, é possível ativar e desativar o rastreio em uma conexão utilizando o método proprietário DB2Connection.setJCCLogWriter(java.io.PrintWriter logWriter, int traceLevel). Também é possível utilizar este método para alterar o gravador de logs ou ajustar o nível de rastreio em uma conexão ativa. Se você utilizar o método padrão javax.sql.DataSource.setLogWriter(java.io.PrintWriter logWriter), o nível de rastreio padrão (ativado completamente) é utilizado. É possível desativar o rastreio definindo o gravador de logs como nulo.

Para obter maiores detalhes sobre a criação de informações de rastreio para o driver Universal JDBC, consulte a documentação DB2.

Após concluir qualquer um dos conjuntos de tarefas acima, esse arquivo de log em específico pode ser importado em seu produto (File (Arquivo) > Import (Importar...)).

Configuração do Arquivo de Log de Atividades e Rastreio do IBM WebSphere Application Server para iSeries

O IBM WebSphere Application Server para iSeries permite múltiplas instâncias de servidor, cada uma com sua própria configuração. O subdiretório onde a instância é definida dependerá da versão do IBM WebSphere Application Server instalado no servidor e do nome da instância do servidor.

Por exemplo, se você desejava visualizar as definições de registro em uma máquina iSeries executando o IBM WebSphere Application Server Express V5.0 para uma instância de servidor chamada default, o arquivo server.xml seria armazenado na seguinte localização:

/QIBM/UserData/WebASE/ASE5/default/config/cells/myhostname/nodes/mynodename/servers/server1/server.xml. 

Este arquivo server.xml contém as especificações para registro.

  1. Ativar a geração do log de atividades.
    O registro de atividade é ativado por padrão, na seguinte cláusula:
    <services xmi:type="loggingservice.ras:RASLoggingService" xmi:id="RASLoggingService_1" enable="true" messageFilterLevel="NONE" enableassociationId="true">
    <serviceLog xmi:id="ServiceLog_1" name="${LOG_ROOT}/activity.log" size="2" enabled="true"/>
    </services>
    

    O log de atividades (de acordo com o exemplo acima) apareceria no arquivo /QIBM/UserData/WebASE/ASE5/default/logs/activity.log.

  2. Ativar o log de rastreio do IBM WebSphere Application Server.
    O registro de rastreio não é ativado por padrão. Pode ser necessário editar o arquivo server.xml para ativar o rastreio incluindo as 3 linhas a seguir:
    <services xmi:type="traceservice:TraceService" xmi:id="TraceService_1" enable="true" startupTraceSpecification="com.ibm.ws.http.HttpConnection=entryExit=enabled:com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entryExit=enabled,event=enabled" traceOutputType="SPECIFIED_FILE" traceFormat="BASIC" memoryBufferSize="8">
    <traceLog xmi:id="TraceLog_1" fileName="${SERVER_LOG_ROOT}/trace.log" rolloverSize="20" maxNumberOfBackupFiles="1"/>
    </services>
    

    De acordo com o exemplo acima, isto criará um log de rastreio no arquivo /QIBM/UserData/WebASE/ASE5/default/logs/server1/trace.log.

  3. Parando e reiniciando a instância do IBM WebSphere Application Server para consolidar as alterações
    Isto pode ser realizado a partir da linha de comandos ou no console de administração do IBM WebSphere Application Server. Para parar o servidor a partir da linha de comandos, os seguintes comandos devem ser emitidos a partir do interpretador QShell do iSeries. 1. Mude o diretório atual para o diretório bin do IBM WebSphere Application Server aplicável 2. Pare o servidor
    stopServer -instance default

    3. Reinicie o servidor

    startServer -instance default

Conceitos Relacionados
Determinando Problemas em Aplicativos Distribuídos Utilizando o Log and Trace Analyzer
Bancos de Dados de Análise de Sintomas AC (Autonomic Computing)

Tarefas Relacionadas
Importando um Arquivo de Log
Importando e Utilizando um Banco de Dados de Análise de Sintomas AC