Smartsheet Jira コネクタ:Jira の Webhook

ご利用可能なユーザー

プラン:

  • Advanced Work Management
  • Business
  • Enterprise

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 コネクタ管理者が次の操作を行う必要があります。

  1. Jira コネクタ管理者ダッシュボードに移動します。
  2. [Migrate Workflows (ワークフローの移行)] ボタンを選択します。

    ボタンを選択した後に、一部のワークフローの移行に失敗したことを示すアラートを受け取った場合は、もう一度試してください。すべてのワークフローが正常に移行されると、[Migrate Workflows (ワークフローの移行)] ボタンは表示されなくなります。この変更は既存のワークフローには影響せず、再度有効にする必要はありません。

Brandfolder Image
Migrate Workflows button in the Jira Admin Dashboard

自動化されたワークフローを可能な限り統合する

Webhook に関する Atlassian のベスト プラクティスでは、Webhook をできるだけ減らすことを推奨しています。ワークフローを統合する別の方法として、ワークフローに対してより一般的なフィルターを使用し、接続されたシートをデータのステージング サイトとして使用するという方法があります。その後、DataMesh を使用してシート間でデータをフィルターし、送信できます。

ワークフローが多く、Jira の速度が遅い場合は、Atlassian の Webhook トラブルシューティング ガイドで、速度の低下を引き起こしている可能性のある Webhook を Jira 管理者が診断できる方法をご覧いただけます。

非同期 Webhook 処理を有効にする

既定では、Jira Server および Data Center は、問題に変更が加えられるたびに、これらの Webhook を個別に処理します。

Jira には、Webhook を非同期で処理するように Jira に指示する非公式のダーク機能があり、変更後の UI の応答性を高めています。この変更を有効にするには、Jira 管理者を持つユーザーの権限が必要です。

この Jira チケットによると、次の方法で機能を有効にできます。

  1. 以下の手順で com.atlassian.jira.webhookEventsAsyncProcessing 機能フラグを手動で有効にします。
  2. 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 個未満に減らす必要があります。

  1. 使用している双方向ワークフローの数を特定します。
  2. Webhook の数が 100 個未満になるように、十分な双方向ワークフローを無効化します (つまり、双方向ワークフローの数を少なくとも 100 個未満にする必要があります)。
  3. 管理者またはワークフロー所有者が双方向ワークフローを無効にした後、既存のワークフローを新しいシステムに変換できます。
  4. ワークフロー所有者にページを最新の情報に更新してもらい、[Reset (リセット)] ボタンを選択して、ワークフローを再有効化します。ワークフローが正常にリセットされたことを確認した後、残りの無効化された双方向 Jira ワークフローに対してこのプロセスを続行します。

Jira ユーザーは誰でもワークフローを無効化できますが、ワークフローを再有効化できるのは所有者だけであるため、このアクションは所有者が実行する必要があります。