Using logging to diagnose a problem for a specific user

You can use logs to diagnose a problem that is occurring for one or more specific users.

You temporarily set logging to occur for the specified users only. After the problem is resolved, you disable the user-specific logging and resume normal logging without interfering with existing logging settings.

You enable and disable logging for specific users by using the Remote Process service for Java™ Management Extensions (JMX), a technology that supplies tools to manage and monitor applications and service-oriented networks. You connect to the JMX Remote Process service using the jconsole executable that is provided with the Java JDK. By default, output from the user-specific logging is saved in the c10_location\logs directory.

Before you begin

You must first enable user-specific logging for IBM® Cognos® Business Intelligence. For more information, see the IBM Cognos Business Intelligence Installation and Configuration Guide.

Procedure

  1. Connect to the JMX Remote Process service by launching the jconsole executable and specifying the following information:
    • The URL to connect to the data. For example,

      service:jmx:rmi://Content_Manager_server/jndi/rmi://monitoring_server:<JMXport>/proxyserver

      where JMXport is the value from External JMX port in IBM Cognos Configuration, and Content_Manager_server and monitoring_server are computer names. Do not use the name localhost, even if connecting locally.

    • The user ID and password to secure the connection.
    • The values from External JMX credential in IBM Cognos Configuration.
  2. In the remote process server connection window, expand com.cognos, Metrics, camAsyncAA, http://c10_server_name:port_number/p2pd and select the Operations node.
  3. Copy the user's CAMID into the enableDyeTrace field and click the enableDyeTrace button.
    Tip: In IBM Cognos Administration, you can find the CAMID by doing the following:
    • Click the Security tab and then click Users, Groups, and Roles.
    • Click Set properties for the user and then click View the search path, ID and URL

    You must have the required permissions to access IBM Cognos Administration. For more information, see Secured Functions and Features.

  4. To verify that you enabled the user correctly, navigate to Attributes and view the contents of the DyeTracedUsers setting.