Enabling diagnostic logging for Java dumps

You can enable diagnostic logging for Java dumps.

Procedure

  1. Go to Manage > Configuration > Diagnostic logging.
  2. On the Built-in topics tab, select the Show all check box.
  3. Select the JAVA_DUMP topic.
  4. Click the More icon More icon and then select Download topic.
  5. Create a customized JAVA_DUMP.json file:
    1. Open the downloaded JAVA_DUMP.json in a text editor.
    2. Edit the sections Logger definitions and dumpDescription, as required, to customize the information that you want to capture.
    3. Save your changes.
  6. Enable your custom JAVA_DUMP.json file for your Cognos Analytics environment.
    1. In the Diagnostic logging panel, Select the Custom topics tab.
    2. Click the Upload topic icon Upload topic icon.
    3. Navigate to the JAVA_DUMP.json file that you modified and then click Open.

      The file is uploaded to Cognos Analytics and JAVA_DUMP appears in the Custom topics list.

    4. Click Apply.

      This message appears:

      Successfully enabled topic JAVA_DUMP.

  7. Go to installation_location/configuration/data/logging and open the file dump_rules.properties in a text editor and view the content.
    Tip: This file was created when you enabled your customized JAVA_DUMP file and contains the customizations that you set.
    Note: When a Java dump occurs, it can take a few minutes. After it finishes, two files are produced:
    • installation_location/bin64/core.core_id.dmp
    • installation_location/bin64/heapdump.heapdump_id.phd
  8. Analyze the .dmp and .phd files that were generated by a core dump, as necessary.
  9. When you are done, restore the JAVA_DUMP.json file used by Cognos Analytics to its default version:
    1. Select the Built-in topics tab and then select AAA.
    2. Click Reset.
    3. Select AAA again and then click Apply.
  10. To remove your custom JAVA_DUMP topic, follow these steps:
    1. Select the Custom topics tab and then select JAVA_DUMP.
    2. Click the More icon More icon and click Delete.
    3. Click OK to confirm the deletion and click Apply.