云服务器内容精选

  • URI POST /v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID,获取方式请参见:获取账号ID、项目ID、日志组ID、日志流ID。 缺省值:None 最小长度:32 最大长度:32 log_group_id 是 String 日志组ID,获取方式请参见:获取账号ID、项目ID、日志组ID、日志流ID。 缺省值:None 最小长度:36 最大长度:36 log_stream_id 是 String 日志流ID,获取方式请参见:获取账号ID、项目ID、日志组ID、日志流ID。 缺省值:None 最小长度:36 最大长度:36 说明: 每个logstream写入速率最大不能超过100MB/S,超过此规格可能会导致日志丢失。
  • 响应示例 状态码: 200 日志上报成功。 { "errorCode": "SV CS TG.ALS.200.200", "errorMessage": "Report success.", "result": null } 状态码: 401 在客户端提供认证信息后,返回该状态码,表明服务端指出客户端所提供的认证信息不正确或非法。 { "errorCode" : "SVCSTG.ALS.403.105", "errorMessage" : "Project id is invalid.", "result": null }
  • 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从 IAM 获取的用户Token,获取方式请参见:获取用户Token。 缺省值:None 最小长度:1000 最大长度:2000 Content-Type 是 String 该字段填为:application/json;charset=UTF-8。 缺省值:None 最小长度:30 最大长度:30 表3 请求Body参数 参数 是否必选 参数类型 描述 log_time_ns 是 Long 日志数据上报时间,UTC时间(纳秒)。 说明: 通过接口上报日志到LTS的时间相距当前时间不超过2天,否则上报日志会被LTS删除。 contents 是 Array of String 日志内容。 labels 是 Object 用户自定义label。 说明: 请不要将字段名称设置为内置保留字段,否则可能会造成字段名称重复、查询不精确等问题。 tenant_project_id 否 String 租户项目ID,获取方式请参见:获取账号ID、项目ID、日志组ID、日志流ID。
  • 请求示例 POST https://{接入点IP:8102}/v2/{project_id}/lts/groups/{log_group_id}/streams/{log_stream_id}/tenant/contents { "log_time_ns": 1586850540000000000, "contents": [ "Fri Feb 1 07:48:04 UTC 2019 0\n", "Sat Apri 18 16:04:04 UTC 2019" ], "labels": { "user_tag": "string" } }
  • API接入概述 您可以通过调用 云日志服务LTS 提供的REST风格API将日志上报到LTS,具体有上报日志和上报高精度日志两个接口。 以下是两个接口的适用场景和各区域访问IP: 表1 适用场景 API名称 日志时间 举例说明 适用场景 上报日志 用户调用API上传一批日志时,通过log_time_ns字段指定一个初始时间。 每一条日志的日志时间,使用log_time_ns+顺序计数得到。 { "log_time_ns": "1586850540000000000", "contents": [ "log1", "log2" ], "labels": { "user_tag": "string" } } 上报到LTS后: log1的日志时间为:1586850540000000000 log2的日志时间为:1586850540000000001 上传的一批日志是在相近时间点、按顺序产生的。 上报高精度日志 用户调用API上传一批日志时,每一条日志都需要通过log_time_ns字段指定日志时间。 { "contents":[ { "log_time_ns":"1586850540000000000", "log":"log3" }, { "log_time_ns":"1586850540000000008", "log":"log4" } ], "labels":{ "user_tag":"string" } } 上报到LTS后: log3的日志时间为:1586850540000000000 log4的日志时间为:1586850540000000008 上传的一批日志是在不同时间、非顺序产生的,希望每条日志的时间单独指定。 表2 访问IP(accessip) 区域 访问IP 华北-北京一 100.125.57.101 华北-北京二 100.125.6.108 华北-北京四 100.125.12.150 华东-上海一 100.125.11.177 华东-上海二 100.125.140.102 华南-广州 100.125.158.115 西南-贵阳一 100.125.0.27 华南-广州-友好用户环境 100.125.4.30 亚太-新加坡 100.125.4.58 您可以在 云日志 服务控制台,左侧导航栏中选择“主机管理”,单击“安装ICAgent”,在安装ICAgent页面中的命令里获取访问IP(accessip)。 父主题: 使用API接入LTS