Datadog API를 사용하면 Datadog와 데이터를 주고받을 수 있습니다. Datadog API는 리소스 지향 URL과 상태 코드를 사용하여 요청의 성공/실패 여부를 표시하고 모든 요청에서 JSON을 반환합니다.
이번 가이드에서는 Postman을 사용하여 Datadog에 API 호출을 수행하는 방법을 설명합니다. Datadog API 내에서 사용 가능한 액션을 보여드리는 한편, Postman을 사용하여 GET, POST, PUT, DELETE를 수행하는 방법을 간략하게 안내하겠습니다.
먼저 갖추어야 할 요소는 다음과 같습니다.
먼저 Postman에 로그인해주세요. Datadog에서는 Postman 애플리케이션을 다운로드하시길 권장합니다.
이 컬렉션은 웹용 Postman 또는 Postman 애플리케이션에서 작동합니다. 불러오는 데 몇 초 정도 소요될 수 있습니다.
Postman 컬렉션을 불러왔다면 사용 가능한 Datadog API 호출의 전체 목록이 Postman 왼쪽 화면에 폴더별로 구성됩니다.
컬렉션에는 Postman 환경인 Datadog Authentication이 포함됩니다. 여기에 Datadog API 키와 인증용 애플리케이션 키를 추가합니다.
다음 절차를 따라 환경 설정을 완료해주세요.
Postman 오른쪽 상단 코너에 있는 Environments 드롭다운을 클릭합니다. 선택된 환경이 없는 경우 Environments 드롭다운은 No Environment로 표시됩니다.
Datadog Authentication을 선택합니다.
Datadog Authentication 환경을 편집하여 Datadog API 키를 api_key 변수의 초기값 및 현재값으로 추가하고, 사용 중인 Datadog 애플리케이션 키를 application_key 변수의 초기값 및 현재값으로 추가합니다.
Datadog 사이트를 https://api.datadoghq.com이 아닌 다른 주소로 액세스 중이라면 Postman 컬렉션이 다른 엔드포인트 URL에 액세스하도록 변경해야 합니다.
다음 절차를 따라 원하는 사이트()로 인스턴스를 업데이트하세요.
왼쪽 화면의 Datadog API 컬렉션 폴더에서 점 세 개로 표시된 메뉴를 클릭하고 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> 형식을 따릅니다. 플레이스홀더는 쿼리를 실행하기 전에 교체해야 합니다.