HTTP SDK
    • PDF

    HTTP SDK

    • PDF

    Article Summary

    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形式のリクエストボディに入力可能なフィールドは、次の通りです。

    フィールドタイプ必須有無説明
    txtTokenstring必須プロジェクトの作成時に NELOに登録された txtToken(プロジェクト詳細情報確認を参照)
    projectNamestring必須プロジェクトの作成時に NELOに登録されたプロジェクトキー(プロジェクト詳細情報確認を参照)
    projectVersionstring必須プロジェクトバージョン(デフォルト値: 1.0.0)
    • 英数字、ハイフン(-)、句点(.)、アンダースコア(_)のみ入力可能
    bodystring必須ログメッセージ
    • UTF-8を使用し、スペースは入力不可
    hoststringオプションログ転送場所(デフォルト値: TCPの peer-adrress)
    logTypestringオプションログタイプの識別(デフォルト値: nelo2-log)
    参考
    • シンボリケーションファイルを適用するには、そのバージョンと projectVersion キーの値が一致する必要があります。
    • logTimesendTime パラメータは Effective Log Search & Analytics 2.0サービスのシステムで使用します。2つのパラメータを入力しても適用されません。

    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"
    }'
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.