自動化サービスの制限

インスタンスのパフォーマンスを保つために、以下の自動化サービスの制限が適用されています。

*[サービス制限違反時] トリガーを使用して、日次または毎時の処理制限に近づいた際に通知を送信する自動化ルールを作成できます。

制限違反

監査ログに次のエラーが含まれている場合は、サービス制限に違反している可能性があります。

• 監査項目のステータスは "THROTTLED" です。

• 監査項目には以下が含まれます。

  • Automation for Jira has exceeded the allowed total processing time for this rule. Maximum allowed processing time over 12 hours is (in seconds):

  • A JQL search in this automation rule has exceeded the allowed maximum number of work items to retrieve per search. Only the first work items up to the following limit where processed:

ルールがそのサービス制限を超過した場合、エラーについての詳細は監査ログで確認できます。

監査ログの情報を使用すると、ルールが許容可能制限内に収まるようにいくつかの手順を講じることができます。一般的な注意事項は次のとおりです。

• スケジュールされたルールの実行間隔を短くします。たとえば、5 分ではなく 1 時間おきにのみルールを実行します。

• Restricting your JQL query to only search for the work items you care about. For example, check that the updated time of the work item is within a certain range (updated > -1w to include only last week's work items).

• 各ルールに複数のコンポーネントが必要な場合、自動化ルールを複数のルールに分割します。

• For large, one-off operations that need to edit several thousands of work items, using Jira's bulk change functionality.

キューのアイテム数のサービス制限

自動化では、ルール処理用のキューによって、インスタンスのルールの実行が管理されます。パフォーマンスを維持するため、ルールの実行はキューに入れられ、同時に処理されるアイテムの数には上限が設けられています。

自動化ルール ビルダーは強力なため複雑なルール構造を構築できますが、キューに並ぶ項目数が急増する可能性があります。

When this limit is reached across all rules in your app, your automation rules will no longer run.

キューが急増する原因となるルールはどのようなものですか?

Rules with many related work item branches, where each related work item branch matches a significant number of work items.

以下の例では、約 13,000 件のアイテムがキューに入れられることになります。

• A Scheduled trigger that matches 100 work items

• A Related work items branch that matches 50 work items

• Another Related work items branch that matches 80 work items

Rules with many Related work item branches, to simulate if conditions, can also cause large numbers of queued items. The following examples results in 3,500 items or more, depending on the number of branches.

• Trigger: Work item updated

• Related work items branch with JQL: type = Bug that matches 1000 work items

• Related work items branch with JQL: type = Task that matches 500 work items

• Related work items branch with JQL: type = Feature that matches 2000 work items

対策

It’s recommended to reduce the overall number of work items a rule fetches, either via the trigger or the Related work items branch.

キューのアイテム数のサービス制限を超えないために、以下のガイドラインを参考にしてください。

• Ensure you use JQL that limits the execution to the smallest possible set of work items. This can be achieved in a number of ways:

  • Ensure your JQL search is as specific as possible. Don't just search for work items that match type = Task if you only care about work items currently in progress. A better alternative in this case would be: type = Task and status = "In Progress".

  • Use the Only include work items that have changed since the last time this rule executed option. For many rules, it's perfectly fine to operate only on this small subset

• Don't create Related work item branches for conditional checks. In the above example, the If/else block condition could be used to match based on the work item type.