Jira Product Discovery integration for Jira Data Center

The Jira Product Discovery integration for Jira Data Center app connects Jira Data Center work items with Jira Product Discovery ideas. This integration allows you to view work tracked in a Jira Data Center instance from a discovery space, ensuring a seamless transition to development while maintaining a clear link between discovery and delivery.

Get a Jira Product Discovery Premium plan

The Jira Product Discovery integration for Jira Data Center app is free to use with Jira Data Center. However, you need a Jira Product Discovery Premium plan to link Jira Data Center with Jira Product Discovery.

To get a Jira Product Discovery Premium plan, you can:

Start a free trial directly from the Jira Product Discovery pricing page if you’re a new customer
Add Jira Product Discovery through admin.atlassian.com if you’re already on Cloud
Upgrade to a Premium plan through admin.atlassian.com or by contacting your Atlassian account manager if you’re already a Jira Product Discovery customer

はじめる前に

You must use Jira Data Center 10.3 or newer to use the app. Jira Data Center 10.3.10 is required for the idea panel integration to work correctly.
You must be a site admin for both the Jira Data Center instance and the Jira Product Discovery site.
You must enable work item linking in your Jira Data Center.
(Optional) You need org admin access for the cloud site to set up application tunnels if your instance is behind a firewall.
If you’re using application tunnels, a single Jira Data Center instance can link to only one Jira Product Discovery site, and vice versa. This limitation doesn’t apply to application links.
Your Jira Product Discovery site must be on a Premium plan.
Users working with this integration app need access to both Jira Data Center and Jira Product Discovery sites.

Install the integration app

(Optional) Follow the steps to connect to Data Center instances with application tunnels if your instance is behind a firewall.
Install the Jira Product Discovery integration for Jira Data Center app on the Jira Data Center instance.
Follow the steps to create an application link between Jira Data Center and Jira Product Discovery. Note that if you use application tunnels, you can only set up application links from the Jira Product Discovery side.

ユーザーとして認証

Before using the Jira Product Discovery integration for Jira Data Center app, your users must perform OAuth cross-authentication between their Jira Data Center and Jira Product Discovery accounts. Explore more information about OAuth authentication.

統合を使用する

Once an admin has configured the integration app, users can easily create or link existing Jira Data Center work items from Jira Product Discovery.

はじめる前に

If you’re using application tunnels, a single Jira Data Center instance can link to only one Jira Product Discovery site, and vice versa. This limitation doesn’t apply to application links.
Jira Data Center の作業項目を表示する権限が必要です。
You can see ideas linked to Jira Data Center work items only if your authorized Jira Product Discovery account has the necessary permissions.
You can see Jira Data Center work items linked to Jira Product Discovery ideas only if your authorized Jira Data Center account has the necessary permissions.
You can create Jira Data Center work items from Jira Product Discovery only if your authorized Jira Data Center account has the CREATE_ISSUES permission for the target space and only the following fields are set as required: Project, Issue type, Summary, and Assignee.
デリバリーの進捗は、閲覧しているユーザーの認証済み Jira Data Center アカウントがアクセスできる作業項目に基づいて計算されます。そのため、デリバリーの進捗は、ユーザーの Jira Data Center 権限によって異なる場合があります。

Creating work items from Jira Product Discovery won’t work if there are any required fields. Check out how to specify field behavior and change your field settings.

Jira Product Discovery から Jira Data Center の作業項目を作成するには、次の手順を実行します。

Jira Product Discovery でターゲットスペースに移動し、新しい作業項目を作成したいアイデアを選択します。
右側のパネルで [デリバリー] を選択します。
[+ Create work item (+ 作業項目を作成)] を選択します。
ドロップダウンから、ターゲットサイト、スペース、作業タイプを選択し、必要に応じて名前を変更します。
(オプション) [Embed the idea description and fields into the work item (アイデアの説明とフィールドを作業項目に埋め込む)] をオンにします。
[作成] を選択します。

Jira Data Center の作業項目を Jira Product Discovery のアイデアにリンクさせるには、次の手順を実行します。

Jira Product Discovery でターゲットスペースに移動し、作業項目をリンクしたいアイデアを選択します。
右側のパネルで [デリバリー] を選択します。
[Link a Jira work item (Jira 作業項目をリンク)] を選択します。
ドロップダウンから、ターゲットサイト、スペース、および作業項目を選択します。
追加を選択します。

