AWS Lambda を介して Opsgenie を Jira と統合する

Lambda は、サーバーなしでコードを実行する AWS のコンピューティングサービスです。AWS Lambda は、インテグレーションを含む多くのユースケース、特に Opsgenie や Jira のような SaaS ソリューションを統合する場合に最適なソリューションです。

インストール
次のステップでは、AWS API ゲートウェイと Lambda サービスによって Opsgenie と Jira を統合する方法について説明します。

AWS Lambda を使用して Jira を Opsgenie と統合するプロセスを示す画像。

API ゲートウェイエンドポイントを介した Lambda 関数の作成

AWS Lambda コンソールに移動します。

AWS Lambda に初めてアクセスする場合は、ようこそ画面が表示されます。[今すぐ始める] をクリックします。

[ブランク機能] をクリックして、ブループリントを選択します。

関数トリガーとして [API ゲートウェイ] を選択します。

Lambda の設定トリガーオプションの API ゲートウェイオプションを示す画像。

API ゲートウェイエンドポイントの API 名を入力します。例: OpsgenieJIRAIntegrationAPI

[デプロイメントステージ] として [prod] を選択し、[セキュリティ] オプションとして [オープン] を選択します。

[次へ] をクリックします。

Lambda 関数の名前を入力します (例: opsGeniejiraIntegration)。

説明: 必要に応じて入力するか空白のままにします。

ランタイム: [Node.js] およびコードエントリタイプ: [コードをインラインで編集]。

ogLambdaJira.js から JavaScript コードをインラインエディターに貼り付けます。

コードの最初には、Opsgenie と Jira のアカウント情報に応じて設定するオプションがいくつかあります。

Jira (アトラシアンから) のホストバージョンが使用されている場合は、Jira アカウント名に置き換えます。

Jira のカスタムインストールが使用されている場合は、それに応じて jiraHost、jiraBasePath、jiraProtocol、jiraPort の各変数を更新します。

別の地域のお客様の場合

Opsgenie が別のドメイン (例: EU、サンドボックス) から使用されている場合は、OGHost を更新してください。

デフォルトの API インテグレーションまたはその他の API インテグレーションの Opsgenie API キーに置き換えます。

Jira アカウントに応じて正しい値を入力します。

Opsgenie の AWS Lambda インテグレーションで Jira の値を入力する場所を示す画像。

Opsgenie に作成されたアラートごとに、Jira プロジェクト内に新しい Jira 問題が作成されます。問題が作成されるプロジェクトを決定できるように、コードには 2 つの設定があります。

AlertTagToJiraProjectKey マップを使用して、アラートタグを Jira プロジェクトキーに関連付けます。

jiraDefaultProjectKey は、タグキーマッピングのいずれもアラートから照合できない場合に使用されるデフォルトの Jira プロジェクトキーの略です。

Jira インストールにプロジェクトが 1 つしかない、または同じ Jira プロジェクト内にすべての問題を作成する場合は、そのキーをデフォルトとして入力してマッピングを空の配列のままにします。

Opsgenie の AWS ラムダインテグレーションで Jira プロジェクトキーを入力する場所を示す画像。

Handler の値を index.handler のままにし、[ロール] に [カスタムロールを作成] を選択します。

新しく開いたウィンドウで [許可] をクリックして、Amazon CloudWatch にログを送信するために必要なアクセス許可を Lambda 関数に付与します。

万が一のために、[詳細設定] ペインで [タイムアウト値] に 5 を選択します。[メモリ] の値は 128 のままにしておきます。この値は今回は十分な値です。

Opsgenie の Jira インテグレーションにおける Lambda 関数の詳細設定を示す画像。

[機能の設定] ページのすべての手順を完了したら、[次へ] をクリックします。

次のページで [関数の作成] をクリックします。

[AWS] > [サービス] > [API ゲートウェイ] の順に移動します。

左側のメニューの [API] タブで、lambda スクリプト用に作成した API を選択します。

