수집기 생성

새 수집기를 생성합니다. 이 작업은 관리자 권한을 요구합니다.

필요 권한

관리자 이상의 계정으로 이용할 수 있습니다.

HTTP 요청

POST /api/sonar/loggers

cURL 예시

curl -H "Authorization: Bearer <API_KEY>" \
     -d model_guid="cd09ae6f-fbc3-11ed-9320-02d178f999a6" \
     -d name="WTMP" \
     -d node_pair_guid="27102ae5-3698-44d4-aad5-4f2def80f275" \
     -d table_name="WTMP" \
     -d interval=5000 \
     -d 'configs={"path": "/var/log/wtmp"}' \
     -X POST https://HOSTNAME/api/sonar/loggers

요청 매개변수

키	필수	타입	설명	비고
guid	X	문자열	수집기 식별자	36자 GUID. 미설정 시 무작위 생성
model_guid	O	문자열	수집 모델 식별자	36자 GUID
name	O	문자열	수집기 이름	최소 1자, 최대 50자
description	X	문자열	수집기 설명	최대 2,000자
node_pair_guid	O	문자열	서버 쌍 식별자	36자
table_name	O	문자열	테이블 이름
sentry_guid	X	문자열	센트리 식별자
interval	X	32비트 정수	수집 간격	최소 `1000` (단위: 밀리초)
cron_schedule	X	문자열	수집 주기	CRON 문법에 따라 작성된 일정
asset_guid	X	문자열	자산 식별자	자산 IP 주소의 GUID
configs	X	문자열 키/값	설정	수집 유형별 설정 명세 확인

정상 응답

{}

오류 응답

필수 매개변수가 누락된 경우

HTTP 상태 코드 400 응답.

{
  "error_code": "null-argument",
  "error_msg": "name should be not null"
}

식별자가 GUID 형식이 아닌 경우

HTTP 상태 코드 400 응답

{
  "error_code": "invalid-param-type",
  "error_msg": "asset_guid should be guid type."
}

매개변수 값의 길이가 잘못된 경우

HTTP 상태 코드 400 응답.

{
  "error_code": "invalid-argument",
  "error_msg": "'name' must be less than or equal to 50 characters."
}

수집 일정 문법이 잘못된 경우

HTTP 상태 코드 400 응답.

{
  "error_code": "invalid-argument",
  "error_msg": "wrong cron expression format: * * * *"
}

수집 모델이 존재하지 않는 경우

HTTP 상태 코드 500 응답.

{
  "error_code": "illegal-state",
  "error_msg": "logger model not found: bd09ae6f-fbc3-11ed-9320-02d178f999a6"
}

서버 쌍이 존재하지 않는 경우

HTTP 상태 코드 500 응답.

{
  "error_code": "illegal-state",
  "error_msg": "node pair not found: 37102ae5-3698-44d4-aad5-4f2def80f275"
}

센트리가 존재하지 않는 경우

HTTP 상태 코드 500 응답.

{
  "error_code": "illegal-state",
  "error_msg": "sentry not found: test"
}

자산이 존재하지 않는 경우

{
  "error_code": "illegal-state",
  "error_msg": "asset not found: cd09ae6f-fbc3-11ed-9320-02d178f999a6"
}

관리 권한이 없는 경우

HTTP 상태 코드 500 응답.

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}