Once the work item is created or linked, you can see the Delivery progress bar and a list of linked Jira work items. You can now track the progress directly in Jira Product Discovery and see the linked ideas inside the Jira work items.

アイデアパネル

When the Jira Product Discovery integration for Jira Data Center app is installed and enabled, linked ideas are displayed in the idea panel within the work item view.

Ideas panel from the work item in Jira Data Center

When the app is uninstalled or disabled, linked ideas are displayed in the work item links panel as regular links.

If your Jira Data Center has a custom work item (issue) link of the type “implements”, these links will always appear in the ideas panel in Jira Product Discovery, even if they don’t correspond to ideas.

日付を自動入力する

You can autofill dates based on data from a linked Data Center instance. To do so, enable the Autofill dates setting.

サポートされているフィールドは次のとおりです。

Jira Product Discovery フィールド	Jira Data Center フィールド
期限	期限
実際の開始日	目標開始日 (Advanced Roadmaps for Jira)
実際の終了日	目標終了日 (Advanced Roadmaps for Jira)
開始日	サポート

データレジデンシーとセキュリティ

Jira Product Discovery と共有されたデータ

The Jira Product Discovery integration for Jira Data Center app shares data required to display application links in Jira Product Discovery and calculate the delivery progress of work items.
Explore how to configure the delivery progress field

In particular, the Jira Product Discovery integration for Jira Data Center app shares the following data with Jira Product Discovery:

アプリアイコン、ステータス、作業項目キー、作業項目の要約など、標準課題リンクのメタデータ
Delivery progress details as shown in the following JSON snippet:

[
  {
    "id": 10003,
    "parentId": 10004,
    "key": "SCRUM-4",
    "status": "new",
    "dueDate": 1754092800000,
    "storyPoints": 1.25,
    "actualStart": 1754006400000,
    "actualEnd": 1754092800000
  },
  ...
]

Data residency for work item links

The same considerations apply as for the app links. Check out how to configure work item linking for Cloud and Data Center

デリバリー進捗に関するデータレジデンシー

Delivery progress data isn’t permanently stored in Jira Product Discovery. Instead, it’s fetched on demand whenever it needs to be displayed to the user. This might have memory and performance implications for your instance. Check the Performance implications section for more information.

セキュリティ

For the Jira Product Discovery integration for Jira Data Center app to work, your users need to have both Jira Data Center and Jira Product Discovery accounts which will authorize each other through the application links platform. This has the following implications:

Jira Data Center ユーザーには、Data Center の作業項目にリンクされている Jira Product Discovery のアイデアのみが表示されます。ただし、認証済み Jira Product Discovery アカウントに、そのアイデアを表示するために必要な権限がある場合に限られます。
Jira Product Discovery ユーザーには、Jira Product Discovery のアイデアにリンクされた Jira Data Center の作業項目のみが表示されます。ただし、認証済み Jira Data Center アカウントに、その作業項目を表示するために必要な権限がある場合に限られます。
Jira Product Discovery ユーザーは、承認された Jira Data Center アカウントがターゲットプロジェクトに必要な権限を持っている場合にのみ、Jira Product Discovery から Jira Data Center 作業項目を作成できます。
Jira Product Discovery のデリバリー進捗は、閲覧しているユーザーの承認された Jira Data Center アカウントがアクセスできる作業項目のみに基づいて計算されます。そのため、デリバリー進捗の値はユーザーの Jira Data Center 権限によって異なる場合があります。

作業項目のリンク権限

作業項目のリンク権限を持つユーザーのみが、作業項目とアイデア間のリンクを作成および削除できます。ユーザーが Jira Data Center からアイデアへのリンクを削除しても、このアクションによってアイデア自体が Jira Product Discovery から削除されることはありません。逆も同様です。作業項目へのリンクを削除しても、作業項目自体は削除されません。

パフォーマンスへの影響

We tested the Jira Product Discovery integration for Jira Data Center app with three different environment Jira Data Center configurations to determine the maximum load that a single node can handle. Our tests were designed based on metrics gathered from production Jira Product Discovery. As a result, we decided on a maximum load of 500 requests per minute, a P50 response size of 500 items, a P95 response size of 5,000 items, and a maximum response size of 60,000 items. Note that handling 60,000 items in a single response consumes around 40 MB of heap.

The expected average network traffic for different response sizes at 500 requests per minute is presented in the following table.

レスポンス内の項目数	受信するデータ
500	547 KB/s
5,000	5470 KB/s
60,000	65 MB/s

