Q: How do I generate debug logs for the Formant agent media encoder?

To generate a backtrace for the media encoder:

1. On your device, open /var/lib/formant/.bashrc.
2. If this line is present, remove it: export FORMANT_GST_INFO=true.
3. Add this line: export FORMANT_DISABLE_PYTHON_MEDIA_ENCODER=true.
4. Restart the Formant agent: sudo systemctl restart formant-agent.
5. Run the following commands to activate the debug log generator:

sudo apt install python3-dbg python3-dev  
sudo su formant
PYTHONPATH=/usr/lib/formant/agent/dist-packages:$PYTHONPATH FORMANT_AGENT_GRPC_UNIX_SOCKET=/var/lib/formant/agent.sock 
FORMANT_ROS_AGENT_GRPC_UNIX_SOCKET=/var/lib/formant/ros_bridge.sock gdb --args python3 /usr/lib/formant/agent/media_encoder_main.py

You should see (gdb) in your terminal. Run the run command to start the debugger.

6. After a crash or erroneous behavior occurs, run the backtrace command to generate logs.

See also

• The Formant agent
• Environment variables for the agent

👋

If you notice an issue with this page or need help, please reach out to us! Use the 'Did this page help you?' buttons below, or get in contact with our Customer Success team via the Intercom messenger in the bottom-right corner of this page, or at [email protected].