メインコンテンツへスキップ

トリガー

フローを作成する際、最初のノードは必ずフローを開始するトリガーノードです。トリガーノードは、フロー内のすべての下流ノードにデータを提供します。このデータは、フィルターやその他のノードで使用できます。

What should start your flow

トリガーには 4 種類あります。

1 つのフローに設定できるトリガーノードは 1 つだけです。スケジュール・Webhook・イベントトリガーは、フローが公開された後にのみ実行されます。手動トリガーは、公開済みのフローをエディタからオンデマンドで実行できます。

Custom schedule

Custom schedule は、特定の時刻や繰り返し間隔でフローを実行する必要がある場合に便利です。例えば、毎日午前 9:00 に Google Cloud Compute Engine インスタンスの利用率をチェックする場合などです。

  • 設定オプション:Time zoneStart dateTimeFrequency

  • Frequency は、フローがどの頻度でトリガーされるかを定義します。指定できる値:DailyWeeklyMonthlyCustomRun once

    • Daily を選択すると、1 日の中で特定の時刻にフローを実行できます。実行間隔の最小値は 1 時間で、24 時間あたり最大 24 回までスケジュールできます。

    • 繰り返し間隔でフローを実行する必要がある場合は Custom を選択してください。指定できる値:HourDayWeekMonth。例えば、2 時間ごとや 2 週間ごとなどです。

    • Run once を選択すると、任意の時刻に 1 回だけ実行される単発のフローをスケジュールできます。レガシーサーバーの OS カーネル更新や、メンテナンスウィンドウ中のパッチ適用など、一度きりのアクションに便利です。

以下はカスタムスケジュールの例です。

Condition configuration

Manual trigger

この種類のトリガーは、フローをオンデマンドでのみ実行したい場合に使用します。人による確認を保証しつつ柔軟性も提供し、必要に応じてフローの実行を制御できます。

手動トリガーでフローを開始するには、フローを公開した後、CloudFlow エディタ上部のバーで Run を選択してください。

Condition configuration

Webhook trigger

Webhook トリガーを使用すると、API からのデータを使ってフローを開始できます。そのため、API コールが可能な外部システムであれば、どれでもフローをトリガーできます。例えば、Zapier の Run flow アクションを使用してフローをトリガーできます。あわせて DoiT Integrations も参照してください。

データ構造を検出するために、JSON のサンプルを提供する必要があります。構造が検出されると、その後のアクションに必要なフィールドがフロー内に自動的に作成されます。これにより、データはフローの一部となり、他のデータと同様に任意のアクティビティノードで使用できます。

Webhook trigger configuration

  • Webhook URL:このフローをトリガーするデータを送信するサービスの URL を指定します。

  • Sample JSON:データ構造を検出するために JSON のサンプルを指定します。Detected structure を選択して、フィールドが正しく特定されていることを確認してください。正しくないと思われる場合は、JSON サンプルを修正して再度貼り付けてください。

  • Generate API key:トリガーノードから DoiT API キー を作成して、DoiT Cloud Intelligence の Profile を開かずに済むようにできます。すでに API キーがある場合は、Profile ページで API キーを管理 するためのリンクがパネルに表示されます。このキーは DoiT API にのみ使用されます。

DoiT Cloud Intelligence event trigger

DoiT Cloud Intelligence event trigger を使用すると、DoiT Cloud Intelligence によって生成されたイベントを使ってフローを開始できます。イベントには次の 3 つのカテゴリがあります。

  • DoiT Cloud Intelligence events:フローを開始するために使用できる DoiT Cloud Intelligence のイベント

  • AWS にのみ適用されます。 AWS CloudTrail:AWS CloudTrail からのイベント(例:EC2 インスタンスの起動や停止、RDS インスタンスの作成や変更など)

  • anomaly detection(請求および/または real-time)が構成されている任意のクラウドで利用可能です。 Cost anomaly detection:コストアノマリーが作成または更新されたときに発火します。

DoiT Cloud Intelligence events

DoiT Cloud Intelligence は、フローをトリガーするプラットフォームイベントを発行できます。DoiT Cloud Intelligence イベントを選択すると、Event payload details にフロー内で参照できるフィールドが表示されます。

Cost anomaly detection

次のいずれかのコストアノマーリーイベントが発生したときにフローをトリガーできます。

  • DoiT Cost Anomaly Acknowledged Changed:アノマリーが確認された、または確認内容が編集されたとき
  • DoiT Cost Anomaly Cost Changed:アクティブなアノマリーのコストが変更されたとき
  • DoiT Cost Anomaly Created:新しいコストアノマリーが検出されたとき
  • DoiT Cost Anomaly Severity Changed:アノマリーの重大度が変更されたとき
  • DoiT Cost Anomaly Status Changed:ステータスが変更されたとき(例:Active から Inactive など)
  • DoiT Cost Anomaly Top SKUs Changed:アノマリーに最も寄与している SKU が変更されたとき
