- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Datadog API を使用すると、Datadog との間でデータをやり取りできます。Datadog API は、リソース指向の URL とステータスコードを使用してリクエストの成功または失敗を示し、すべてのリクエストから JSON を返します。
この記事では、Postman を使用して Datadog への API 呼び出しを実行する方法を説明します。記事内では、Datadog API 内で使用可能なアクションを示し、Postman を使用して GET
、POST
、PUT
、および DELETE
を実行するための高度な概要を提供します。
以下が必要です。
Postman へのログインから始めます。Datadog は Postman アプリケーションをダウンロードすることをお勧めします。
このコレクションは Web 用 Postman またはお使いの Postman アプリケーションで動作します。読み込みに数秒かかることがあります。
Postman コレクションをインポートすると、Postman の左ペインに、使用できるすべての Datadog API 呼び出しの一覧がフォルダーごとに構造化されて表示されます。
コレクションには、Postman 環境である Datadog Authentication
が含まれます。ここに Datadog API キーと認証用のアプリケーションキーを追加します。
以下の手順に従って環境をセットアップします。
Postman の右上隅にある Environments ドロップダウンをクリックします。現時点で環境が選択されていない場合は、Environments ドロップダウンに No Environment
と表示されます。
Datadog Authentication を選択します
Datadog Authentication 環境を編集して Datadog API キーを api_key
変数の初期値および現在値として追加し、お使いの Datadog アプリケーションキーを application_key
変数の初期値および現在値として追加します。
https://api.datadoghq.com
以外の Datadog サイトにアクセスしている場合、別のエンドポイント URL にアクセスするには Postman コレクションに切り替える必要があります。
選択したサイト () へのインスタンスを更新するには、以下の手順に従います。
左ペインの Datadog API コレクションフォルダーで、メニュー (3 点リーダー) をクリックし、Edit を選択します。
Variables タブで、datadoghq.com
の値を持つ site
変数の選択を解除し、 の値を持つ
site
を選択します。
Update をクリックします。
セットアップが完了したら、いつでも API 呼び出しを行うことができます。Postman -> Datadog フォルダーには、Datadog API リファレンスに一覧表示されている各 API カテゴリタイプのサブフォルダーがあります。このサブフォルダーを展開すると、HTTP メソッドと API 呼び出し名を確認できます。
コレクション内の API 呼び出しをクリックすると、右側の Builder
ペインにロードされます。このペインで API 呼び出しを送信し、返されたステータス、応答時間、および API 応答コードを確認できます。
エンドポイント名をクリックすると、エンドポイントの説明と、すべての必須/オプションパラメーターが表示されるため、容易にリクエストを構築できます。
Params タブには、API 呼び出しに存在するすべてのパラメーターと値が表示されます。ここでは、パラメーターと値を追加できます。使用可能な引数は、Datadog API ドキュメントの対応するセクションで確認してください。
このタブは、API 呼び出しの param1:value1¶m2:value2
構造を表示する代わりに使用できます。
注:
<PLACEHOLDER>
の形式に従います。プレースホルダーはクエリを実行する前に置き換える必要があります。