プロトコルバッファは、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」をご参照ください。