注意

コストアノマリーに対してフローをトリガーするには、real-time cost anomaly detection を構成しておく必要があります。

Event trigger configuration

  • Select an event:フローをトリガーしたい DoiT Cloud Intelligence イベントを一覧から選択します。

  • Event payload details:選択したイベント内で利用可能な参照フィールドの一覧が表示されます。これらのフィールドをフロー内で参照できます。

イベントへの対応を自動化する

フローが DoiT Cloud Intelligence event trigger(DoiT Cloud Intelligence events、AWS CloudTrail、または cost anomaly detection)によって開始された場合、Slack への投稿、チケットの作成、是正措置の実行など、対応処理を自動化できます。下流ノードで Event payload details のフィールドを参照してください。

  • Notification ノード を追加して、イベントの詳細をチームに送信します。メッセージ内で、ペイロードフィールド(例:コストアノマリーの anomaly ID と cost、または AWS CloudTrail イベントの resource ARN)を使用してください。

  • Branch ノード を使用して、ペイロードに応じて異なるステップを実行します。例えば、コストアノマリーの重大度が高い場合のみ通知したり、特定の AWS イベントタイプに対してのみアクションを実行したりできます。

Trigger node results

このセクションでは、下流ノードから参照できるトリガーノード出力内のフィールドを一覧表示します。Webhook および DoiT Cloud Intelligence event トリガーの場合、ノード出力にはイベント固有のペイロードフィールド(例:コストアノマーリーイベントの anomaly ID や cost)も含まれます。これらのフィールドはトリガー設定時に Event payload details に表示され、他のトリガー出力と同様に参照できます。

注意

ノードを設定する際、通常は出力を参照する上流ノードを 1 つ選択します。Schedule トリガーノードは例外で、その出力はフロー内の任意のノードから、選択したノードに加えて参照できます。

トリガー結果には、旧形式と ISO 8601 形式の両方の日付と時刻が含まれます。API が ISO 8601 タイムスタンプを必要とする場合は iso8601 オブジェクトを使用してください。既存の currentDate および startTime フィールドは後方互換性のために残されています。

Name説明例の値
currentDate実行日(YYYY-MM-DD 形式)2026-02-09
currentDay月内の日(1–31)9
currentMonth月(1–12)2
currentYear4 桁の年2026
customerIdDoiT カスタマーまたは組織の識別子ABCDeFhijKLm1nopQrStUVwx
ownerEmailフロー所有者のメールアドレス[email protected]
startTimeUnix タイムスタンプ(ミリ秒)1770644776279
startTimeMillisUnix タイムスタンプ(ミリ秒)1770644776279
startTimeSecondsUnix タイムスタンプ(秒)1770644776
userIdDoiT ユーザー識別子aBBCDe1FG2hIJkL34MNO
iso8601ISO 8601 形式の日付と時刻文字列を持つオブジェクト:
  • currentDate(YYYY-MM-DDT00:00:00.000Z)
  • startTime(YYYY-MM-DDTHH:mm:ss.sssZ)
currentDate: "2026-02-09T00:00:00.000Z", startTime: "2026-02-09T15:21:01.760Z"
variablesグローバルおよびローカルのフローバリアブルglobalVariables: {}localVariables: {}
billingScopesカスタマー向けのクラウドプロジェクトおよびアカウント識別子の一覧。各キーには idname を持つオブジェクトの配列が含まれます。
  • google-cloud — GCP プロジェクト ID
  • amazon-web-services — AWS アカウント ID
  • microsoft-azure — Azure サブスクリプション ID
下流ノードでクラウドスコープごとのループやフィルターに使用します。
google-cloud: [{id: "my-project", name: "My GCP Project"}], amazon-web-services: [...], microsoft-azure: [...]
billingScopesRowCount3 つのプロバイダー(GCP + AWS + Azure)のすべてを合計したクラウドスコープの総数3
ヒント

GCP プロジェクト、AWS アカウント、Azure サブスクリプションごとにアクションを実行する必要がある場合は billingScopes を使用してください。例えば、トリガーノードの Variables を参照するループやフィルターなどです。

イベントトリガーの例

トリガーからの応答を自動化し、例えば Slack への投稿、チケットの作成、または是正措置の実行などを行うことができます。

例えば、DoiT Cost Anomaly Created をトリガーとするフローでは、Branch ノード を使用して、重要度が Critical のアノマリーのみをフィルターできます。続いて、Notification ノード がアノマリー ID とコストを含むメッセージを送信します。これらの値はトリガーノードの出力から取得され、任意の下流ノードにマッピングできます。