VPC 서버 로그 수집 정보 설정

인쇄
공유
PDF

기사 요약

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

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

VPC 서버 로그 수집 정보 설정

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

요청 URL

POST https://cloudloganalytics.beta-apigw.gov-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-v1:{API Gateway Signature}`
Content-Type	Request body content type을 application/json으로 지정 `Content-Type: application/json`

요청 바디

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

요청 예시

POST https://cloudloganalytics.beta-apigw.gov-ntruss.com/api/{regionCode}-v1/vpc/servers/collecting-infos
HOST: cloudloganalytics.apigw.gov-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": "CentOS 7",
  "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": "CentOS 7",
  "ip": "123.123.123.123",
  "instanceNo": 1111111,
  "macAddr":  "FF:FF:FF:FF:FF:FF"
}
]

curl -X POST "https://cloudloganalytics.beta-apigw.gov-ntruss.com/api/{regionCode}-v1/vpc/servers/collecting-infos" 
-H "accept: application/json" 
-H "Content-Type: application/json" 
-H "x-ncp-iam-access-key: 11IKBWgQegM4DwiJL4mo" 
-H "x-ncp-apigw-timestamp: 1594025530536" 
-H "x-ncp-apigw-signature-v2: ql8l9dfegxM4gMtVozTZH7kOdjsOB0FLdDvLRkvFPks=" 
-d "\"collectingInfos\": [{ \"logPath\": \"/var/log/messages\", \"logTemplate\": \"SYSLOG\", \"logType\": \"SYSLOG\", \"servername\": \"s172353dfd86\", \"osType\": \"CentOS 7\", \"ip\": \"123.123.123.123\", \"instanceNo\": 1111111},{ \"logPath\": \"/var/log/mysql/error.log\", \"logTemplate\": \"MySQL\", \"logType\": \"mysql_error\", \"servername\": \"s172353dfd86\", \"osType\": \"CentOS 7\", \"ip\": \"123.123.123.123\", \"instanceNo\": 1111111,\"macAddr\":  \"FF:FF:FF:FF:FF:FF\"}]"

응답 예시

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

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

What's Next

Agent 설치

VPC 서버 로그 수집 정보 설정