HTTP SDK

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

HTTPS 프로토콜을 사용해 JSON 형식으로 된 로그 데이터를 Effective Log Search & Analytics 2.0 수집 서버에 전송할 수 있습니다.

로그 전송 정보

HTTPS/JSON 방식으로 로그를 전송하기 위한 다음 사항을 확인해 주십시오.

API URL
호출 방식
요청 바디(JSON 형식) 및 필드
로그 전송 예제

API URL

HTTPS로 Effective Log Search & Analytics 2.0 서버에 로그 전송 시 다음 주소를 사용해 주십시오.

https://elsa-v2-col.ncloud.com/_store

호출 방식

호출 방식(Method)은 PUT, POST 방식을 사용해 주십시오.

요청 바디 및 필드

요청 바디는 다음과 같이 JSON 형식으로 작성해 주십시오.

{
    "txtToken": "2xxxx10e221b4d06a870a06e9c5axxxx",
    "projectName": "72356c50401b8e20_testproject",
    "projectVersion": "1.0.0",
    "body": "This log message come from HTTPS client.",
    "host": "localhost",
    "logType": "nelo2-log"
}

JSON 형식의 요청 바디에 입력 가능한 필드는 다음과 같습니다.

필드 타입 필수 여부 설명
txtToken string 필수 프로젝트 생성 시 NELO에 등록된 txtToken(프로젝트 상세 정보 확인 참고)
projectName string 필수 프로젝트 생성 시 NELO에 등록된 프로젝트 키(프로젝트 상세 정보 확인 참고)
projectVersion string 필수 프로젝트 버전(기본값: 1.0.0)
  • 영문자, 숫자, 하이픈(-), 온점(.), 밑줄(_)만 입력 가능
body string 필수 로그 메시지
  • UTF-8을 사용하며, 공백 입력 불가
host string 옵션 로그 전송 위치(기본값: TCP의 peer-adrress)
logType string 옵션 로그 유형 식별(기본값: nelo2-log)
참고
  • 심벌리케이션 파일을 적용하려면 심벌리케이션 파일의 버전과 projectVersion 키의 값이 같아야 합니다.
  • logTime, sendTime 파라미터는 Effective Log Search & Analytics 2.0 서비스의 시스템에서 사용합니다. 두 가지 파라미터를 입력해도 적용되지 않습니다.

HTTP SDK 로그 전송 예제

HTTPS 로그 전송은 PUT과 POST 방식만을 지원합니다. 다음의 메소드별 로그 전송 예제를 참고해 로그를 전송해 주십시오.
로그 전송이 실패하지 않도록 로그를 전송하기 전에 API URL과 필드 등 전송 정보가 정확한지 확인해 주십시오.

POST 메서드 예제

POST 메서드를 사용한 예제는 다음과 같습니다.

$ curl -XPOST 'https://elsa-v2-col.ncloud.com/_store' -d '{
    "txtToken": "2xxxx10e221b4d06a870a06e9c5axxxx",
    "projectName": "72356c50401b8e20_testproject",
    "projectVersion": "1.0.0",
    "body": "This log message come from HTTPS client.",
    "host": "localhost",
    "logType": "nelo2-log"
}'

PUT 메서드 예제

PUT 메서드를 사용한 예제는 다음과 같습니다.

$ curl -XPUT 'https://elsa-v2-col.ncloud.com/_store' -d '{
    "txtToken": "2xxxx10e221b4d06a870a06e9c5axxxx",
    "projectName": "72356c50401b8e20_testproject",
    "projectVersion": "1.0.0",
    "body": "This log message come from HTTPS client.",
    "host": "localhost",
    "logType": "nelo2-log"
}'