The following table shows the performance metrics for different environment types and response sizes. The tests were performed with the test client and the Jira Data Center node located in the same AWS region and with no other user traffic. The values shown are P99 times in milliseconds.

レスポンスサイズ	500 items	5,000 items	60,000 items
環境
32 GB RAM, 4 CPU, 20 GB heap	500/min: 206 ms 1000/min: 538 ms	500/s: 643 ms	100/min: 3443 ms (max reasonable) 500/min: 467141 ms
64 GB RAM, 32 CPU, 32 GB heap	500/min: 155 ms 2000/min: 271 ms	500/s: 243 ms 2000/min: 358 ms	500/min: 1196 ms 1000/min: 1401 ms
128 GB RAM, 32 CPU, 100 GB heap	500/min: 170 ms 2000/min: 384 ms	500/min: 258 ms 2000/min: 445 ms	500/min: 1110 ms 2000/min: 2002 ms

レート制限

Jira Data Center includes built-in rate limiting that lets admins prevent users from overloading the system with requests. Testing this integration revealed that a large Jira Product Discovery board with many linked Jira Data Center work items uses far more node resources than multiple smaller boards, increasing load nonlinearly. To address this, we added a rate-limiting layer based on the number of requested work delivery items to the app.

実装の詳細

実装されたアルゴリズムは、補充の時間枠が固定された標準的なトークンベースの方法を使用しており、簡単に理解して使用できます。ただし、時間枠のサイズが固定されているため、スパイクやバーストが発生する可能性があります。

さらに、このソリューションはクラスター化されていません。代わりに、各 Jira Data Center ノードが別個の環境で動作します。(読み取り専用ノードのように) スティッキーセッションとカスタムルールを組み合わせると、クラスターノードごとに負荷の特性を変えることができます。この設計により、管理者はノード単位の設定を適用できます。

The token system reflects the number of work items requested by the Jira Product Discovery board. For example, a board with 10 Jira Data Center work items consumes 10 tokens.

レート制限を設定して有効化する

Rate limiting is disabled by default. You can enable it by passing the -Djpdc.feature.rate.limiting.enabled=true Java environment variable.

By default, the window time is set to 1 minute and the number of tokens is set to 12 million (2,000 requests times 60,000 items - see table above). To change these values, edit the following properties:

// Below property changes fixed window size to 1 min.
// Hence bucket will be refilled every 1 minute for its max capacity.
-Dcom.atlassian.jpdc.connector.rate.limiting.window.time.in.milliseconds=60000

// Below property changes bucket size to 10 tokens. Hence all users can only
// request 10 work items metadata per window.
-Dcom.atlassian.jpdc.connector.rate.limiting.bucket.capacity=10

負荷分散

Jira Product Discovery の負荷を複数の Jira Data Center ノードに分散する場合は、一部のノードが他のノードよりも早く容量に達する可能性があります。必要に応じて呼び出しが他のノードにリダイレクトされるように、負荷分散ルールとスティッキーセッションを調整してください。

監視

Rate limiting characteristics are included with Jira Stats and the Open Telemetry endpoint. Examples you can find it below.
To debug rate limit change DEBUG log level for the following packet: com.atlassian.jpdc.connector.

監視

監査ログ

To enable audit logs for this app, you must set the coverage level to Full for external apps.

監査ログは次の場所に保存されます。

Category: JPD Connector
Summary: Delivery Issue Details Request

The following image displays an audit log example.

アプリログ

既定では、このアプリは INFO ログレベルを使用します。これは、com.atlassian.jpdc.connector パケットの Jira Data Center ログ設定で変更できます。

Each log line starts with the app’s prefix for easy filtering: [JPDConnector].

リクエストとレスポンスの issueIds を記録するには、ログレベルを TRACE に設定します。

This app supports JIRA-STATS logs (both total and snapshot). The com.atlassian.jpdc.stats.logging.interval.minutesvariable defines the stat logging interval in minutes, with a default value of 30. If not defined, com.atlassian.jira.stats.logging.interval is the fallback.

JIRA-STATS ログの形式は次のとおりです。

