Log Management API > BS2_GetFilteredLog
[Deprecated]
Gets all the log records that matches the given condition.
Also, logs are not permanently stored on the device.
If the maximum number of logs that the device can hold is exceeded, the device will overwrite the oldest logs, and logs older than a certain period of time may be automatically deleted.
It is recommended that all logs from the device be stored and managed on a server.
Combining the BS2_GetLog API for bulk receiving of logs from the device and the BS2_StartMonitoringLog API
for receiving logs in real-time after that, it is recommended to store all logs from the device in a suitable DBMS by the server, and then filter logs from the DBMS.
#include "BS_API.h" int BS2_GetFilteredLog(void* context, uint32_t deviceId, char* uid, uint16_t eventCode, uint32_t start, uint32_t end, uint8_t tnakey, BS2Event** logsObj, uint32_t* numLog);
context
: ContextdeviceId
: Device IDuid
: User ID. When the value is NULL, it means all users.eventCode
: Log event code. When the value is 0, it means all events.start
: Filtered search start time. When the value is 0, it means there are no limitations.end
: Filtered search end time. When the value is 0, it means there are no limitations.tnakey
: TNA key. When the value is 0, it means all TNA keys.logsObj
: Pointer to store the log record's address.numLog
: Number of log record.
NOTE
The logsObj variable needs to return the memory to the system by the BS2_ReleaseObject function after being used.
If successfully done, BS_SDK_SUCCESS
will be returned.
If there is an error, the corresponding error code will be returned.