全部產品
Search
文件中心

Simple Log Service:資料編碼方式

更新時間:Jul 16, 2024

Log Service使用Protocol Buffer格式作為標準的日誌寫入格式。

Protocol Buffer格式用於結構化資料交換格式,當使用者需要寫入日誌時,需要把原始日誌資料序列化成如下格式的Protocol Buffer資料流,然後才能通過API寫入服務端。

message Log
{
    required uint32 Time = 1;// UNIX Time Format
    message Content
    {
        required string Key = 1;
        required string Value = 2;
    }  
    repeated Content Contents = 2;
    optional fixed32 Time_ns = 4; // for time nano part
}

message LogTag
{
    required string Key = 1;
    required string Value = 2;
}

message LogGroup
{
    repeated Log Logs= 1;
    optional string Topic = 3;
    optional string Source = 4;
    repeated LogTag LogTags = 6;
}

message LogGroupList
{
    repeated LogGroup logGroupList = 1;
}
說明
  • 在使用Protobuf時要保證Key-Value對的唯一性,否則會出現行為未定義的錯誤。

  • 關於Protocol Buffer格式的更多資訊請參見Github首頁

  • 關於Log Service寫入日誌的API的詳細描述,請參見PutLogs