Workflow Automation を始める

概要

Workflow Automation を使用すると、Datadog のアラートやセキュリティシグナルに応じて、エンドツーエンドのプロセスを自動化できます。リアルタイムの可観測性データを活用することで、問題を迅速に解決し、システムの可用性とセキュリティを積極的に維持することが可能です。

このガイドに従って、モニターアラートによってトリガーされるカスタムワークフローを作成します。トリガーされると、ワークフローは Jira でタスクを作成し、Jira チケットへのリンクを含む通知を Slack に送信します。このガイドでは、ワークフローのあるステップから別のステップへのデータの渡し方、ワークフローの保存と公開、ワークフローの実行履歴の表示について説明します。

前提条件

開始する前に、Jira と Slack のインテグレーションを Datadog アカウントにインストールしておく必要があります。インストール手順については、Slack と Jira インテグレーションのドキュメントをご覧ください。

Jira と Slack のインテグレーションタイルでセットアップしたアカウント資格情報と認証は、Workflow Automation の Jira と Slack のアクションに自動的に反映されます。インテグレーションによっては、認証のための追加構成が必要です。詳細については、接続を参照してください。

ワークフローの構築

モニタートリガーを使用してワークフローを作成する

ワークフローは、モニターやセキュリティシグナルなどのアラート、スケジュール、または手動でトリガーすることができます。このケースでは、モニタートリガーを使用してワークフローを作成します。

ワークフローを作成します。

Workflow Automation ページから、New Workflow をクリックします。
ワークフローの名前と説明を入力します。ワークフローの例では、以下の名前と説明を使用しています。
名前: Create a Jira Ticket
説明: Create a Jira issue and Slack notification when there is a monitor alert

モニターを追加して構成します。

ワークフローキャンバスで、Add Trigger をクリックし、Monitor を選択します。
Configure タブの @workflow- の横に、ワークフローの一意の ID Create-Jira-Ticket を入力します。
ワークフローハンドルは常に @workflow- で始まります。後で、このハンドルを使用して、ワークフローをモニター通知に接続します。
Save をクリックしてワークフローを保存します。

Jira と Slack のアクションを追加する

Jira ステップを追加して構成します。

ワークフローキャンバスで、+ アイコンをクリックします。
Jira アクションを検索し、Create issue を選択します。
ワークフローキャンバスで、Create issue ステップをクリックします。
Configure タブで、Jira Account を選択します。アカウントは、Jira インテグレーションタイルの Accounts セクションにある Jira URL に対応している必要があります。
ワークフローが作成する Jira 課題の Project と Issue type を入力します。
ワークフローのトリガーとなるモニターからのデータを渡すためにコンテキスト変数を使用して、Jira 課題の Summary と Description を入力します。二重中括弧 ({{) で囲むことで、ステップ内のコンテキスト変数にアクセスできます。

以下の記述例では、ソース、トリガー、ワークフロー変数を使用して、以下を伝達します。
- モニターアラートのトリガーとなったソース
- 影響を受けたモニターへのリンク
- ワークフロー名、ワークフロー ID
```
The CPU usage is above the 95% threshold for {{ Trigger.hostname }}

Please investigate - see this Datadog Dashboard to view all workflow executions:
https://app.datadoghq.com/dash/integration/workflow_automation?refresh_mode=sliding&from_ts=1698164453793&to_ts=1698168053793&live=true.

The workflow that created this Jira issue is
{{ WorkflowName }} : {{ WorkflowId }}

The monitor that triggered the workflow can be found here: {{ Source.url }}
```
コンテキスト変数の詳細については、**コンテキスト変数**を参照してください。
Jira アクションをテストするには、Configure タブの Test をクリックします。アクションをテストすると、実際の Jira チケットが作成されます。
Save をクリックしてワークフローを保存します。

次に、Slack のステップを追加します。

ワークフローキャンバス上のプラスアイコンをクリックして、別のステップを追加します。
Slack を検索し、Send message を選択します。
Slack Workspace name を入力します。
Slack Channel name を入力します。
より便利な Slack 通知を行うには、ステップ出力変数を使用します。ステップ出力変数を使用すると、ワークフローの Jira ステップから Slack ステップにデータを渡すことができます。次のメッセージテキストを使用して、Slack メッセージに Jira 課題キー、モニター名、Jira 課題を含めます。
```
The monitor named {{ Source.monitor.name }} triggered and created a new Jira issue
{{ Steps.Create_issue.issueKey }}: {{ Steps.Create_issue.issueUrl }}

The workflow that created this Jira issue is {{ WorkflowName }}
```
アクションをテストするには、Configure タブの Test をクリックします。アクションをテストすると、実際の Slack メッセージが作成されます。
ワークフローの名前をモニターの通知ドロップダウンに表示するには、ワークフローを保存して公開します。ワークフローのページから Publish をクリックします。

ワークフローをテストして公開する

アクティブな Slack および Jira アカウントに接続されたワークフローをテストすると、実際の Slack メッセージや Jira チケットが作成されます。

Save をクリックし、ワークフローに変更を適用します。次に、手動でワークフローをトリガーしてテストします。

手動でワークフローをトリガーする場合は、ワークフローページから Run をクリックし、トリガー変数の値を入力します。

ワークフローを実行すると、Jira チケットが作成され、Slack メッセージが送信されることを確認します。

スケジュールされたワークフローやトリガーされたワークフローは、公開するまで自動的にトリガーされません。ワークフローのページから Publish をクリックして公開してください。

ワークフローをトリガーするモニターを更新する

Datadog の Monitors ページに移動します。
ワークフローのトリガーに使用するモニターを検索して編集するか、新しいモニターを作成します。
Configure notifications & automations セクションで、Add Workflow をクリックします。
ワークフローのメンション名 (@workflow-Create-Jira-Ticket) を使用してワークフローを検索し、ドロップダウンから選択します。
- ワークフローにトリガー変数を渡すには、@workflow-name(key=value, key=value) という構文のカンマ区切りリストを使用します。例えば、@workflow-Create-Jira-Ticket(hostname={{host.name}}) のようになります。
ワークフローとこのモニターのすべての通知をテストするには、Test Notifications をクリックします。
モニターを保存。

モニターのしきい値に達するたびに、モニターはワークフローの実行をトリガーします。

実行履歴

ワークフローをトリガーした後、Run History ビューで進捗状況を確認したり、失敗したステップをデバッグすることができます。実行されたステップを選択すると、入力、出力、実行コンテキスト、エラーメッセージを確認できます。以下の例は、無効な Jira 構成のために失敗したステップを示しています。