Logs and Logging¶
As Hummingbot is an in-progress, open-access software, it is written for logs to be publicly displayed during operation and available locally for each time an instance is run. Logs contain records of what happens when a bot is run, including the results of specified checks and behaviors as well as error tracing.
Viewing Log Configurations¶
The way that log files are structured is contained within
conf/hummingbot_logs.yml. For now, we request that users leave the log settings at the defaults. This makes it easier for the Hummingbot team to trace bugs and other problems that users face when logs are submitted.
Disable Data Collection¶
CoinAlpha collects usage information from users to allow for the sharing of this data as stated in Important Disclosure re: Hummingbot Data Collection.
This can be turned off by modifying
hummingbot_logs.yml file with this template.
Viewing Individual Log Files¶
For users who wish to locate and submit log files, generally they are located in the
/logs folder. Specific path or location may vary depending on the environment and how Hummingbot was installed.
- Installed from source:
- Installed via Docker:
hummingbot_filesis the default name of the parent directory. This can be different depending on the setup when the instance was created.
- Installed via Binary (Windows):
- Installed via Binary (MacOS):
Log File Management¶
A separate log file will now be generated daily. When a new log file is created, if there are more than 7 files, the oldest ones will be deleted in order to limit disk storage usage. The log rotation feature was added in Hummingbot version 0.17.0.
If you are looking for support in handling errors or have questions about behavior reported in logs, you can find ways of contacting the team or community in our support section.