HTTP SDK の使用方法

Classic/VPC環境で利用できます。

概要

HTTPSプロトコルを使用して Effective Log Search & Analyticsにログを送信でき、以下のような JSON形式を使用します。

{
    "projectName": "72356c50401b8e20_testproject",
    "projectVersion": "1.0.0",
    "body": "This log message come from HTTPS client.",
    "logLevel": "DEBUG",
    "logType": "WEB",
    "logSource": "https"
}

パラメータ

パラメータ	タイプ	必須	説明
`projectName`	`string`	`required`	プロジェクト ID。プロジェクト IDを確認する方法は、プロジェクトを照会するを参照します。
`projectVersion`	`string`	`required`	プロジェクトバージョン。デフォルト値は1.0.0であり、A~Z、a~z、0~9、ハイフン(-)、句点(.)、アンダースコア(_)のみ使用できます。
`body`	`string`	`required`	ログメッセージ。UTF-8を使用し、スペースは使えません。
`logSource`	`string`	`optional`	ログを識別するために使用し、送信しない場合のデフォルト値は「json」です。
`logType`	`string`	`optional`	ログを識別するために使用し、送信しない場合のデフォルト値は「nelo2-log」です。

注意

JSON/HTTPSで Effective Log Search & Analyticsにログを送信する場合、次のアドレスを使用します。

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

"logTime"と "sendTime"は Effective Log Search & Analyticsのシステムで使用します。2つのキーを使用する場合、Effective Log Search & Analyticsで無視します。

HTTPSログの送信は PUTと POST方式のみサポートします。

ログ送信例

curlを使用して正常にログを送信した場合

POSTメソッドを使用してログを送信

$ curl -XPOST 'https://elsa-col.ncloud.com/_store' -d '{
    "projectName": "%YOUR_PROJECT_KEY%",
    "projectVersion": "1.0.0",
    "body": "this log message come from https client, and it is a simple sample.",
	"logLevel": "DEBUG",
	"logType": "WEB",
	"logSource": "https"
}'

PUTメソッドを使用してログを送信

$ curl -XPUT 'https://elsa-col.ncloud.com/_store' -d '{
    "projectName": "%YOUR_PROJECT_KEY%",
    "projectVersion": "1.0.0",
    "body": "this log message come from https client, and it is a simple sample.",
	"logLevel": "DEBUG",
	"logType": "WEB",
	"logSource": "https"
}'

ログ送信に失敗する場合

URLが間違っている場合(_storess -> _store)

$ curl -XPOST 'https://elsa-col.ncloud.com/_storess' -d '{
    "projectName": "%YOUR_PROJECT_KEY%",
    "projectVersion": "1.0.0",
    "body": "this log message come from https client, and it is a simple sample.",
    "_xxx": "this is a invalid key"
}'

間違ったフィールドキーを使用した場合(_xxx)

$ curl -XPOST 'https://elsa-col.ncloud.com/_store' -d '{
    "projectName": "%YOUR_PROJECT_KEY%",
    "projectVersion": "1.0.0",
    "body": "this log message come from https client, and it is a simple sample.",
    "_xxx": "this is a invalid key"
    }'