Get Operation Log

Last Updated on : 2024-06-29 01:57:46download

Query the event logs of the specified device based on event types.

API address

GET: /v2.0/cloud/thing/{device_id}/logs

Request parameter

Parameter nameTypeINRequiredDescription
device_idStringpathtrueThe device ID.
codesStringqueryfalseThe codes of data points supported by the device. You can query multiple data points, separated with commas (,). This parameter value is empty by default.
typeStringquerytrueThe supported types of logs. You can query multiple event types, separated with commas (,). This parameter value is required. Valid values:
  • 1: device online
  • 2: device offline
  • 3: device activation
  • 4: device reset
  • 5: command sending
  • 6: firmware update
  • 7: data point reporting
  • 8: device semaphore
  • 9: device restart
  • 10: timing
start_row_keyStringqueryfalseQuery the row key of HBase. This is a parameter of the free edition. The default value is empty.
start_timeLongquerytrueThe timestamp of the start time for a query.
end_timeLongquerytrueThe timestamp of the end time for a query.
query_typeIntegerquerytrueThe query type. Valid values:
  • 1: free edition. Default value.
  • 2: paid edition.
last_row_keyStringqueryfalseThe row key of the last entry on each page. This is a required parameter for the paid edition. The default value is empty, which means the first page.
last_event_timeLongqueryfalseThe event occurrence time of the last entry on each page. The default value is empty, which means the first page. This is a required parameter for the paid edition.
sizeIntegerquerytrueThe number of logs allowed to be returned. Default value: 20.

Return parameter

Parameter nameTypeDescription
successBooleanIndicates whether the request is successful. Valid values:
  • true: The operation succeeded.
  • false: The operation failed.
error_codeStringFor more information, see the error codes.
error_msgStringThe message that is returned if the request fails. It is empty if the request is successful.
resultObjectThe returned result.

Description of result

Parameter nameTypeDescription
current_row_keyStringThe starting key value of the current page.
device_idStringThe device ID.
has_nextbooleanSpecifies whether to return the next page.
logsFusionResultThe details of the log.

Description of logs

Parameter nameTypeDescription
event_timeLongThe time when the specified event occurs.
codeStringThe code of the specified data point.
event_fromStringThe source of the specified event.
event_idLongThe event ID.
valueStringThe event value.
statusStringThe event status.

Request example

GET: /v2.0/cloud/thing/vdevo167115422036***/logs?codes=switch_led_1&type=1,2,3,4,5,6,7,8,9,10&start_time=1676944806000&end_time=1677141431000&query_type=&size=20&start_row_key=&last_row_key=&last_event_time=

Return example

{
    "tid": "dcb6bacfbcba11eda71e169efc83a172",
    "result": {
        "current_row_key": "MTNhMmFmNjY4ZWRmOTllMmQ1ZGJhZTViZGl1dV85MjIzMzcwMzU4NjgwMTk1MTIxXzdfOQ==",
        "device_id": "uuidb5eabd5d2e99f***",
        "has_next": false,
        "logs": [
            {
                "code": "countdown_1",
                "event_from": "1",
                "event_id": 7,
                "value": "10",
                "event_time": 1678174580686,
                "status": "1"
            },
            {
                "code": "countdown_1",
                "event_from": "1",
                "event_id": 7,
                "value": "10",
                "event_time": 1678174579758,
                "status": "1"
            },
            {
                "code": "countdown_1",
                "event_from": "1",
                "event_id": 7,
                "value": "10",
                "event_time": 1678174578453,
                "status": "1"
            }
        ]
    },
    "t": 1678174631163,
    "success": true
}

Error code

For more information, see error code.

Limits on API Request Frequency

For more information, see Limits on API Request Frequency.