Logging Tivoli Performance Viewer data using scripting

You can use the wsadmin tool to start and stop Tivoli® Performance Viewer logging in your environment.

About this task

Tivoli Performance Viewer provides an easy way to store real-time data for system resources, WebSphere® Application Server pools and queues, application-related statistics, and others in log files for later retrieval. The wsadmin tool helps you start and stop logging using the command line. You can use the command line to start and stop Tivoli Performance Viewer logging.

The following task assumes that you are using Jython script.

Procedure

  1. Start the wsadmin scripting tool.
  2. Import the UserPreferences and jarray.
    import com.ibm.ws.tpv.engine.UserPreferences
    import jarray 
  3. Identify the server where you want logging to be started, and assign it to the following variable:
    tpvName = AdminControl.completeObjectName("type=TivoliPerfEngine,*")
    tpvName = AdminControl.makeObjectName(tpvName)
  4. Create a UserPreferences object.
    pref = com.ibm.ws.tpv.engine.UserPreferences()
    pref.setServerName("server1")
    pref.setNodeName("mynode")
    pref.setLogFileName("tpv_log_1")
    pref.setUserId("user") 
  5. Create the necessary arguments and invoke monitorServer action on the Tivoli Performance Viewer MBean.
    list_p = java.util.ArrayList()
    list_p.add(pref)
    params=jarray.array(list_p,java.lang.Object)
    
    list_s = java.util.ArrayList()
    list_s.add("com.ibm.ws.tpv.engine.UserPreferences")
    sigs = jarray.array(list_s,java.lang.String)
    
    print "--- TPV Calling monitorServer ---"
    AdminControl.invoke_jmx(tpvOName, "monitorServer", params, sigs)
  6. When you want to start logging, call the following operation:
    print "--- TPV Calling startLogging ---"
    AdminControl.invoke_jmx(tpvOName, "startLogging", params, sigs)
  7. When you want to stop logging, call the following operation:
    print "--- TPV : Now Stop Logging ---"
    AdminControl.invoke_jmx(tpvOName, "stopLogging", params, sigs)

What to do next

By default, the log files are stored in the profile_root/logs/tpv directory on the node on which the server is running. Tivoli Performance Viewer automatically compresses the log file when it finishes writing to it to conserve space. At this point, there must only be a single log file in each .zip file and it must have the same name as the .zip file. Complete the following steps to view the log files:

  1. Click Monitoring and Tuning > Performance Viewer > View Logs in the navigation tree.
  2. Select a log file to view using either of the following options:
    • Explicit path to a log file

      Choose a log file from the machine on which the browser is currently running. Use this option if you have created a log file and transferred it to your system. Click Browse to open a file browser on the local machine and select the log file to upload.

    • Server file
      1. Specify the path of a log file on the server.
      2. In a deployment management environment, click the Browse button next to the input to browse the various nodes and find the log file to view.
      3. Click View Log. The view will display the log with log control buttons.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 5, 2017 17:30
File name: txml_loggingtpvdata.html