Log Management API > BS2_GetFilteredLog


BS2_GetFilteredLog

[Deprecated] Gets all the log records that matches the given condition.

Important
The device log filtering API BS2_GetFilteredLog reviews the device's logs against the conditions set by the server.
This means that the device may invest considerable time in log filtering, and as the number of logs on the device increases, more time will be required.

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.

Declaration

#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);

Parameter

NOTE
The logsObj variable needs to return the memory to the system by the BS2_ReleaseObject function after being used.

Return Value

If successfully done, BS_SDK_SUCCESS will be returned.
If there is an error, the corresponding error code will be returned.

See Also

BS2_GetLog
BS2_ClearLog