Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

If either your Confluence instance or your Jira instance fall into the above version range, you need to apply the official patches to both systems in order for the Trusted Applications link to work properly. For example, patching only Jira but not Confluence can lead to the above PermissionException errors, and it is , likely that , other parts of the Application Link will not work correctly either.

...

When using Dataplane Reports gadgets in Confluence, why am I getting HTTP 504 timeout errors?

This is caused by Confluence's short default By default, Confluence has a short timeout when making HTTP HHTP requests to Jira from a Confluence macro. The default timeout in Confluence 6+ . x and above is only 5 seconds , and in Confluence 5. x and below it is 15 seconds.

To solve the problem, edit the JVM system parameters for Confluence. For Linux installations, this is done by editing the CATALINA_OPTS variable in $JIRA_HOME/bin/setenv.sh. For Windows installations, follow Atlassian's documentation on editing JVM system parameters.

...

you change the default settings in your instance.

How to change the timeout settings

  1. In your Confluence instance, click on the settings icon Image Added.
  2. In Configuration, select General Configuration.
  3. In Connection Timeouts, select Edit to adjust the settings.

If the problem persists, you need to edit the JVM system parameters for Confluence.

Editing the JVM parameter - Linux

  1. Go to $JIRA_HOME/bin/setenv.sh
  2. Edit the CATALINA_OPTS variable.
  3. For Confluence 6 and above, add the following parameter to CATALINA_OPTS:

    -Datlassian.

...

  1. HTTP.connection.timeout=60000

    For Confluence 5. x and below, add the following parameter to CATALINA_OPTS:

    -Dhttp.socket.timeout=60000

Timeout parameter values are in milliseconds, so the above change sets the HTTP timeout to 60 seconds (60,000 ms). If your longest-running Dataplane reports require more time, adjust this value accordingly. 

For Windows installations, follow Atlassian's documentation on editing JVM system parameters.

If you're running Confluence Data Center, do ensure to add this parameter in all of your Confluence nodes're running Confluence Data Center, do ensure to add this parameter in all of your Confluence nodes.

Info

Confluence's Administration » General Configuration page has settings that would appear to change the applicable HTTP timeout, however, due to Confluence bug CONFSERVER-51594 Confluence gadget macros ignore these settings. For more details, see this Atlassian Knowledge Base article. You must instead use the JVM parameters listed below.



When using Dataplane Reports gadgets in Confluence, why is the gadget blank or cannot be configured?

...

To fix this, adjust Confluence's default HTTP timeout as described above in When using Dataplane gadgets in Confluence, why am I getting HTTP 504 timeout errors?.

...

If you are using Jira 5.1 through 6.2.4 inclusive, a Jira bug (JRA-29795) requires that you disable Jira's built-in gzip compression feature in order to use the Dataplane gadget in Confluence. Jira 5.0.x and Jira 6.2.5+ are not impacted.

Atlassian already recommends disabling gzip compression if you are using Jira behind an Apache httpd server with mod_proxy, and they indicate that you may actually experience a performance gain by turning it off.

To disable gzip compression, access the Jira administration panel and select System » General Configuration » Edit Configuration, and then disable the "Use gzip compression" feature. Failure to disable Jira's gzip compression will result in Dataplane gadgets failing to display in Confluence.

...

Some customers have reported issues with the Application Links configuration when one application is configured to connect over regular HTTP, but the other application is configured to connect over HTTPS, and that this problem is not specific to Dataplane. Ensuring that both Confluence and Jira use the same protocol may make it easier to set up a working application link.

...

...

The most common reason for this is, that after adding a new custom field to Jira that is supported by Dataplane Reports, you must:

...

  1. your custom field may not be in the list of Dataplane's Supported Jira Fields, including supported third-party app custom fields.
  2. your custom field may be supported by Dataplane, but not in the context in which you are trying to use it in a Dataplane report. For example, historical reports like the Issues Value by Date Report, support a different set of fields than reports based only on an issue's current field values, since not all Jira fields are indexed historically by Dataplane. Additionally, only numeric fields can be used in Dataplane report configuration options that require a numeric value, as with the Value option in the Sum Numeric Field by Date Report.

Calculations and Values

When reporting on time durations, are the calculated total, average, max, and min times adjusted for non-working hours?

No. All reports that include time duration statistics—such as the Closure Time Report, Time in Status Report, or the Sum Numeric Field Report—currently use a raw calculation of hours that makes no consideration for non-working hours.

...

...

What does Sync Index do and when is it necessary?

In order to To provide high performance historical reporting, Dataplane Reports builds and maintains its own optimized index of every change made to the issues in your Jira instance. Once Dataplane's index is built—after initial installation, on upgrade, or after manually clicking the Build Index button in Dataplane Administration—all subsequent issue changes in your Jira instance are tracked by Dataplane in realtimereal time.

There are a couple unconventional situations, however, where Dataplane's index of the state of your Jira instance may not be completely up-to-date: 

...