Classic 서버 로그 수집 정보 설정

Prev Next

Classic 서버 로그 수집 정보 설정

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

요청

POST https://cloudloganalytics.apigw.gov-ntruss.com/api/{regionCode}-v1/classic/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
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에서 osName 값을 사용합니다. String
servername 수집할 서버 명 Y 서버 목록 조회 API에서 servername 값을 사용합니다.
ex) cla-test
String
instanceNo 수집할 서버의 instanceNo Y 서버 목록 조회 API에서 instanceNo 값을 사용합니다.
ex) 1234567
Integer
ip 수집할 서버의 IP 주소 Y 서버 목록 조회 API에서 privateIp 값을 사용합니다.
ex) 123.123.123.123
String

요청 예시

POST https://cloudloganalytics.apigw.gov-ntruss.com/api/{regionCode}-v1/classic/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.apigw.gov-ntruss.com/api/{regionCode}-v1/classic/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: /k1KmEmUAiNxrKRVOXaPTqvmdlHodIO/9qGFpCqMjOM=" 
-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://ccm.gov-ncloud.com/setUpCla/aed8296f3ce144b0b435b8d651222709 | sudo sh"
  }
}