Datadog API と Postman の使用
Incident Management が一般に使用できるようになりました。 Incident Management が広範に使用できるようになりました。

Datadog API と Postman の使用

概要

Datadog API を使用すると、Datadog との間でデータをやり取りできます。Datadog API は、リソース指向の URL とステータスコードを使用してリクエストの成功または失敗を示し、すべてのリクエストから JSON を返します。

この記事では、Postman を使用して Datadog への API 呼び出しを実行する方法を説明します。記事内では、Datadog API 内で使用可能なアクションを示し、Postman を使用して GETPOSTPUT、および DELETE を実行するための高度な概要を提供します。

前提条件

以下が必要です。

セットアップ

Postman に Datadog コレクションをインポート


このコレクションは Web 用 Postman またはお使いの Postman アプリケーションで動作します。読み込みに数秒かかることがあります。

Postman 環境のセットアップ

Postman コレクションをインポートすると、Postman の左ペインに、使用できるすべての Datadog API 呼び出しの一覧がフォルダーごとに構造化されて表示されます。

Authentication

コレクションには、Postman 環境である Datadog Authentication が含まれます。ここに Datadog API キーと認証用のアプリケーションキーを追加します。

以下の手順に従って環境をセットアップします。

  1. Postman の右上隅にある Manage Environments の歯車アイコンをクリックします。

  2. Datadog Authentication を選択します

  3. Edit をクリックします。

  4. Datadog API キーapi_key 変数の初期値および現在値として追加し、お使いの Datadog アプリケーションキーapplication_key 変数の初期値および現在値として追加します。

EU API エンドポイントに切り替える

デフォルトエンドポイントの URL ではなく、EU リージョンの Datadog アプリケーションにアクセスしている場合は、EU エンドポイント URL https://api.datadoghq.eu からアクセスするように Postman コレクションを切り替える必要があります。

以下の手順に従って、EU インスタンスを更新します。

  1. 左ペインの Datadog API コレクションフォルダーで、メニュー (3 点リーダー) をクリックし、Edit を選択します。
  1. Variables タブで、datadoghq.com の値を持つ site 変数の選択を解除し、datadoghq.eu の変数を持つ site を選択します。
  1. Update をクリックします。

コレクションの使用

セットアップが完了したら、いつでも API 呼び出しを行うことができます。Postman -> Datadog フォルダーには、Datadog API リファレンスに一覧表示されている各 API カテゴリタイプのサブフォルダーがあります。このサブフォルダーを展開すると、HTTP メソッドと API 呼び出し名を確認できます。

ビルダー

コレクション内の API 呼び出しをクリックすると、右側の Builder ペインにロードされます。このペインで API 呼び出しを送信し、返されたステータス、応答時間、および API 応答コードを確認できます。

説明

エンドポイント名をクリックすると、エンドポイントの説明と、すべての必須/オプションパラメーターが表示されるため、容易にリクエストを構築できます。

Params

Params タブには、現在 API 呼び出しに存在するすべてのパラメーターと値が表示されます。ここで、パラメーターと値を追加できます。使用可能な引数は、Datadog API ドキュメント の対応するセクションで確認してください。

このタブは、API 呼び出しの param1:value1¶m2:value2 構造を表示する代わりに使用できます。

:

  • params テーブルでは、アンパサンド (&) とコロン (:) は不要です。Postman によって挿入されます。
  • すべてのプレースホルダーは <PLACEHOLDER> の形式に従います。プレースホルダーはクエリを実行する前に置き換える必要があります。