[JIRA-STATS] [JPDConnector] snapshot stats: {"searchMillis":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"searchMillisDistribution":{"100":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"500":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"1000":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"10000":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"60000":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"9223372036854775807":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}}},"mapErrorsMillis":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"requestedIssueCount":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{"10":0,"100":0,"1000":0}},"foundIssueCount":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{"100":0,"500":0,"1000":0,"10000":0,"60000":0}},"childIssueCount":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{"100":0,"500":0,"1000":0,"10000":0,"60000":0}},"errorIssueCount":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{"10":0,"100":0,"1000":0}},"usedMemoryMb":{"count":1,"min":933,"max":933,"sum":933,"avg":933,"distributionCounter":{}}, "rateLimitCount":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{}},"rateLimitUsedCapacity":{"count":0,"min":0,"max":0,"sum":0,"avg":0,"distributionCounter":{"10":0,"20":0,"30":0,"40":0,"50":0,"60":0,"70":0,"80":0,"90":0,"100":0}}}

メトリック	説明
`searchMillis`	検索操作の計算時間 (ミリ秒単位)。
`searchMillisDistribution`	レスポンスサイズ別の検索時間の分布。
`mapErrorsMillis`	課題の全エラーのマッピングの計算時間。
`requestedIssuesCount`	リクエストで使用された課題 ID の数。
`foundIssuesCount`	検索で見つかった課題の数。
`childIssuesCount`	検索で見つかった子課題の数。
`errorIssuesCount`	検索で見つかったエラーのある課題の数。
`usedMemoryMb`	JVM メモリの使用量 (メガバイト単位)。
`rateLimitCount`	Count of how many times the delivery progress endpoint was rate-limited
`rateLimitUsedCapacity`	Distribution of bucket capacity usage in %

さらに、これらのメトリックは以下の数に応じて複数のバケットに分配されます。

リクエスト内の課題数
- 対象: requestedIssuesCount
- buckets: 10, 100, 1000, >1000
レスポンス内のデリバリーチケット数
- 対象: searchMillisDistribution、foundIssuesCount、childIssuesCount
- buckets: 100, 500, 1000, 10000, 60000, >60000
レスポンス内のエラーデリバリーチケット数
- 対象: errorIssuesCount
- buckets: 10, 100, 1000, >1000
パーセンテージ
- 対象: rateLimitUsedCapacity
- buckets: 10, 20, 30, 40, 50, 60, 70, 80, 90, 100

OpenTelemetry REST エンドポイント

Metrics in the OpenMetrics text format are available via the /rest/jpdc/1.0/metrics endpoint if the com.atlassian.jpdc.feature.openmetrics.enabled flag is enabled. Authorization is required to access this resource.

The OpenTelemetry data consists of JVM metrics, request and response counters and histograms, and delivery issue details. The data is assigned to buckets for easier visualization. See each metric’s "le" (lower-equal) value for bucketing details.

# TYPE jvm_threads_current gauge
# HELP jvm_threads_current Current thread count of a JVM
jvm_threads_current 231.0
# TYPE jpdc_found_issues_count histogram
# HELP jpdc_found_issues_count Count of issues found for delivery issue details
jpdc_found_issues_count_bucket{le="100.0"} 1.0
jpdc_found_issues_count_bucket{le="500.0"} 2.0
jpdc_found_issues_count_bucket{le="1000.0"} 2.0
jpdc_found_issues_count_bucket{le="10000.0"} 2.0
jpdc_found_issues_count_bucket{le="60000.0"} 2.0
jpdc_found_issues_count_bucket{le="+Inf"} 2.0
jpdc_found_issues_count_count 2.0
jpdc_found_issues_count_sum 529.0
jpdc_found_issues_count_created 1.757496936605E9
# TYPE jpoc_rate_limiting_count counter
# HELP jpdc_rate_limiting_count Count of requests that was rate limited for delivery issue details
jpdc_rate_limiting_count_total{bucket_size="10"} 7.0
jpdc_rate_limiting_count_created{bucket_size="10"}
# TYPE jpdc_rate_limiting_near_limit_count counter
# HELP jpdc_rate_limiting_near_limit_count Count of requests that was near limit of bucket
jpdc_rate_limiting_near_limit_count_total{is_near_limit="true",near_limit_threshold="8"} 11.0
jpdc_rate_limiting_near_limit_count_created{is_near_limit="true",near_limit_threshold="8"} 1.760084409218E9
jpdc_rate_limiting_near_limit_count_totalfis_near_limit="false",near_limit_threshold="8"} 16.0
jpdc_rate_limiting_near_limit_count_created{is_near_limit="false",near_limit_threshold="8"} 1.760084404258E9

