ワークフローの構築

This product is not supported for your selected Datadog site. ().

Workflow Automation ページから、ワークフローの作成や、既存のワークフローの編集ができます。このページには、ワークフローの所有者、トリガータイプ、各ワークフローが最後に変更および実行された日付、ワークフローが公開されているかどうかなど、既存のワークフローに関する情報が一覧表示されます。

  • ワークフローにカーソルを合わせると、ワークフローの削除、複製、または権限の編集を行うオプションが表示されます。
  • 自分が作成したワークフローのみを表示したい場合は、My workflows をトグルします。

ブループリントからワークフローを構築

  1. Blueprints (ブループリント) タブをクリックします。
  2. 必要に応じて、検索バーを使用して、名前、カテゴリー、インテグレーションでブループリントのリストを絞り込むことができます。
  3. 使用するブループリントを見つけてクリックします。ワークフローキャンバスが表示されます。
  4. Create From Blueprint をクリックします。ワークフローキャンバスが更新され、新しく作成されたワークフローが表示されます。
  5. ワークフローの新しい名前と説明を入力します。
  6. 必要に応じて、ワークフローに適用するタグを選択または入力します。Datadog タグの詳細については、タグ入門 を参照してください。
  7. 必要に応じて、ワークフローに適用する関連 サービス を選択します。
  8. 必要に応じて、ワークフローに関連付ける チーム を選択します。チームが存在しない場合は、名前を入力して作成できます。
  9. Save をクリックすると、変更が適用されます。
  10. 更新が必要なワークフローステップには、感嘆符が表示されます。変更したいワークフローの各ステップをクリックし、Configure タブの空欄に必要事項を入力します。
  11. ワークフローの修正が完了したら、Run をクリックしてワークフローをテストします。
  12. ワークフローを公開する準備ができたら、Publish をクリックします。公開されたワークフローには、ワークフローの実行数に基づいてコストが発生します。詳細については、Datadog 料金ページ を参照してください。

AI でワークフローを作成または編集する

何から始めたらよいかわからない場合は、AI でワークフローを自動生成するか、既存のワークフローを反復することができます。

ワークフローを生成するには、以下の手順に従います。

  1. Workflow Automation ページから、New Workflow をクリックします。
  2. Create a workflow with AI をクリックします。
  3. ワークフローの詳細なプロンプトを入力します。使用したいインテグレーションとアクションを指定します。
  4. 上向き矢印 () をクリックすると、ワークフローが作成されます。

既存のワークフローを反復するには、以下の手順に従います。

  1. 既存のワークフローから、Edit with AI をクリックします。
  2. ワークフローに追加したい動作の詳細なプロンプトを入力します。使用したいインテグレーションとアクションを含めます。
  3. 上向き矢印 () をクリックすると、機能がワークフローに追加されます。
Workflow Automation AI は、製品に関する質問には回答しません。質問やフィードバックがある場合は、Datadog Community Slack#workflows チャンネルに参加することをご検討ください

カスタムワークフローの作成

ワークフローを作成するには、Workflow Automation ページで New workflow をクリックします。

ワークフローを構成するには、以下の手順に従います。

  1. ワークフロー構成パネルで、ワークフローの Name を入力します。
  2. 必要に応じて、ワークフローに適用するタグを選択または入力します。Datadog タグの詳細については、タグ入門 を参照してください。
  3. 必要に応じて、ワークフローに適用する関連 サービス を選択します。
  4. 必要に応じて、ワークフローに関連付ける チーム を選択します。チームが存在しない場合は、名前を入力して作成できます。
  5. ワークフローで入力または出力パラメーターを使用する場合は、それらを入力してください。
  6. Save をクリックすると、変更が適用されます。

ワークフローの構成が不明な場合、ワークフローキャンバス上の任意の場所をクリックして、後でパネルに戻ることができます。

ワークフロービルダーでワークフローを構築する

  1. ワークフローにトリガーが必要な場合は、Add Trigger をクリックします。詳細については、「ワークフローをトリガーする」を参照してください。
  2. ワークフローにステップを追加し始めるには、Add Step をクリックします。
  3. 検索バーを使ってアクションを検索するか、インテグレーションとその関連アクションをブラウズして、望むアクションを見つけます。アクションをクリックすると、そのアクションはワークフローキャンバスのステップとして追加されます。
  4. ワークフローキャンバス内のステップをクリックして、構成、またはその出力やコンテキスト変数の表示を行います。出力とコンテキスト変数の詳細については、「コンテキスト変数」を参照してください。
  5. ステップの構成が完了したら、AI アイコン またはプラスアイコン (+) をクリックして別のステップを追加するか、ワークフローを保存してください。
  6. ワークフローを公開する準備ができたら、Publish をクリックします。公開されたワークフローには、ワークフローの実行数に基づいてコストが発生します。詳細については、Datadog 料金ページ を参照してください。

ワークフロー内のステップは、クリックすることでいつでも編集できます。ワークフロー上のステップをクリックしてドラッグすると、並べ替えることができます。

ショートカットとキャンバスツール

ワークフロービルダーキャンバスのキーボードショートカットとマウスショートカットを表示するには、? (shift+/) を入力するか、Keyboard ボタンをクリックします。ショートカットの一覧が表示されます。

