数据编码格式

最近更新时间:2020-09-09 14:48:50

日志服务支持使用Protocol Buffer格式作为标准的日志写入格式。

Protocol Buffer格式用于结构化数据交换格式,当用户需要写入日志时,需要把原始日志数据序列化成如下格式的Protocol Buffer数据流,然后才能通过API写入服务端。

message Log
{
    message Content
    {
        required string key   = 1; // 每组字段的 key
        required string value = 2; // 每组字段的 value
    }
    required int64 time = 1; // 时间戳,UNIX时间格式
    repeated Content contents = 2; // 一条日志里的多个kv组合
}
message LogGroup
{
    repeated Log    logs        = 1; // 多条日志合成的日志数组
    optional string reserved    = 2; // 目前暂无效用
    optional string filename    = 3; // 日志文件名
    optional string source      = 4; // 日志来源,一般使用机器IP
}
message LogGroupList //主要用于结果返回用,PullLogs
{
    repeated LogGroup logGroupList = 1; // 日志组列表
}

说明

  • 在使用Protobuf时要保证Key-Value对的唯一性,否则会出现行为未定义的错误。
  • 关于Protocol Buffer格式的更多信息请参见Github首页
  • 关于日志服务写入日志的API的详细描述,请参见Putlogs

金山云,开启您的云计算之旅

免费注册