Applies to: WAVE

Summary

This article explains how to enable metadata logging for troubleshooting analytics issues in WAVE.

Enabling Metadata Logs

To enable metadata logging:

1. Navigate to the appropriate location.
   
   Windows:  C:\Windows\System32\config\systemprofile\AppData\Local 
   
   Linux: /home/hanwha/.config  
    
2. Check for a folder named nx_ini. If the folder does not exist, create it.  
    
3. Open the nx_ini folder.  
    

4. Create an empty text file named analytics_logging.ini.

   IMPORTANT: Ensure the file extension is .ini and not .txt.
   

5. Restart the WAVE Media Server service.  
    
6. Open the analytics_logging.ini file. 
   
   WAVE automatically adds the default logging options to the file.  
    
7. Remove the # from the beginning of the analyticsLogPath option to enable it.  
    
8. Set analyticsLogPath to the directory where you want to store the logs.  
   
   You can use a path relative to the .ini file location or an absolute path. 
   
   analyticsLogPath=analytics_log_dir  
    
9. (Optional) To include object bounding box coordinates in the logs, add logObjectMetadataDetails=true  
    
10. Restart the WAVE Media Server or Desktop Client to apply the changes. 
     

Generated log file names include the pipeline stage prefix, the camera device ID, and stream details (such as _high or _low suffixes).

NOTE: The WAVE Media Server runs as a background service, while the 
WAVE Desktop Client runs as a user application. As a result, each 
application uses its own separate analytics_logging.ini file.