自動化

概要

例えば新しい Code Security の所見があった場合や定期的なスケジュールに基づいて、トリガーが起動したときに、Bits Code がセッションを開始し、その結果をプルリクエストまたは Slack 通知として配信する自動化を作成します。

[Automate with Bits] (Bits で自動化) というタイトルの下に、[Name] (名前)、[Author] (作成者)、[Last Run] (最後の実行) のような列と4つの行を持つテーブルがあります。

Bits Code の自動化で、次のことができます。

手動で各セッションを開始することなく、スケジュールに従ってコード修正を生成する。
新しい APM 推奨、不安定なテスト、または Code Security の所見など、他の Datadog 製品からの信号に対して Bits Code に応答させる。
結果として得られたコード変更を直接プルリクエストにルーティングしたり、Slack でチームに通知したりする。

前提条件

Bits Code の自動化を設定するには、次のすべての条件を満たしていなければなりません。

Datadog に Bits Code 書き込み (bits_dev_write) 権限がある。
Bits Codeのセットアップを完了している。
自動化が Slack通知を出力する予定の場合、Slack インテグレーションがセットアップされている。

自動化を作成する

カスタム自動化を作成することも、Datadog が提供する自動化テンプレートを使用することもできます。

[Automate with Bits] (Bits で自動化) というタイトルの下に、「カスタムプロンプト」や「毎週」などのフィールドを持つフォームが表示されます。

デフォルトで、新しく作成された自動化はアクティブになり、マイ自動化リストに表示されます。

カスタム自動化を作成する

Bits Code のカスタム自動化を作成するには:

Datadog で、Bits AI > Bits Code > 自動化 に移動します。
[New Automation] (新しい自動化) をクリックします。
[Automation name] (自動化名) フィールドに、自動化を説明する名前を入力してください。
[Trigger] (トリガー) セクションで、トリガーを設定します。
[Output] (出力) セクションで、1 つ以上の出力を設定します。
[Create Automation] (自動化を作成) または [Create & run now] (作成して今すぐ実行) をクリックします。

テンプレートから自動化を作成する

[Automation Templates] (自動化テンプレート) セクションに、Datadog 提供の自動化テンプレートがあります。これには次のものが含まれる場合があります:

APM 推奨に基づいて PR を作成: 特定のサービスに対する APM 推奨に基づいてプルリクエストを生成します。
リポジトリの頻繁なエラーを修正: カスタムプロンプトトリガーを使用して、Bits Code に過去 24 時間のログをスキャンさせ、最も頻繁なエラーを見つけて、修正を含むプルリクエストを開かせます。

テンプレートタイルをクリックすると、新しい自動化フォームに移動します。自動化を作成する前に、出力を設定する必要があります。

トリガー

トリガーは、自動化が実行されるタイミングと Bits Code が処理する対象を定義します。トリガーは、以下のコンポーネントの内最大3つで構成されます:

製品所見: Error Tracking の問題など、Datadog 内からの信号
カスタムプロンプト: 選択したリポジトリに対して何をするかを Bits Code に指示する自由形式の指示
スケジュール: 毎日または特定の曜日など、定期的な時間間隔

[Add Trigger] (トリガーを追加) をクリックして、コンポーネントを追加します。製品所見をスケジュールと組み合わせることも、カスタムプロンプトをスケジュールと組み合わせることも、製品所見を単独で使用することもできます。

自動化が特定の期間に作成できる Bits Code セッションの数を制限する (例えば、5 runs per Week) には、[トリガーを追加] > [Set max runs] (最大実行回数を設定) をクリックします。1 回の自動化実行で、複数のセッションが生成されることがあります。この設定を使用して、自動化が生成するプルリクエストや通知の量を制御します。

製品所見トリガー

所見トリガーは、別の Datadog 製品 (例えば、Error Tracking や Code Security) での新しい問題に反応して自動化を実行します。製品所見トリガーは単独で使用することができ、この場合は新しい所見があるたびに自動化が実行されます。または、スケジュールと、あなたが ([New findings within] (新しい所見の範囲) フィールド内で) 定義するルックバックウィンドウと一緒に使用することもできます。

製品所見トリガーを単独で使用する (新しい所見を即座に修正するため) ことは一般的ですが、スケジュールとルックバックウィンドウと組み合わせると、特定の時間帯に見られる新しい所見を監視することができます。例えば、デプロイが毎週水曜日に行われる場合、毎週木曜日に APM 推奨トリガーを実行し、24 時間のルックバックを行うように設定することができます。

製品所見トリガーをセットアップする際には、製品によって異なる追加のフィルターを設定できます。例えば、次のようにします。

不安定なテストは、リポジトリ、ブランチ (デフォルトはリポジトリのデフォルトブランチ)、およびステータスによるフィルタリングをサポートしています。
Code Security (SAST) は、リポジトリ、重大度、修正ルール、および Bits AI によって偽陽性として特定された所見を除外するトグルをサポートしています。

自動化をトリガーする所見はそれぞれ、単一のセッションに関連付けられています。複数の所見を 1 つのセッションまたはプルリクエストで修正することはできません。

カスタムプロンプトトリガー

カスタムプロンプトは、自動化が実行されるたびに、選択したリポジトリに対して何を行うかを自由形式のテキストで Bits Code に指示します。特定の Datadog シグナルに関連付けられない定期的なメンテナンスタスク (依存関係の更新やドキュメントの更新など) には、カスタムプロンプトを使用してください。