---
title: "HTTP SDK"
slug: "elsa2-sdk-http"
updated: 2026-09-17T09:07:51Z
published: 2026-09-17T09:07:51Z
canonical: "guide.ncloud-docs.com/elsa2-sdk-http"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# HTTP SDK

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

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

## 로그 전송 정보

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

[API URL](/docs/elsa2-sdk-http#APIURL) [호출 방식](/docs/elsa2-sdk-http#%ED%98%B8%EC%B6%9C%EB%B0%A9%EC%8B%9D) [요청 바디(JSON 형식) 및 필드](/docs/elsa2-sdk-http#%EC%9A%94%EC%B2%AD%EB%B0%94%EB%94%94%EB%B0%8F%ED%95%84%EB%93%9C) [로그 전송 예제](/docs/elsa2-sdk-http#HTTPSDK%EB%A1%9C%EA%B7%B8%EC%A0%84%EC%86%A1%EC%98%88%EC%A0%9C)

### 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([프로젝트 상세 정보 확인](/docs/elsa2-project#%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%EC%83%81%EC%84%B8%EC%A0%95%EB%B3%B4%ED%99%95%EC%9D%B8) 참고) |
| `projectName` | string | 필수 | 프로젝트 생성 시 NELO에 등록된 프로젝트 키([프로젝트 상세 정보 확인](/docs/elsa2-project#%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8%EC%83%81%EC%84%B8%EC%A0%95%EB%B3%B4%ED%99%95%EC%9D%B8) 참고) |
| `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"
}'
```