Multistep API テストを使用すると、**HTTP テスト**をチェーンして、主要なサービスの高度なジャーニーがいつでもどこからでも利用できることを事前に監視できます。
サービスの 1 つが応答遅延を起こしたり、予期しない方法 (たとえば、予期しない応答本文、ステータスコードなど) で応答を開始した場合、テストはチームに警告する、CI パイプラインをブロックする、または障害のあるデプロイをロールバックすることができます。
Multistep API テストは、Datadog 管理ロケーションおよびプライベートロケーションから実行できるため、外部と内部の両方でシステムを完全にカバーできます。
注: Multistep API テストを使用すると、1 つのテストで複数の HTTP リクエストをリンクできます。サービスに対する単一のリクエストを実行する場合は、API テストを利用できます。
env タグとその他のタグを追加します。次に、これらのタグを使用して、Synthetic Monitoring ホームページで Synthetic テストをすばやくフィルタリングできます。Multistep API テストを実行するロケーションを選択します。Multistep API テストは、ネットワークの外部または内部のどちらからテストを実行するかによって、管理ロケーションとプライベートロケーションの両方から実行できます。
Create Your First Request を押して、テストのリクエストの設計を開始します。
注: デフォルトでは、最大 10 個のステップを作成できます。Datadog サポートチームに連絡して増やしてください。
GET、POST、PATCH、PUT、HEAD、DELETE、OPTIONS です。http と https の両方の URL がサポートされています。user-agent ヘッダー) をオーバーライドすることもできます。<COOKIE_NAME1>=<COOKIE_VALUE1>; <COOKIE_NAME2>=<COOKIE_VALUE2> の形式を使用して複数のクッキーを設定します。text/plain、application/json、text/xml、text/html、または None) を選択します。http://<YOUR_USER>:<YOUR_PWD>@<YOUR_IP>:<YOUR_PORT>) を指定します。Test URL をクリックして、リクエストのコンフィギュレーションをテストします。応答プレビューが表示されます。
アサーションは、期待されるテスト結果が何であるかを定義します。Test URL を押すと、response time、status code、header、content-type の基本的なアサーションが、取得された応答に基づいて追加されます。Multistep API テストでは、アサーションはオプションです。
| タイプ | 演算子 | 値の型 |
|---|---|---|
| 本文 | contains、does not contain、is、is not、matches、does not match、jsonpath | String Regex String、Regex |
| ヘッダー | contains、does not contain、is、is not、matches、does not match | String _Regex |
| response time | is less than | 整数 (ms) |
| ステータスコード | is、is not | 整数 |
注: HTTP テストでは、br、deflate、gzip、identity の content-encoding ヘッダーを使用して本文の圧縮を解除することが可能です。
New Assertion をクリックするか、応答プレビューを直接クリックすることで、ステップごとに最大 20 個のアサーションを作成できます。
Continue with test if this step fails (このステップが失敗した場合にテストを続行する) 設定により、ステップが失敗した場合でも、マルチステップ API テストを後続のステップに進めることができます。これは、テストが自動的にクリーンアップできることを確認するのに特に役立ちます。たとえば、テストでは、最初にリソースを作成し、そのリソースに対していくつかのアクションを実行し、そのリソースの削除で終了する場合があります。中間ステップの 1 つが失敗した場合でも、テストの最後にリソースを削除して、誤検知の生成を回避する必要があります。これは、すべての中間ステップで Continue with test if this step fails (このステップが失敗した場合にテストを続行する) を使用して行うことができます。
また、中間ステップで Consider entire test as failed if this step fails (このステップが失敗した場合、テスト全体を失敗と見なす) 設定をアクティブにして、エンドポイントの 1 つが期待どおりに応答しない場合でも、テスト全体でアラートが生成されるようにする必要があります。
同様に、マルチステップ API テストがさまざまなエンドポイントで実行される場合、2 つの失敗動作設定により、1 つまたは複数の API エンドポイントで問題が発生した場合でも、テストがすべてのリクエストを確実に実行できるようになります。
オプションで、応答ヘッダーまたは本文をパースすることにより、HTTP リクエストの応答から変数を抽出することもできます。変数の値は、HTTP リクエストステップが実行されるたびに更新されます。
変数をパースするには
Variable Name を入力します。変数名に使用できるのは大文字、数字、アンダースコアのみです。また、3 文字以上にする必要があります。
変数を応答ヘッダーから抽出するか、本文から抽出するか決定します。
作成されたこの変数は、Multistep API テストの次の手順で使用できます。
Multistep API テストは次の頻度で実行できます。
アラート条件で、テストが失敗しアラートをトリガーする状況を設定します。
アラートの条件を An alert is triggered if any assertion fails for X minutes from any n of N locations に設定すると、次の 2 つの条件が当てはまる場合にのみアラートがトリガーされます。
テスト結果が失敗した場合、テストによって再試行をトリガーすることができます。デフォルトでは、再試行は最初に失敗したテスト結果の 300 ミリ秒後に実行されます。この間隔は API を介して構成できます。
ロケーションのアップタイムは、評価ごとに計算されます (評価前の最後のテスト結果がアップかダウンか)。合計アップタイムは、構成されたアラート条件に基づいて計算されます。送信される通知は、合計アップタイムに基づきます。
以前に定義されたアラート条件に基づいて、テストによって通知が送信されます。このセクションを使用して、チームに送信するメッセージの方法と内容を定義します。
モニターと同様、メッセージに @notification を追加するか、ドロップダウンボックスでチームメンバーと接続されたインテグレーションを検索して、通知を受信するユーザーやサービスを選択します。
テストの通知メッセージを入力します。このフィールドでは、標準のマークダウン形式のほか、以下の条件付き変数を使用できます。
| 条件付き変数 | 説明 |
|---|---|
{{#is_alert}} | テストがアラートを発する場合に表示します。 |
{{^is_alert}} | テストがアラートを発しない限り表示します。 |
{{#is_recovery}} | テストがアラートから回復したときに表示します。 |
{{^is_recovery}} | テストがアラートから回復しない限り表示します。 |
テストが失敗した場合に、テストで通知メッセージを再送信する頻度を指定します。テストの失敗を再通知しない場合は、Never renotify if the monitor has not been resolved オプションを使用してください。
Save をクリックしてテストを保存し、Datadog にテストの実行を開始させます。
Multistep API テストの任意のステップから変数を抽出してから、テストの後続のステップでその値を再挿入することができます。
テストコンフィギュレーションフォームの右上隅にある Create Local Variable をクリックすると、ローカル変数を作成できます。以下の利用可能なビルトインのいずれかから値を定義できます。
{{ numeric(n) }}n 桁の数字列を生成します。{{ alphabetic(n) }}n 文字のアルファベット文字列を生成します。{{ alphanumeric(n) }}n 文字の英数字文字列を生成します。{{ date(n, format) }}n 日の値を使用して、許容される形式のいずれかで日付を生成します。{{ timestamp(n, unit) }}n 選択単位で開始されたタイムスタンプの値を使用して、許容される単位のいずれかでタイムスタンプを生成します。HTTP テストの URL、高度なオプション、アサーションで、Settings で定義されたグローバル変数とローカルで定義された変数を使用できます。
変数のリストを表示するには、目的のフィールドに {{ と入力します。
ステップが 1 つまたは複数のアサーションを満たさない場合、またはステップのリクエストが時期尚早に失敗した場合、テストは FAILED と見なされます。場合によっては、エンドポイントに対してアサーションをテストできずにテストが実際に失敗することがあります。これらの理由には次のものがあります。
CONNRESETDNSINVALID_REQUESTSSLTIMEOUTTIMEOUT には 2 種類あります。TIMEOUT: The request couldn’t be completed in a reasonable time. は、タイムアウトが TCP ソケットの接続レベルで発生したことを示します。TIMEOUT: Retrieving the response couldn’t be completed in a reasonable time. は、タイムアウトがリクエストの実行全体 (TCP ソケット接続、データ転送、アサーション) で発生したことを示します。
