본문으로 건너뛰기

6. 애플리케이션 그룹관리

이 장에서 하는 일​

애플리케이션 그룹을 API 로 관리합니다. 그룹은 인스턴스를 서비스 단위로 묶는 단위이며, 콘솔의 화면 대부분이 이 단위로 데이터를 보여 줍니다.

언제 쓰나 — 배포 자동화에서 새 서비스를 올릴 때 그룹도 함께 만들어 두는 식으로 씁니다. 그룹 이름은 에이전트 설정의 application.name 과 맞춰야 인스턴스가 그 그룹에 들어갑니다.

애플리케이션 그룹​

조회​

등록된 애플리케이션 그룹과 각 그룹에 속한 호스트·인스턴스를 받아 옵니다.

항목설명
URL/monitoring/api/metrics/APP?exclusion=false
URL 요청 예시/monitoring/api/metrics/APP?exclusion=false
HTTP METHODGET
Content-Typeapplication/json; charset=UTF-8
Body
Response아래 참고

응답 예시

{
  "applications": [
    {
      "name": "ALL",
      "uuid": "87DC0B05-AB5C-4667-9493-CB08D8619E84",
      "builtIn": false,
      "enable": true,
      "firstDate": 1527052065813,
      "lastDate": 1534469380921,
      "hosts": [ … ]
    }
  ]
}

firstDate · lastDate 는 이 그룹에서 데이터가 처음·마지막으로 들어온 시각(Unix Epoch 밀리초)입니다. builtIn 이 true 면 제품이 만든 그룹이라 이름을 바꾸거나 지울 수 없습니다.

등록​

새 그룹을 만듭니다. 에이전트 설정의 application.name 과 이름을 맞춰야 그 인스턴스가 이 그룹에 들어옵니다.

항목설명
URL/monitoring/api/customgroup/group
URL 요청 예시/monitoring/api/customgroup/group
HTTP METHODPUT
Content-Typeapplication/json; charset=UTF-8
Body{groupId: "EAP_GROUPS1", uuid: "89A43B84-7D49-466C-A172-8F28AAA29ED9"}
Response{"status": 200}

수정 및 인스턴스 정규식 등록​

그룹 이름을 바꾸거나, 인스턴스를 정규식으로 묶습니다. 이름 규칙이 정해진 환경에서는 정규식 하나로 새 인스턴스가 자동으로 들어옵니다.

항목설명
URL/monitoring/api/customgroup/uuid/${UUID}
URL 요청 예시/monitoring/api/customgroup/uuid/89A43B84-7D49-466C-A172-8F28AAA29ED9
HTTP METHODPUT
Content-Typeapplication/json; charset=UTF-8
Body{ uuid: "89A43B84-7D49-466C-A172-8F28AAA29ED9", groupId: "EAP_GROUPS", regexp: "^eap71-.*"}
Response{"status": 200}

삭제​

그룹을 지웁니다. 수집된 데이터는 지워지지 않고 그룹 묶음만 사라집니다.

항목설명
URL/monitoring/api/customgroup/uuid/${UUID}
URL 요청 예시/monitoring/api/customgroup/uuid/89A43B84-7D49-466C-A172-8F28AAA29ED9
HTTP METHODDELETE
Content-Typeapplication/json; charset=UTF-8
Body
Response{"status": 200}