プロトコルバッファは、Google が開発した構造化データ交換フォーマットです。 Google の数多くの内外のサービスで広く利用されています。 現在、Log Service ではプロトコル バッファ形式を 標準のログ書き込み形式として使用しています。 API を使用して Log Service にログを書き込む前に、元のログデータをプロトコルバッファデータストリームにシリアル化する必要があります。

message Log
{
    required uint32 Time = 1;// UNIX Time Format
    message Content
    {
        required string Key = 1;
        required string Value = 2;
    }  
    repeated Content Contents = 2;
}

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

message LogGroup
{
    repeated Log Logs= 1;
    optional string Reserved = 2; // reserved fields
    optional string Topic = 3;
    optional string Source = 4;
    repeated LogTag LogTags = 6;
}

message LogGroupList
{
    repeated LogGroup logGroupList = 1;
}
  • プロトコルバッファでは、キーと値のペアが一意である必要はありませんが、 一意でない場合、動作は未定義になります。 したがって、一意とならない状況は避ける必要があります。
  • プロトコルバッファ形式の詳細については、「Github」をご参照ください。
  • Log Service にログを書き込む API の詳細については、「PostLogStoreLogs」をご参照ください。