トラブルシューティング

アプリケーショントンネルが利用できない、または接続されていない

If the app tunnel is unavailable, make sure that Jira Data Center has a properly set-up connector, installed tunnels plugin, and that an app tunnel is created from Jira Product Discovery to Jira Data Center.

Jira Product Discovery と Jira Data Center の不一致

Make sure you don’t see any error codes in responses from the Jira Data Center API. Also ensure the user reporting the problem has permission for all tickets in Jira Data Center and that the app link from Jira Product Discovery to Jira Data Center is working fine.

エラーコード	メッセージ	説明
`1`	`Unexpected error during issue details retrieval.`	使用されません。
`2`	`Issue does not exist or user lacks permissions to view it.`	特定のユーザーと作業項目 ID の作業項目検索で結果が得られない場合に返されます。これは、権限がないか、作業項目が存在しないことが原因である可能性があります。

Jira Data Center で作業項目を削除しても Jira Product Discovery に反映されない

ユーザーが Jira Product Discovery アカウントと Jira Data Center アカウントの相互承認を完了している場合、すべての変更が Jira Product Discovery と Jira Data Center の両方に反映されるため、作業項目を削除しても課題は発生しません。

ユーザーが相互承認を完了していないか、または必要な権限を持っていない場合は、相互承認を実行するように求めるプレースホルダーが表示されます。

Jira Product Discovery のアイデアと Jira Data Center 作業項目間のリンクを削除した場合

リンクを削除した後は、Jira Product Discovery 側からのみリンクを再作成できます。

Jira Product Discovery 側からリンクを削除した場合、Jira Data Center 作業項目はデリバリー進捗にカウントされなくなります。

Jira Data Center 側からリンクを削除した場合、Jira Data Center 作業項目は引き続きデリバリー進捗にカウントされます。

Jira Data Center のアイデアパネルには、Jira Product Discovery ボードよりも多くの作業項目が表示されます

The idea panel only shows Jira Product Discovery ideas that have an "implements" relationship with Jira Data Center work items or that were linked to from the delivery panel. This means that you might see more work items in Jira Data Center than in Jira Product Discovery. Only work items shown in Jira Product Discovery count toward delivery progress.

Jira Product Discovery から課題を作成できない

Make sure your users have permission to create work items. In addition, make sure that it’s possible to create an issue using the default values and that there aren’t any additional restrictions.

不要な作業項目リンク

Jira Data Center アプリ向けの Jira Product Discovery 統合は、ネイティブの作業項目リンクの動作を継承します。Jira Product Discovery のアイデアが削除された場合、自動的に削除されなかった Jira Data Center の作業項目リンクが宙ぶらりんの状態になる場合があります。これらは、ご自身で安全に削除できます。

Jira Product Discovery から作成された Jira Data Center の作業項目に奇妙な文字が含まれている

設計上、統合はプレーンテキストのみをサポートします。これは、Jira Product Discovery と Jira Data Center がテキストフォーマットに異なるマークダウンセットを使用するためです。この問題を回避するには、プレーンテキストのみを使用して Jira Product Discovery から Jira Data Center 作業項目を作成します。

その他の既知の問題

Issue	説明
リモートリンクが、課題の複製や分割を行う際にサポートされません。	今後のリリースで、この問題の修正を予定しています。
The Linked items field doesn’t reflect the number of remotely linked items.	今後のリリースで、この問題の修正を予定しています。
ローカルの作業項目をリンクする際に、同じアイテムを異なる関係性のタイプ (ブロックしている、関連しているなど) で複数回リンクできます。リモートの課題は一度のみリンクできます。	これは、正常な動作です。
課題のリンクを解除すると、操作が実行されたサイトでのみ課題が消えます。	これは、正常な動作です。
次のようなプロジェクトドロップダウンの動作: Cloud リモートサイトの場合 - 指定された文字列を含むすべてのプロジェクトが返されます DC リモートサイトの場合 - 指定した文字列で始まるプロジェクトのみが返されます	これは、正常な動作です。
Jira Product Discovery でアイデアを削除しても、Jira Data Center のアイデアパネルに反映されません。	これは、正常な動作です。
Jira Product Discovery において、Jira Data Center 課題で「子」として表示されるアイテムが、標準の「親」関係ではなく、「親リンク」関係に基づいています。エピックの場合は、「サブタスク」ではなく「エピック内の課題」が表示されます。	これは、正常な動作です。

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問