DOCS
インテグレーションガイド / Jira Server

よくある質問

1. この統合でJiraにはどのようなアイテムが作成されますか？

   Atlassian Marketplaceからアドオンをインストールすると、Jira内にPagerDutyという名前のユーザーが作成されます。このユーザーには、PagerDutyにリンクする予定のプロジェクトの管理者権限が必要です。

2. JIRA Serverがファイアウォールの内側にある場合はどうなりますか？

   PagerDutyとJIRA Serverの双方向の統合を可能にするには、PagerDutyからの着信トラフィックを許可するようにファイアウォールを設定する必要があります。このIPアドレスおよびホワイトリストに登録するべきIPアドレスの詳細については、 Knowledgebaseを参照してください。特に、PagerDuty webhookとREST APIの IPをホワイトリストに登録する必要があります。

3. JIRA Server インテグレーションは必須のカスタムフィールドをサポートしていますか？

   はい。PagerDutyにJiraフィールドを設定させることができます。これは、PagerDutyでインテグレーションを設定するときに定義できます。

4. テストインシデントをトリガーすると、”Sorry, you can’t create any issues right now, as you need to have access to a JIRA application to be able to create issues”というエラーが表示されます。どうすれば解決できますか？

   この拡張が作成されると、JIRAでPagerDutyというユーザーを作成する必要があります。このユーザーは、統合が機能するために、該当する問題/プロジェクトへの書き込みアクセス権が必要です。

   これが正しく設定されていることを確認するには、JIRAで次の手順を実行します。

   1. JIRAアカウントで、右上にある歯車アイコン（） を選んでUser Managementボタンをクリックします。
   2. Jiraの管理者名とパスワードの入力を求められます。
   3. PagerDutyユーザーを選択します。
   4. PagerDutyユーザーを選択した後、 右上にあるView Project Roles ボタンを選択し てください。その後、特定のJiraプロジェクトの権限に移動する必要があります。 (** NOTE：JIRAでのユーザーの名前はPagerDutyでなければなりません。他の名前、例えばPagerDuty1とすると、動作しません）。

   このユーザーのアクセス許可を設定したら、再度テストインシデントを送信してみてください。

5. 優先順位をJiraからPagerDutyにマッピングするにはどうすればよいですか？

   JiraプロジェクトをPagerDutyに接続する際に、同時に優先順位をマッピングできます。既にあるJiraプロジェクトのための優先度マッピングを追加または変更するには、PagerDutyのJira Serverエクステンションページに移動し、該当するJiraプロジェクトの 歯車アイコン（）を選び Edit を選択します。⚙️

6. 特定のJiraの課題（issue）のみでインシデントをトリガーさせたい場合はどうすればよいですか？

   PagerDuty側の設定でJQLを使用することで、PagerDutyインシデントをトリガーする条件をより細かく制御できます。そのための設定メニューはPagerDutyアカウントのExtensionsに移動すると見つけることができます。Jira Server Extensionを選択すると、歯車アイコン（）を選択して既存のService to Projectマッピングを編集できますし、新しいマッピングを追加することもできます。JQL文を最初にJiraでテストして、PagerDutyインシデントを引き起こしたい課題のマッチすることを確認することがとれも大事です。たとえば、優先度の高いチケットがSRE Projectで開かれている場合にのみPagerDutyインシデントをトリガーしたいとします。私が使用する JQL は次のようになります。⚙️

   (status = Open AND project = SRE ) AND priority = High OR priority = Highest

   追加するプロジェクトごとに異なるJQLを使用することができます。したがって、すべてのJira Projectsに対するキャッチオール型のJQL文を作る必要はありません。

   注： JQLを使用したPagerDutyインシデントの自動作成は、新規および既存のJiraの課題のどちらでも引き起こされる可能性があります。

7. Jiraに認証トークンを保存しようとすると、エラーが表示されます。どうしてでしょうか？

   この問題の最も一般的な原因は、Jira Serverからapp.pagerduty.comにアクセスできないからです。この場合、IPアドレスがホワイトリストに登録されていることを確認するために、ネットワークとファイアウォールの設定を確認する必要があります。詳細はこちらをください。究極の場合は、認証トークンの有効期限が切れて、無効になっている可能性があります。PagerDutyから取得した認証トークンは15分後に失効してしまうため、PagerDutyでトークンを生成して15分以上経ってからJiraに追加する場合は、PagerDutyページを更新して新しいトークンを生成する必要があります。 JiraプロジェクトをPagerDutyにリンクする際にエラーが発生し、プロジェクトが追加できません

   PagerDutyのIPアドレスをホワイトリストに登録したことを確認済みなら、SSL証明書を確認してください。HTTPをサポートしていても、JiraインスタンスのSSL証明書の有効期限が切れているか無効である場合は、この問題が発生します。

   PagerDutyから”Create a Test Issue”クリックしてみても、エラーが表示されたり、Jiraインスタンスに何も作成されなかったりします

   以下の点をダブルチェックしてみてください。 - Jiraの中に、「PagerDuty」ユーザーが存在し、チケットを開こうとしているプロジェクトに対する管理者権限を持っている。 - Jiraでは、必須フィールドがあるかどうかを確認します。そうであれば、PagerDutyでの統合を設定するときに、PagerDutyフィールドを必須のJiraフィールドと同期させる必要があります 。 - PagerDuty内で、”API Key for add-on JIRA Server” という説明を含むv2 REST APIキーがあることを確認します。

8. PagerDutyから入力できるJiraフィールドのタイプは何ですか？

   JiraのPagerDutyとの統合により、以下のタイプのフィールドを設定できます。

   • 文字列をとるフィールド
   • ラベル
   • 番号フィールド
   • リストを選択（単一選択と複数選択）
   • テキストフィールド（単一行と複数行）
   • URL
   • ユーザーピッカー（シングルユーザー）

9. PagerDutyの labelフィールドにはどのように入力できますか？

   PagerDutyでJiraプロジェクトを設定している間、このフィールドに値を入力できます。

   1. New Field ボタンをクリックして、データを同期するためのカスタムフィールドを作成します。
   2. PagerDuty AttributeとしてConstant valueを選択します 。
   3. テキストボックス入力が表示されます。label フィールドに使用する値を入力します。カンマを区切り記号として使用して複数の値を追加できます。（IE： 青、赤 ）