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.
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)
#----------------------------------------------------------------------------------------------- # 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
Notas:
com.ibm.ws.http.HttpConnection=entry
Exit=enabled:
com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
Exit=enabled,
event=enabled
com.ibm.ws.http.HttpConnection=entry
Exit=enabled:
com.ibm.ws.webcontainer.srp.ServletRequestProcessor=entry
Exit=enabled,
event=enabled
Nota: Por padrão, ${LOG_ROOT} é WAS_HOME\logs\, em que WAS_HOME é o seguinte:
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
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:
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.
ex 'BBO.SBBOEXEC(BBORBLOG)' 'BBO.BOSSXXXX NOFORMAT'
em que
oput 'myuserid.BBO.BOSSXXXX' '/waserror.log'
oput 'myuserid.WASERROR.LOG' '/waserror.log'
Nota:Os arquivos do log de erros do IBM WebSphere Application Server para z/OS podem ser associados apenas por hora.
# 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
Notas:
# 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
Notas:
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:
- Se a variável de ambiente DB2INSTPROF ou a palavra-chave não estiver definida, as informações serão gravadas no X:\sqllib_dir\DB2INSTANCE, em que x:\sqllib_dir é o caminho especificado na variável de registro DB2PATH ou na variável de ambiente e DB2INSTANCE é o nome do proprietário da instância.
- Se a variável de ambiente DB2INSTPROF ou a palavra-chave estiver definida, as informações serão gravadas no X:\DB2INSTPROF\DB2INSTANCE, em que DB2INSTPROF é o nome do diretório de perfil da instância e DB2INSTANCE é o nome do proprietário da instância.
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
Execute as seguintes etapas:
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:
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:
Execute as seguintes etapas:
Execute as seguintes etapas:
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...)).
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.
<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.
<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.
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
(C) Copyright IBM Corporation 2000, 2005. Todos os Direitos Reservados.