All Products
Search
Document Center

Simple Log Service:Pengkodean data

Last Updated:Jun 03, 2026

Simple Log Service (SLS) menggunakan Protocol Buffers (protobuf) sebagai format standar untuk menulis log.

Protobuf adalah format yang netral terhadap bahasa dan independen terhadap platform untuk bertukar data terstruktur. Sebelum menulis log ke server melalui API, data log mentah harus diserialisasi menjadi aliran data protobuf. Skema berikut mendefinisikan format yang diperlukan:

message Log
{
    required uint32 Time = 1; // format waktu UNIX
    message Content
    {
        required string Key = 1;
        required string Value = 2;
    }  
    repeated Content Contents = 2;
    optional fixed32 Time_ns = 4; // bagian nanodetik dari waktu
}

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;
}

Skema tersebut mendefinisikan empat jenis message. Tabel berikut menjelaskan setiap field:

Message

Field

Type

Required

Description

Log

Time

uint32

Yes

Timestamp log dalam format waktu UNIX

Log

Contents

Content (repeated)

Yes

Satu atau beberapa pasangan kunci-nilai yang membentuk konten log

Log > Content

Key

string

Yes

Nama field log

Log > Content

Value

string

Yes

Nilai field log

Log

Time_ns

fixed32

No

Ekstensi presisi nanodetik untuk timestamp

LogTag

Key

string

Yes

Nama tag yang dilampirkan pada kelompok log

LogTag

Value

string

Yes

Nilai tag yang dilampirkan pada kelompok log

LogGroup

Logs

Log (repeated)

Yes

Kumpulan log dalam kelompok tersebut

LogGroup

Topic

string

No

Topik yang digunakan untuk mengklasifikasikan log dalam logstore

LogGroup

Source

string

No

Mesin atau alamat IP yang menghasilkan log

LogGroup

LogTags

LogTag (repeated)

No

Tag metadata untuk kelompok log

LogGroupList

logGroupList

LogGroup (repeated)

Yes

Daftar kelompok log yang dikirim dalam satu panggilan API

Catatan
  • Kunci dalam data protobuf harus unik. Kunci duplikat dapat menyebabkan perilaku tidak terdefinisi atau kegagalan.

  • Untuk informasi lebih lanjut tentang format protobuf, lihat protobuf di GitHub.

  • Untuk informasi lebih lanjut tentang operasi API untuk menulis log ke Simple Log Service, lihat PutLogs.