How to Get Logs

From Haasonline Software Wiki
Jump to: navigation, search

For version 3 we have improved the debug abilities of our software. For those who are interested, this topic will describe how to activate the special debug mode and how to understand whats happening in detail.

General

To activate the debug view, double-click the HTS icon in the top left. This is the general overview. You can see the general statistics and health on this view.

Debug1.png

The chart is showing 2 very important lines. We have setup a separate thread which is counting the seconds that have passed; this is called the heartbeat. We are expecting to count 20 seconds each time we update the chart. If the chart shows fewer heartbeats, then something is wrong. This is a telltale sign of a CPU that can not handle the load placed on it by the software.


The second line is showing Waiting Threads. This is a technical name, but it is showing how many threads are waiting to be executed. In theory, if your computer has fewer cores this stack of waiting threads becomes pretty big. Again this is a sign the computer can not handle the load. Keep in mind having threads waiting is very normal too, this software is simply very heavily multi-threaded.


Inside the totals there are a few fields of interest. First, we can see if any exception has happened inside the software while it was running. Secondly, the database field can indicate if the database if functioning properly. For the software its essential to have a good, quick, and functioning database.


History engine

The history engine is showing the status of the price history and the price history synchronization proces.

Debug2.png

The chart are showing 2 lines representing an stack, which can be compared to an todo list. Again both lines are very important and in this case they are designed to "take-over". The WorkingStack is the initial todo list ofall the price markets which required to be synced. Once the WorkingStack is done with an price market its passed to the AlignmentStack. In here the prices are keeped up to date.


The WorkingStack is designed to reach 0. So over time this stack has to become empty and then everything is nicely in sync. It might take an while before it reaches the 0 because only of the full price history is perfectly aligned inside the database then is removed from the WorkingStack.


In the event where is never reaches 0 its an telltale of an problem. It means no price updates are received from both the price driver and the white server. So its impossible to those the prices aligned nicely. To see which price market are affected you can expand the details listed below it. The details will tell how many times an sync is called, if the price market has been given up to be synced and such.


White server

Its just the technical name, but at the white server we can see how the price backbone is preforming. This is the backup system to get price update in case you have connections problems. Its also used as main source when the low-power mode is activated.

Debug3.png

On the chart you can see 2 lines, one showing the amount of subscriptions (price requests) to the White Server and the other line shows the ServerMessages received back. These (of course) represent price updates.

To detect issues you need to watch the subscriptions. In general its only needed to subscribe once to our server. But if more subscriptions happen then its an telltale of missing price data. If you see this its best to give us an sign so we can resolve this. There are additional details available for which price markets are involved. To see it you need to expand the details shown below.

The software is designed to switch over automatically in the event an price server gets compromised somehow. We list this number as server re-selections, and if this number goes up very high then its an telltale of an firewall blocking or an very big problem on our end.


Price driver

The price driver is the overall driver to handle the price updates. It shows an chart telling how many updates have been progressed for the last 20 seconds.

Debug4.png

Except for seeing the load the updates are doing you can not really see much directly at this view. However, if you expand the details then an nice table will show up. It will tell per price source how many errors/re-connections have been done in total. These are the most important numbers because its telling how stable the price driver itself is. Next the amount of updates are listed (collected per minute) to see if some data is missing. On the most right corner there is the average required time listed for the connection. The is the second most important number, if it list an very high time needed then it means your connection to this exchange is not good.


Account driver

The account driver is the overall driver to handle all the accounts. Also here the charts is showing the amount of updates from all the activated accounts. (including the simulated ones)


The account debug view will become available inside version 3.0.11.




Submitting your Logs to our Support Desk

Be sure to be descriptive of the issue you are experiencing so that the Haasbot developers can look into the issue and provide fixes as soon as they can.