overview of logging in websphere lombardi edition · ibm software group websphere ® support...
TRANSCRIPT
-
IBM Software Group
®
WebSphere® Support Technical Exchange
Overview of Logging in WebSphere Lombardi EditionEvan Slate ([email protected])WebSphere Lombardi Customer Support10 May 2011
-
IBM Software Group
WebSphere® Support Technical Exchange 2 of 19
Agenda
IntroductionOverview of log types and locationsConfiguring logging with log4jLog gathering suggestionsQuestions
-
IBM Software Group
WebSphere® Support Technical Exchange 3 of 19
Log levels in order ofmost to least verbose:
DEBUG
INFO
WARN
ERROR
FATAL
Lombardi7/process-center/logs
-
IBM Software Group
WebSphere® Support Technical Exchange 4 of 19
Example tw-error.log entry:
2011-01-11 12:37:14,995 [WebContainer : 7] ERROR ^-- timestamp ^-- thread ID ^-- log level
-
IBM Software Group
WebSphere® Support Technical Exchange 5 of 19
Lombardi7/process-center/logs/server1
Lombardi7/process-center/logs/twprocsvr
-
IBM Software Group
WebSphere® Support Technical Exchange 6 of 19
Lombardi7/performance-data-warehouse/logs
Lombardi7/performance-data-warehouse/logs/twperfsvr
-
IBM Software Group
WebSphere® Support Technical Exchange 7 of 19
Authoring Environment Log
-
IBM Software Group
WebSphere® Support Technical Exchange 8 of 19
SystemOut.log example:[6/24/09 17:21:07:125 PDT] 0000000a ServiceLogger I com.ibm.ws.ffdc.IncidentStreamImplinitialize FFDC0009I: FFDC opened incident stream file
FFDC exception log naming scheme:_exception.log
FFDC incident stream naming scheme:___.txt(e.g. twprocsvr_75f775f7_11.04.07_20.43.04.9114252834085550166299.txt)
http://wpcertification.blogspot.com/2009/06/understanding-ffdc-tool.html
http://wpcertification.blogspot.com/2009/06/understanding-ffdc-tool.html
-
IBM Software Group
WebSphere® Support Technical Exchange 9 of 19
Logs to check for installation issues:
http://www-01.ibm.com/support/docview.wss?rs=180&context=SSCLPLY&q1=mustgather&uid=swg21439995&loc=en_US&cs=utf-8&lang=en
--/IBM_WebSphere_Lombardi_Edition_InstallLog.logInstallAnywhere log
--/wle_install.logWLE install logfile capturing the steps to install WLE. Helpful to pinpoint what installation step is causing the problem (e.g. Application Server, database, configuration, data initialization)
--/AppServer/logsInstallation logs for WebSphere Application Server
http://www-01.ibm.com/support/docview.wss?rs=180&context=SSCLPLY&q1=mustgather&uid=swg21439995&loc=en_US&cs=utf-8&lang=enhttp://www-01.ibm.com/support/docview.wss?rs=180&context=SSCLPLY&q1=mustgather&uid=swg21439995&loc=en_US&cs=utf-8&lang=enhttp://www-01.ibm.com/support/docview.wss?rs=180&context=SSCLPLY&q1=mustgather&uid=swg21439995&loc=en_US&cs=utf-8&lang=en
-
IBM Software Group
WebSphere® Support Technical Exchange 10 of 19
Log4j appender
Log4j category
Logging is customized via log4j.xml in: process-center/config
-
IBM Software Group
WebSphere® Support Technical Exchange 11 of 19
Log4j example: Diagnosing an import issue.
Appender:
Category:
Technote with JSP to determine log4j settings:http://www-01.ibm.com/support/docview.wss?uid=swg21439607
http://www-01.ibm.com/support/docview.wss?uid=swg21439607
-
IBM Software Group
WebSphere® Support Technical Exchange 12 of 19
General configuration:http://www-01.ibm.com/support/docview.wss?uid=swg21439659
Looper logging configuration:http://www-01.ibm.com/support/docview.wss?uid=swg21439711
Security logging configuration:http://www-01.ibm.com/support/docview.wss?uid=swg21439600
http://www-01.ibm.com/support/docview.wss?uid=swg21439659http://www-01.ibm.com/support/docview.wss?uid=swg21439711http://www-01.ibm.com/support/docview.wss?uid=swg21439600
-
IBM Software Group
WebSphere® Support Technical Exchange 13 of 19
RollingFileAppender
Gives you:
tw-error.log…………………………..31Ktw-error.log.1………………………100Ktw-error.log.2………………………100K…
-
IBM Software Group
WebSphere® Support Technical Exchange 14 of 19
More useful--tw-eventmgr.logThis will record events related to the Event Manager.--tw-expimp.logExport/Import log. Records events related to exporting, importing, and deploying Process Apps.--tw-inbound_webservices.log and tw-outbound_webservices.logThese record information related to webservice calls. The inbound log records calls from external systems to WLE when WLE is hosting the webservice. The outbound log records call from Teamworks to webservices hosted by external systems.--tw-security.logAll information related to authentication.--tw-ucaexecution.logRelated to UCA execution.
Less useful--tw-bpd-engine.logRecords errors generated as a result of process instance execution.--tw-javascript.logThis records anything related to javascript logging functions. Primarily, this will log anything that is specified in a server script componentusing log.debug() or log.error(), for example.--tw-limit.logThis log reports process server limit overruns. I think it would be very rare that you would consult this log. There are 5 limits that are configuredin 99Local.xml. They are all set to -1, or unlimited, by default so I suppose this is why I've never seen this log above 0K.--tw-portal.logAnything related to the portal app, such as saved search queries.--tw-process-timing.logI haven't ever seen this written to. My best guess is that it could log entries to help determine how long processes are taking to execute.It's level is set to WARN by default so we would not expect many, if any, messages here.--tw-scheduler.logMessages related to the scheduler, the inner machine of the Event Manager that allows for guaranteed scheduled execution of code. It is usedanytime a UCA is invoked, and for processing BPD notifications, BPD system lane activities, and BPD timer events.--tw-sql.logAs of 7.2, this is where spring logging occurs.--tw-trace.log--tw-webapi.logAnything related to the TW WebAPI.--axis.logWLE uses Axis to make webservice calls but you will rarely EVER see anything logged in here.
-
IBM Software Group
WebSphere® Support Technical Exchange 15 of 19
Best practice for narrowing down logs to find a specific problem:
1. Stop all servers in the environment.2. Delete the existing logs. (Back up if necessary)3. Start the servers.4. Reproduce the problem and record the time.5. Search resulting logs for your appropriate timestamp.
This gives you a much cleaner set of logs to review.
Log Gathering steps:http://www-01.ibm.com/support/docview.wss?uid=swg21440086
http://www-01.ibm.com/support/docview.wss?uid=swg21440086
-
IBM Software Group
WebSphere® Support Technical Exchange 16 of 19
Summary
Understanding which logs to review saves timeConfigure logging via log4j in order to: Enhance logging for a specific problem Minimize the performance impact that logging operations have on a server Control how long logs are retained
-
IBM Software Group
WebSphere® Support Technical Exchange 17 of 19
Additional WebSphere Product ResourcesLearn about upcoming WebSphere Support Technical Exchange webcasts, and access previously recorded presentations at:http://www.ibm.com/software/websphere/support/supp_tech.html
Discover the latest trends in WebSphere Technology and implementation, participate in technically-focused briefings, webcasts and podcasts at:http://www.ibm.com/developerworks/websphere/community/
Join the Global WebSphere Community: http://www.websphereusergroup.org
Access key product show-me demos and tutorials by visiting IBM® Education Assistant:http://www.ibm.com/software/info/education/assistant
View a webcast replay with step-by-step instructions for using the Service Request (SR) tool for submitting problems electronically:http://www.ibm.com/software/websphere/support/d2w.html
Sign up to receive weekly technical My Notifications emails:http://www.ibm.com/software/support/einfo.html
http://www.ibm.com/software/websphere/support/supp_tech.htmlhttp://www.ibm.com/developerworks/websphere/community/http://www.ibm.com/developerworks/websphere/community/http://www.ibm.com/developerworks/websphere/community/http://www.websphereusergroup.org/http://www.websphereusergroup.org/http://www.websphereusergroup.org/http://www.ibm.com/software/info/education/assistanthttp://www.ibm.com/software/websphere/support/d2w.htmlhttp://www.ibm.com/software/support/einfo.htmlhttp://www.ibm.com/software/support/einfo.html
-
IBM Software Group
WebSphere® Support Technical Exchange 18 of 19
We Want to Hear From You!
Tell us about what you want to learn
Suggestions for future topicsImprovements and comments about our webcasts
We want to hear everything you have to say!
Please send your suggestions and comments to: [email protected]
mailto:[email protected]
-
IBM Software Group
WebSphere® Support Technical Exchange 19 of 19
Questions and Answers
Slide 1AgendaSlide 3Slide 4Slide 5Slide 6Slide 7Slide 8Slide 9Slide 10Slide 11Slide 12Slide 13Slide 14Slide 15SummaryAdditional WebSphere Product Resources We Want to Hear From You! Tell us about what you want to learn Suggestions for future topics Improvements and comments about our webcasts We want to hear everything you have to say! Please send your suggestions and comments to: [email protected] 19