서버 로그 수집 정보 설정

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

설명

서버의 로그 수집 정보를 설정 하는 API 입니다.

요청

POST https://cloudloganalytics.apigw.fin-ntruss.com/api/{regionCode}-v1/vpc/servers/collecting-infos

요청 헤더

헤더명	설명
x-ncp-apigw-timestamp	1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-apigw-api-key	APIGW에서 발급받은 키 값 `x-ncp-apigw-api-key:{API Gateway API Key}`
x-ncp-iam-access-key	네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값 `x-ncp-iam-access-key:{Account Access Key}`
x-ncp-apigw-signature-v2	Access Key ID 값과 Secret Key로 암호화한 서명 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	Request body content type을 application/json으로 지정 `Content-Type: application/json`

요청 바디

Parameter 이름	Parameter 설명	필수 여부	Available Values	Data Type
collectingInfos	로그 설정 리스트	Y		List<CollectingInfo>

CollectingInfo

Parameter 이름	Parameter 설명	필수 여부	Available Values	Data Type
logPath	수집할 로그의 경로	Y	ex) /var/log/messages, /var/log/secure*	String
logTemplate	수집할 로그의 템플릿	Y	ex) CUSTOM_LOG, APACHE, TOMCAT	String
logType	로그 타입	Y	ex) SYSLOG, security_log, apache, tomcat	String
osType	수집할 서버의 OS Type	Y	서버 목록 조회 API에서 osInformation 값을 사용합니다.	String
servername	수집할 서버 명	Y	서버 목록 조회 API에서 servername 값을 사용합니다. ex) cla-test	String
instanceNo	수집할 서버의 instanceNo	Y	서버 목록 조회 API에서 instanceNo 값을 사용합니다. ex) 1234567	Integer
macAddr	수집할 서버의 macAddress	Y	서버 목록 조회 API에서 macAddr 값 사용 ex) "FF:FF:FF:FF:FF:FF"	String
ip	수집할 서버의 IP Address	Y	서버 목록 조회 API에서 ip 값 사용 ex) "123.123.123.123"	String

요청 예시

POST https://cloudloganalytics.apigw.fin-ntruss.com/api/{regionCode}-v1/vpc/servers/collecting-infos
HOST: cloudloganalytics.apigw.fin-ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: FJSBB4K3XnaGAvVe0Hzj3/2hfNWvgLHR1rQHW2Et2Rs=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 11IKBWgQegM4DwiJL4mo

{
    "collectingInfos": [
    {
      "logPath": "/var/log/messages",
      "logTemplate": "SYSLOG",
      "logType": "SYSLOG",
      "servername": "s172353dfd86",
      "osType": "Rocky Linux 8.8",
      "ip": "123.123.123.123",
      "instanceNo": 1111111,
      "macAddr":  "FF:FF:FF:FF:FF:FF"
    },
    {
      "logPath": "/var/log/mysql/error.log",
      "logTemplate": "MySQL",
      "logType": "mysql_error",
      "servername": "s172353dfd86",
      "osType": "Rocky Linux 8.8",
      "ip": "123.123.123.123",
      "instanceNo": 1111111,
      "macAddr":  "FF:FF:FF:FF:FF:FF"
    }
    ]
}

curl -X POST "https://cloudloganalytics.apigw.fin-ntruss.com/api/{regionCode}-v1/vpc/servers/collecting-infos" 
-H "accept: application/json" 
-H "Content-Type: application/json" 
-H "x-ncp-iam-access-key: FFAC5601475F0820A48F" 
-H "x-ncp-apigw-timestamp: 1594016329121" 
-H "x-ncp-apigw-signature-v2: /k1KmEmUAiNxrFKRVOXaPTqvmdlHodIO/9qGFpCqMjOM=" 
-d "{\"collectingInfos\": [{ \"logPath\": \"/var/log/messages\", \"logTemplate\": \"SYSLOG\", \"logType\": \"SYSLOG\", \"servername\": \"s172353dfd86\", \"osType\": \"Rocky Linux 8.8\", \"ip\": \"123.123.123.123\", \"instanceNo\": 1111111},{ \"logPath\": \"/var/log/mysql/error.log\", \"logTemplate\": \"MySQL\", \"logType\": \"mysql_error\", \"servername\": \"s172353dfd86\", \"osType\": \"Rocky Linux 8.8\", \"ip\": \"123.123.123.123\", \"instanceNo\": 1111111,\"macAddr\":  \"FF:FF:FF:FF:FF:FF\"}]}"

응답 예시

{
  "code": 0,
  "message": "요청이 정상적으로 처리되었습니다",
  "result": {
     "configKey": "6e08a5ce0feb4cddad330f8913f684a1",
     "usage": "curl -s http://beta-vccm.ncloud.com/setUpClaVPC/6e08a5ce0feb4cddad330f8913f684a1 | sudo sh"
   }
}

이 문서가 도움이 되었습니까?

What's Next

Agent 설치

설명
요청