Collecting Logs Using APIs

Reporting Logs

When invoking the API to upload a batch of logs, you can specify an initial time with log_time_ns field.

The time of each log increases in ascending order based on the value of log_time_ns.

{
"log_time_ns": "1586850540000000000",
"contents": [
  "log1",
  "log2"
  "log3"
 ],
 "labels": {
  "user_tag": "string"
 }
}

When reported to LTS:

The time of log1 is 1586850540000000000.

The time of log2 is 1586850540000000001.

The time of log3 is 1586850540000000002.

The logs are generated in sequence at similar time.

Reporting High-Precision Logs

When you invoke the API to upload a batch of logs, the log_time_ns field must be used to specify the log time for each log.

{
    "contents":[
        {
            "log_time_ns":"1586850540000000000",
            "log":"log4"
        },
        {
            "log_time_ns":"1586850540000000008",
            "log":"log5"
        }
    ],
    "labels":{
        "user_tag":"string"
    }
}

When reported to LTS:

The time of log4 is 1586850540000000000.

The time of log5 is 1586850540000000008.

The uploaded logs are generated out of order at different times. Each log needs to have its own timestamp.