Zoom outZoom in、および Reset viewport ボタンは、ビューポートの表示方法を制御します。

Auto layout ボタンを使用すると、ワークフローステップを整列および配置できます。

Add annotation ボタンを使用すると、ワークフローに注釈メモを追加できます。これらのメモには、太字や斜体、リンク、リストなどのさまざまなテキスト書式を追加するための書式設定バーが用意されています。注釈は Markdown で入力することもできます。

書式設定バーが上に表示された空の注釈

ステップをテストする

ステップをテストする方法については、テストとデバッグ のページを参照してください。

ワークフローの公開

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

公開されたワークフローには、ワークフローの実行数に基づいてコストが発生します。詳細については、Datadog 料金ページ を参照してください。

公開済みワークフローの更新

公開済みワークフローは、準備ができるまでライブバージョンに影響を与えることなく更新できます。

公開済みワークフローを編集すると、ドラフトが作成されます。ドラフトに変更を加えても、公開済みワークフローは変更されません。各ワークフローに 1 つのアクティブなドラフトを作るができ、すべての編集者がこれを変更できます。準備ができたら、Publish Changes をクリックすると、公開済みバージョンが置き換わります。

ドラフトは、通常のワークフローと同様に、構成されたすべてのステップを実行します。ドラフトはワークフローエディターからのみ実行できます。

ドラフトを破棄するには、エディターの右上隅にある cog icon をクリックし、Discard draft を選択します。

注記:

  • 公開済みワークフローのドラフトを実行しても、コストは発生しません。
  • ワークフローのプロパティ (名前、タグ、または通知) を更新すると、ドラフトフローはバイパスされて、公開済みバージョンに即座に適用されます。

変数とパラメーター

ワークフローでの変数とパラメーターの使用に関する詳細については、変数とパラメーター を参照してください。

ワークフロー通知

通知を送信して、成功したのか失敗したのかを知らせるように、ワークフローを構成できます。次のインテグレーションがサポートされています。

  • Slack
  • Microsoft Teams
  • PagerDuty
  • E メール

通知を追加するには、以下の手順に従います。

  1. ワークフロー設定パネルで、Notifications セクションまでスクロールダウンします。
  2. ワークフローが成功した場合に通知を追加するには、以下の手順に従います。
    1. Notify on success の横にあるプラス (+) アイコンをクリックします。
    2. 通知に使用するインテグレーションを選択します。
    3. 指定したインテグレーションに必要なフィールドに入力します。
    4. Save をクリックして、ワークフローを保存します。
  3. ワークフローが失敗した場合に通知を追加するには、以下の手順に従います。
    1. Notify on failure の横にあるプラス (+) アイコンをクリックします。
    2. 通知に使用するインテグレーションを選択します。
    3. 指定したインテグレーションに必要なフィールドに入力します。
    4. Save をクリックして、ワークフローを保存します。

エラー処理

オプションのエラーパスに進む前に、ワークフローで失敗したステップを再試行する回数と間隔を指定できます。エラーパスがない場合、すべての再試行が終了するとワークフローは終了します。

再試行

ステップの再試行を設定するには、以下の手順に従います。

  1. ワークフローキャンバスのステップをクリックします。
  2. Retries セクションで、IntervalMax retries の値を調整します。
  3. ワークフローを保存して、変更を適用します。

エラーパスを追加する

エラーが発生した場合にワークフローがたどるエラーパスを追加できます。

エラーパスを追加するには、以下の手順に従います。

  1. エラーパスを追加するステップにカーソルを合わせます。
  2. Error path アイコンをクリックしてドラッグし、 キャンバス上に新しいエラーパスを配置します。
  3. エラーパスに追加するワークフローステップを選択します。
  4. ステップの構成後、エラーパスにさらにステップを追加することも、エラーパスをメインのワークフローパスにマージすることもできます。
  5. エラーパスのステップの構成が完了したら、Save をクリックして変更を適用します。

条件まで待機

一部のアクションでは、ワークフローがステップを完了としてマークし、続行する前に満たさなければならない条件を追加できます。

条件を追加するには、以下の手順に従います。

  1. ワークフローキャンバスのステップをクリックします。
  2. Wait until condition セクションで、ドロップダウンを使用して事前構成済みの条件を選択するか、Configure custom wait condition を選択して独自の条件を作成します。
    • 利用可能な事前構成済み条件のリストは、アクションによって異なります。
    • 条件文の変数には、文字列、数値、ブール値、またはステップ出力変数を使用できます。
    • カスタム条件文で使用できるのは、現在のステップの出力変数のみです。
  3. ワークフローの最大待機時間を入力します。時間内に条件が満たされないと、ステップは失敗します。
「条件まで待機」の例

JSON でワークフローを編集する

ワークフローページで Edit JSON Spec をクリックして、JSON でワークフローを編集します。JSON エディターでは、以下の操作も可能です。

  • Format JSON: JSON を整形します。
  • Export JSON: ワークフローをダウンロードします。

API を使用してワークフローを操作する

API を使用してタスクを実行するには、Workflow Automation API ドキュメント を参照してください。

参考資料


ご質問やフィードバックがある場合は、Datadog Community Slack#workflows チャンネルにご参加ください。