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 を押して、テストのリクエストの設計を開始します。
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 をクリックするか、応答プレビューを直接クリックすることで、ステップごとに最大 10 個のアサーションを作成できます。
オプションで、応答ヘッダーまたは本文をパースすることにより、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 テストの任意のステップから変数を抽出してから、テストの後続のステップでその値を再挿入することができます。
以下の利用可能な組み込みの 1 つから値を定義してローカル変数を作成できます。
パターン | 説明 |
---|---|
{{ numeric(n) }} | n 桁の数字列を生成します。 |
{{ alphabetic(n) }} | n 文字のアルファベット文字列を生成します。 |
{{ alphanumeric(n) }} | n 文字の英数字文字列を生成します。 |
{{ date(n, format) }} | テストが開始された日付 + n 日の値を使用して、許容される形式のいずれかで日付を生成します。 |
{{ timestamp(n, unit) }} | テストが +/- n 選択単位で開始されたタイムスタンプの値を使用して、許容される単位のいずれかでタイムスタンプを生成します。 |
HTTP テストの URL、高度なオプション、アサーションで、Settings
で定義されたグローバル変数とローカルで定義された変数を使用できます。
変数のリストを表示するには、目的のフィールドに {{
と入力します。
ステップが 1 つまたは複数のアサーションを満たさない場合、またはステップのリクエストが時期尚早に失敗した場合、テストは FAILED
と見なされます。場合によっては、エンドポイントに対してアサーションをテストできずにテストが実際に失敗することがあります。これらの理由には次のものがあります。
エラー | 説明 |
---|---|
CONNRESET | 接続がリモートサーバーによって突然閉じられました。Web サーバーにエラーが発生した、応答中にシステムが停止した、Web サーバーへの接続が失われた、などの原因が考えられます。 |
DNS | テスト URL に対応する DNS エントリが見つかりませんでした。テスト URL の構成の誤り、DNS エントリの構成の誤りなどの原因が考えられます。 |
INVALID_REQUEST | テストのコンフィギュレーションが無効です (URL に入力ミスがあるなど)。 |
SSL | SSL 接続を実行できませんでした。詳細については、個別のエラーページを参照してください。 |
TIMEOUT | リクエストを一定時間内に完了できなかったことを示します。TIMEOUT には 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 ソケット接続、データ転送、アサーション) で発生したことを示します。 |