How to collect Fing Agent log files

All commands may be executed directly on the Raspberry Pi, or from another device via Secure Shell protocol (SSH).

How to change the log level to DEBUG

• Open a terminal and run the following commands:

sudo cp /snap/fing-agent/current/conf/fingagent.properties /var/snap/fing-agent/common/conf 

• Change the log.properties file by entering the command

sudo nano /var/snap/fing-agent/common/log/log.properties

• Change the attribute overlook.fingagent.logging.level to DEBUG 

• Save the change
• Restart the agent to apply the change by entering the command

sudo snap restart fing-agent

• Replicate the issue found in the Fing Agent in order to populate log files.

How to create logs archive 

• Change the work directory and enter the command

cd /var/snap/fing-agent/common/log

• Create a logs archive by entering the command below:

sudo tar cvf logs.tar * 

• A compressed file logs.tar will be created in the logs directory.

Change Log Level

To change the log level on your Windows or macOS PC, follow these steps.

Windows

1. Open the command prompt as Administrator.
2. Enter the command echo overlook.fingagent.logging.level=DEBUG >. %userprofile%\AppData\Roaming\FingAgent\conf\fingagent.properties and press enter.
3. Enter the stop service command: sc stop Fing.Agent and press enter.
4. Enter  the start service command: sc start Fing.Agent and press enter.
5. Close the Fing Desktop App.
6. Restart the Fing Desktop App and wait until the Service Not Found issue occurs.

MAC

1. Open the terminal.
2. Type the command sudo sh -c “echo ‘overlook.fingagent.logging.level=DEBUG’ > /Users/root/.fingagent/conf/fingagent.properties” and press enter (type your password when prompted).
3. Type the stop service command sudo launchctl unload /Library/LaunchDaemons/com.fing.service.plist and press enter.
4. Type the start service command sudo launchctl load. /Library/LaunchDaemons/com.fing.service.plist and press Enter.
5. Close the Fing Desktop App.
6. Restart the Fing Desktop App and wait until the Service Not Found issue occurs.

How to submit a request

1. Click the Submit a request link at the top of this page.
2. Attach the compressed log files saved locally in the Attachment section by clicking on the 'Add file' link.
3. In the subject enter the issue found.
4. In the description enter the Fing-Agent behaviour providing  as much detail as possible about your network environment (network, router, VPN, Firewall, etc).
5. Click on Submit.