All eazyBI for Jira eazyBI for Confluence Private eazyBI

Troubleshooting
eazyBI for Jira eazyBI for Confluence

On this page:

Installation

Jira issues import

  • If the import fails with errors, then please send us all eazyBI log files or eazybi-queues.log file. 

  • If the import is very slow, check recommended database memory settings (for MySQL and PostgreSQL).
  • If not all Jira issues are visible in eazyBI, then see how to re-import all issues. You also need to re-import all issues if any dimension members (for example, statuses, priorities, or custom field select list values) are renamed. You would like to see new names in eazyBI.
  • Some data problems might not stop the import, but they will display in the warning message for the import status. The warnings remain visible to the user until dismissed manually. If you see such a warning, check if you can fix the data, dismiss the warning and rerun the import to have all your data imported.
  • If you are importing issues into Jira from an external system, please ensure that the issue update date is set to the current date timestamp. If issues are imported with the old update date (before the last eazyBI Jira import timestamp), then eazyBI incremental import will consider these issues as already imported.

Import error notification email

If the scheduled data import fails with an error, eazyBI would automatically try to reimport data after 10 minutes and repeat these attempts nine more times. After the 10th unsuccessful import attempt, a notification email would be sent to the eazyBI account's owner and the user who authorized data import from Jira. If eazyBI can not detect the owner or authorized import user, the notification will be sent to the technical contact who is registered for the eazyBI app license. 

eazyBI log files

eazyBI stores its log files in the Atlassian product (Jira or Confluence) home directory log subdirectory. You can find the home directory location in the Jira or Confluence Administration section:

  • Jira: Jira Administration / System / System info page and see Location of Jira Shared Home.
  • Confluence: Confluence Administration / System Information page and see Confluence Home.

On the server, in the home directory, look for the eazyBI log files:

  • eazybi-web.log contains the log of web requests
  • eazybi-queues.log contains the log of background queue jobs
  • If the child process is enabled, then there will also be child process log files.

You can download a ZIP archive with all eazyBI logs from the Troubleshooting page as well.

If you have enabled Mondrian logging - Mondrian log files won't be included in the ZIP archive because of their possible huge size. You can access Mondrian log files only directly in the file system.

Reports

  • If queries in the Analyze tab are failing with an error message, find the error in System Events and send Payload column content to eazyBI support.

  • If there are problems with measures containing Unicode characters, then check that UTF-8 encoding is used for Jira.

HAR file

HAR is the short form for HTTP ARchive format, which tracks all the logging of a web browser's interaction with a site.

HAR files can be a requirement for troubleshooting issues, specifically for problems listed below:

  • Performance Issue: slow page load, a timeout when performing a certain task
  • Page rendering: incorrect page format, missing information

First-line troubleshooting can be conducted by following this guide. Providing this information to the support team will help expedite the troubleshooting process.

  1. Open problematic page
  2. Open Developer Tools using Keyboard Shortcut (⌘⌥ + i on OS X, Ctrl + Shift + i on Linux, F12 on Windows)
  3. Navigate to the Network tab on the Developer Tools
  4. Reload problematic page so that all network traffic is recorded
  5. Right-click on the Developer Tools and Select Save as HAR with content

Send us a generated HAR file.

 

Please read about HAR files for other browsers here.