USM Content
Jira の Webhook
2023 年 11 月 15 日の時点で、Smartsheet Jira コネクタの Webhook スキームをアップグレードし、効率を高めました。この日付以降に作成されるすべての双方向ワークフローが、共有された Webhook システムによるメリットを受けられます。この戦略的な強化は、Atlassian Jira Cloud が 2024 年 7 月から Jira 環境あたりの Jira Webhook 数を 100 個に制限することを受けて、それに足並みを揃えるために設計され、Jira Cloud 環境あたり 100 個までの Jira Webhook の制限が導入されました。その利点として、Jira の Webhook の制約を回避し、必要な数のワークフローを確立できるようになりました。
既存のワークフローを新しいモデルに変換する
2024 年 7 月に Atlassian の Jira Webhook 制限が更新されたため、すべてのワークフローを新しい共有 Webhook モデルに移行することをお勧めします。このプロセスを開始するには、アカウントのシステム管理者または Jira コネクタ管理者が次の操作を行う必要があります。
- Jira コネクタ管理者ダッシュボードに移動します。
[Migrate Workflows (ワークフローの移行)] ボタンを選択します。
ボタンを選択した後に、一部のワークフローの移行に失敗したことを示すアラートを受け取った場合は、もう一度試してください。すべてのワークフローが正常に移行されると、[Migrate Workflows (ワークフローの移行)] ボタンは表示されなくなります。この変更は既存のワークフローには影響せず、再度有効にする必要はありません。
自動化されたワークフローを可能な限り統合する
Webhook に関する Atlassian のベスト プラクティスでは、Webhook をできるだけ減らすことを推奨しています。ワークフローを統合する別の方法として、ワークフローに対してより一般的なフィルターを使用し、接続されたシートをデータのステージング サイトとして使用するという方法があります。その後、DataMesh を使用してシート間でデータをフィルターし、送信できます。
ワークフローが多く、Jira の速度が遅い場合は、Atlassian の Webhook トラブルシューティング ガイドで、速度の低下を引き起こしている可能性のある Webhook を Jira 管理者が診断できる方法をご覧いただけます。
非同期 Webhook 処理を有効にする
既定では、Jira Server および Data Center は、問題に変更が加えられるたびに、これらの Webhook を個別に処理します。
Jira には、Webhook を非同期で処理するように Jira に指示する非公式のダーク機能があり、変更後の UI の応答性を高めています。この変更を有効にするには、Jira 管理者を持つユーザーの権限が必要です。
この Jira チケットによると、次の方法で機能を有効にできます。
- 以下の手順で com.atlassian.jira.webhookEventsAsyncProcessing 機能フラグを手動で有効にします。
- Jira インスタンス (または DC の場合は各ノード) を再起動します
次のバージョンの Jira Server と Data Center では、この機能を有効にできます。
- 8.13.25、8.20.12 以降
- 9.2.0 以降
よくある質問
Webhook limit exceeded (Webhook の制限数を超えています)
このメッセージが表示された場合は、Jira 環境内で 100 個を超える Webhook を使用していることを意味します。Atlassian は Jira Cloud インスタンスあたり 100 個の Webhook 制限を適用しています。そのため、次のアクションを実行して、Webhook の数を 100 個未満に減らす必要があります。
- 使用している双方向ワークフローの数を特定します。
- Webhook の数が 100 個未満になるように、十分な双方向ワークフローを無効化します (つまり、双方向ワークフローの数を少なくとも 100 個未満にする必要があります)。
- 管理者またはワークフロー所有者が双方向ワークフローを無効にした後、既存のワークフローを新しいシステムに変換できます。
- ワークフロー所有者にページを最新の情報に更新してもらい、[Reset (リセット)] ボタンを選択して、ワークフローを再有効化します。ワークフローが正常にリセットされたことを確認した後、残りの無効化された双方向 Jira ワークフローに対してこのプロセスを続行します。
Jira ユーザーは誰でもワークフローを無効化できますが、ワークフローを再有効化できるのは所有者だけであるため、このアクションは所有者が実行する必要があります。