[/your_lambda_function_name] の下にある [任意] をクリックします。

上の [アクション] をクリックして、[メソッドのアクション] の [メソッドの削除] を選択します。

削除アクションを確認します。

[アクション] をもう一度クリックし、[リソースアクション] の下の [メソッドの作成] を選択します。

新しく作成したコンボボックスで [POST] を選択します。

チェックマークをクリックします。新しいページが開きます。

Lambda のリージョンを選択します。

lambda 関数の名前をフィールドに入力します。

ページの右下にある [保存] をクリックします。

[Lambda 関数への権限の追加] ダイアログを確認します。

もう一度 [アクション] をクリックし、[API アクション] で [API をデプロイ] を選択します。

[デプロイステージ] として [prod] を選択します。

[デプロイ] をクリックします。

Opsgenie Webhook インテグレーションの設定

[設定] → [統合] の順に移動します。Webhook を検索して [追加] を選択します。
AWS API Gateway が提供した API エンドポイントを [Webhook URL] テキストフィールドに入力します。
問題として Jira インストールにすべてのアラートを送信しないことで、テストの信頼性を高めるには、「jira」などのタグにタグの一致条件を含むアラートフィルターを追加します。統合に名前を付けます。この例では、LambdaJiraWebhook という名前にしました。
インテグレーションを設定したら、[インテグレーションを保存] をクリックします。

AWS Lambda インテグレーションのために Webhook を保存する場所を示すスクリーンショット。

統合のテスト

これでテストする準備ができました。jira タグで新しいアラートを作成します。

以前に設定されたデフォルトの Jira プロジェクトに移動し、アラートから問題が作成されるのを確認します。

また、作成したアラートに jiraProjectKey: プレフィックスが付いた新しいタグが割り当てられていることを確認します。このタグは、この Opsgenie アラートをタグに含まれている Jira の課題に関連付けるために使用されます。

実装された関数でサポートされている統合フロー

新しいアラートの作成時に新しい Jira の問題を作成するほか、この統合では次のフローも実装されます。

アラートに新しいメモを追加すると、新しいコメントが課題に追加されます
アラートを承認すると、問題の進捗状況が開始されます
アラートをクローズするか削除すると、問題もクローズされます。

これらのすべてのフローは、以下のシーケンス図に示されています。図の中のすべての項目は代表的なものであり、上記のシステムの実際の実装を反映していない可能性があることに注意してください。

もちろん、独自の要件を満たすためにコードをさらにカスタマイズすることができます。

CloudWatch ログによる Lambda ランタイムログと関数ログの監視

また、コンソールオブジェクト上に書き込んだログや AWS Lambda ランタイムが書き込んだログについても､CloudWatch ログを確認できます。最初に CloudWatch コンソールに移動します。

Amazon Web Services プラットフォームの CloudWatch の場所を示す画像。

[ログ] をクリックします。

Amazon Web Services プラットフォームのログの場所を示す画像。

Lambda 関数に関連付けられた [ロググループ]をクリックします。

Amazon Web Services プラットフォームのログストリームの場所を示す画像。

Last Event Time (最後のイベント時間) 別にソートした最後のログストリームのいずれかをクリックします。たとえば、最新のログストリームをクリックします。

Amazon Web Services プラットフォームのロググループの場所を示す画像。

ランタイムと関数自体によって書き込まれたログをチェックします。

自動設定された API ゲートウェイ API の確認

API ゲートウェイコンソールをチェックし、自動的に作成および設定されている内容を確認できます。最初にサービスコンソールに進んでください。

Amazon Web Services プラットフォームの API ゲートウェイの場所を示す画像。

次に、API である OpsGenieJiraIntegrationAPI をクリックし、セットアップされた内容を調べます。API を最初から作成し、API Gateway コンソールから Lambda 関数に関連付けることもできますが、Lambdaコンソールにはショートカットが用意されており、一部の詳細はそれ自体が管理します。