概要

Jira は、ソフトウェアチーム向けの課題およびプロジェクト追跡システムです。Datadog Jira インテグレーションにより、Datadog でトリガーされたアラート、インシデント、ケースから Jira に課題を作成し、Jira で作成された課題を Datadog のイベントとして表示することができます。

セットアップ

Jira でアプリケーションリンクを作成する

Jira Cloud 手順

1. Jira に移動します。

2. 右端の歯車アイコンをクリックし、** Products** を選択します。

3. 左メニューの Integrations の下にある Application links をクリックし、Create link をクリックします。

4. Direct application link チェックボックスを選択し、URL https:// を入力し、Continue をクリックします。

5. “No response was received from the URL you entered” (入力した URL から応答がありません) という警告を無視して、Continue をクリックします。

6. 下記のようにフォームに入力し、Continue をクリックします。

   フィールド	入力
   Application Name	{Enter a name (e.g. Datadog)}
   Application Type	一般的なアプリケーション
   Service Provider Name	{leave blank}
   Consumer key	{leave blank}
   Shared secret	{leave blank}
   Request Token URL	{leave blank}
   Access token URL	{leave blank}
   Authorize URL	{leave blank}
   Create incoming link	ボックスをチェック

7. 次のフォームに以下のように入力し、Continue をクリックします。Datadog Jira インテグレーションタイルで公開鍵を見つけるには、Add Account をクリックします。

   フィールド	入力
   Consumer Key	{キー名を入力 (例: datadog)}
   Consumer Name	Datadog
   Public Key	{Datadog Jira インテグレーションタイルから公開鍵を入力}

Jira Data Center 手順

1. Jira に移動します。
2. 画面右上隅にある歯車アイコンをクリックし、Applications を選択します。
3. 左メニューの Integrations の下にある Application links をクリックし、Create link をクリックします。
4. Create link ダイアログで Atlassian product を選択し、Application URL に https:// を入力したら、Continue をクリックします。
5. “No response was received from the URL you entered” (入力した URL から応答がありません) という警告を無視して、Continue をクリックします。
6. Jira Cloud 手順に示されたのと同じパラメータを使用してフォームに入力してください。

Datadog を Jira インスタンスに接続する

1. Datadog Jira インテグレーションタイルに移動し、Add Account をクリックします。
2. Jira インスタンスの URL と、以前に作成したアプリケーションリンクのコンシューマーキーを入力します。
3. Connect をクリックし、表示される Jira 認可ページの指示に従ってください。Connect をクリックする前に、該当アカウントでログインしていることを確認してください。 注: Datadog Jira インテグレーションはオンプレミス環境や Jira Data Center インスタンスにも接続可能です。ただし、こうしたインスタンスの多くは特定の IP 範囲をブラックリスト登録しています。インテグレーションを有効にするには、以下の IP フィルタリングに関するドキュメントに従ってください。

IP フィルタリング

Jira インスタンスが IP アドレスによってトラフィックをフィルタリングする場合、インテグレーションが機能するためには、Datadog に属する Webhooks IP プレフィックスからの接続を許可する必要があります。お住まいの地域の Webhooks IP プレフィックスのリストについては、Datadog IP 範囲を参照してください。

詳細なコンフィギュレーション

Case Management で双方向同期による Jira 課題の自動作成を構成するには、Jira webhook の構成の説明および Case Management のドキュメントを参照してください。

Datadog モニターアラートから Jira 課題を作成するには、課題テンプレートの構成を参照してください。

Jira webhook の構成

Webhook を構成することで、Case Management で作成されたケースが自動的に Jira に課題を作成し、両方のリソースを同期させることができます。

Jira webhook を作成するには

1. Jira で右上の歯車アイコンをクリックし、System を選択します。
2. 左メニューの Advanced で、Webhooks をクリックします。
3. 右隅の Create a Webhook をクリックします。
4. webhook 名には Datadog Webhook と入力します。
5. ステータスを Enabled のままにします。
6. Datadog Jira インテグレーションタイルに移動します。
7. Webhooks セクションで、webhook URL をコピーします。
8. Jira に戻り、URL の下に webhook URL を貼り付けます。
9. 以下の課題関連イベントを有効にします。課題イベントのサブセットのみを送信したい場合は、JQL を使用してフィルタリングできます。この例では、プロジェクト AB と CD のみをフィルタリングしています。

10. deleted プロジェクト関連のイベントを有効にします。
11. その他の項目はチェックを入れないでください。
12. ページ下部の Create ボタンをクリックします。

課題テンプレートを構成する

課題テンプレートは、Datadog のアラートイベントから Jira で課題がどのように作成されるかを定義します。

課題テンプレートを作成するには

1. Datadog で、Connect Jira to Monitor Notifications セクションの New Issue Template をクリックします。
2. 課題テンプレートの名前を入力します。この名前の前に jira- を付けると、モニターで通知を送るためのハンドルになります (jira-my-issue-template-name のように)。
3. Jira アカウントを選択します。
4. プロジェクトと課題の種類 (Story、Epic*、Task*、*Bug**など) を選択します。
5. 構成可能なフィールドのリストが表示されます。必要な項目に値を入力し、** Save** をクリックします。

課題のフィールドを構成する

課題テンプレートフィールドは、Jira で課題を作成する際に含まれるデータを定義します。たとえば、特定の優先度やデフォルトの担当者で課題を作成するようにテンプレートを構成することができます。

${EVENT_TITLE} などのテンプレート変数を使用すると、アラートイベントのデータを使用して、課題フィールドに値を入力することができます。使用可能な変数の一覧は、Datadog Webhooks インテグレーションを参照してください。

使用方法

Datadog アラートから自動的に課題を作成する

Datadog のアラートイベントから Jira 課題を作成するには、Notify your team または Say what’s happening セクションでモニターを作成する際に @jira-my-issue-template などの 1 つまたは複数の課題テンプレートの通知ハンドルを入力する必要があります。

課題は、モニターがトリガーされたときに作成されます。モニターが解決されるまで、モニターによって新しい課題が作成されることはありません。

収集データ

メトリクス

Jira インテグレーションには、メトリクスは含まれません。

イベント

作成されたすべての Jira の課題は、Datadog 内にイベントとして表示されます。

サービスチェック

Jira インテグレーションには、サービスのチェック機能は含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。