overview of logging in websphere lombardi edition · ibm software group websphere ® support...

19
IBM Software Group ® WebSphere ® Support Technical Exchange Overview of Logging in WebSphere Lombardi Edition Evan Slate ([email protected]) WebSphere Lombardi Customer Support 10 May 2011

Upload: others

Post on 15-Feb-2021

1 views

Category:

Documents


0 download

TRANSCRIPT

  • IBM Software Group

    ®

    WebSphere® Support Technical Exchange

    Overview of Logging in WebSphere Lombardi EditionEvan Slate ([email protected])WebSphere Lombardi Customer Support10 May 2011

    mailto:[email protected]:[email protected]

  • 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