Logs

Logs

Jackrabbit Relay is quite aggressive in logging activities. Here I will go through the varous logs that are generated.

Files

Below is an example of what you will find in the /home/Jackrabbit2/Logs folder. In the vast majority of cases, the framework, exchange name, market, and asset are part of the file name of the log. Jackrabbit Relay logs can become quite extensive, so this breakdown improves monitoring and analysis of a given asset.

Here is the breakdown and meaning of each component in the PlaceOrder log file name.

PlaceOrder.kucoinfutures.future.kucoinfutures.MAIN.future.TRXUSDTUSDT.log

Component	Description
Program	This will always be PlaceOrder
Framework Exchange	This is the framework designatory and most often the exchange you are trading on. Note that the framework and exchange can be the same. See supported exchanges/brokers for the exchange name/ID to use in your order payload.
Market Type	This is the type of market you are trading in. This information is also available of the supported exchanges/brokers list.
Exchange	Same as above, used as verification
Account	The account reference from your exchange/broker configurtion file.
Market	This is the market the asset belongs to. It may not neccessarily be the same as market type.
Asset	The actual asset in a file system friendly format

JackrabbitOliverTwist.log
JackrabbitRelay.log
PlaceOrder.binance.spot.binance.Sandbox.spot.BTCUSDT.log
PlaceOrder.binance.spot.binance.Sandbox.spot.TRXUSDT.log
PlaceOrder.binance.spot.log
PlaceOrder.binanceusdm.future.binanceusdm.Sandbox.future.BTCUSDT.log
PlaceOrder.binanceusdm.future.binanceusdm.Sandbox.future.TRXUSDT.log
PlaceOrder.bitmex.future.bitmex.Sandbox.swap.BTCUSDTUSDT.log
PlaceOrder.bitmex.spot.bitmex.Sandbox.spot.BTCUSDTUSDT.log
PlaceOrder.bitmex.spot.bitmex.Sandbox.swap.BTCUSDTUSDT.log
PlaceOrder.kucoinfutures.future.kucoinfutures.MAIN.future.TRXUSDTUSDT.log
PlaceOrder.kucoinfutures.future.kucoinfutures.MAIN.swap.TRXUSDTUSDT.log
PlaceOrder.kucoinfutures.future.log
PlaceOrder.kucoin.spot.kucoin.MAIN.spot.TRXUSDT.log
PlaceOrder.kucoin.spot.kucoin.Sandbox.spot.BTCUSDT.log
PlaceOrder.kucoin.spot.kucoin.Sandbox.spot.ETHUSDT.log
PlaceOrder.kucoin.spot.kucoin.Sandbox.spot.TRXUSDT.log
PlaceOrder.oanda.oanda.MAIN.EURUSD.log
PlaceOrder.phemex.spot.phemex.Sandbox.spot.TRXUSDT.log

JackrabbitRelay

The JackrabbitRelay.log covers all conections to the Jackrabbit Relay server. Here you will find all details of any connection. Check it often. Your security should NOT allow any connections unless you explicitly allow them. The example here shows what you might see on an exposed server.

Typically spaking, you should see ONLY addresses referenced in the IPList.cfg file. If you are using Apache as a "cover" server, then this will assist in finding holes and leakes in security as your Apache configuration should mirror IPList.cfg.

2022-11-22 20:31:07.637779 0.0.0.1.0        Jackrabbit Relay
2022-11-23 15:15:04.377907 127.0.0.1        ('POST / HTTP/1.1', '200', '-')
2022-11-23 15:15:18.180722 127.0.0.1        ('POST / HTTP/1.1', '200', '-')
2022-11-23 15:15:32.625037 127.0.0.1        ('POST / HTTP/1.1', '200', '-')
2022-11-23 15:15:47.919102 127.0.0.1        ('POST / HTTP/1.1', '200', '-')
2022-11-23 18:03:12.520817 167.248.133.61   ('GET / HTTP/1.1', '200', '-')
2022-11-23 18:03:12.642649 167.248.133.61   (<HTTPStatus.HTTP_VERSION_NOT_SUPPORTED: 505>, 'Invalid HTTP version (2.0)')
2022-11-23 18:03:12.643400 167.248.133.61   ('PRI * HTTP/2.0', '505', '-')
2022-11-23 18:03:12.679651 167.248.133.61   ('GET /favicon.ico HTTP/1.1', '200', '-')
2022-11-23 19:01:37.276629 127.0.0.1        ('POST / HTTP/1.1', '200', '-')
2022-11-23 19:01:37.736410 127.0.0.1        ('POST / HTTP/1.1', '200', '-')
2022-11-23 19:01:46.150983 127.0.0.1        ('POST / HTTP/1.1', '200', '-')
2022-11-23 19:01:46.573286 127.0.0.1        ('POST / HTTP/1.1', '200', '-')

PlaceOrder

These logs are the bulk of the logging system and contain details of each and every order placed.

ALL order in these logs have a very distinctive layout to track and trace any errors. All orders ALWAYS start with the PlaceOrder versn and end with the elapsed time to complete the transaction. If you have a log entry that does NOT contain both, please file a support ticket.

The breakdown of this log is simple and intuitive following this format:

1. The PlaceOrder header with version.
2. The order (commonly refered to as payload in the support server) is listed. Your identity will NOT be listed.
3. If you are using TradingView and are using its {{ticker}} macro, then the asset will be remapped back to the exchange accepted value.
4. Minimum accepted amount and costs by the exchange. Present in the first example, but not in the second.
5. The previous balance or contract value (futures).
6. Placing the order and its breakdown.
7. The new balance or contract value (futures).
8. The time it took, including waiting for exchange/broker responses, to process the order.

2022-11-15 15:54:01.318480 2905971 PlaceOrder SPOT 0.0.0.1.0
2022-11-15 15:54:01.318799 2905971 Order parsed
2022-11-15 15:54:01.318895 2905971 |- Exchange: kucoin
2022-11-15 15:54:01.318968 2905971 |- Market: spot
2022-11-15 15:54:01.319026 2905971 |- Account: MAIN
2022-11-15 15:54:01.319079 2905971 |- Action: close
2022-11-15 15:54:01.319133 2905971 |- Asset: TRXUSDT
2022-11-15 15:54:01.319185 2905971 |- RemapSymbol: Yes
2022-11-15 15:54:01.319248 2905971 |- OrderType: market
2022-11-15 15:54:01.319298 2905971 TradingView Symbol Remap
2022-11-15 15:54:01.319345 2905971 |- In: TRXUSDT
2022-11-15 15:54:01.320113 2905971 |- Out: TRX/USDT
2022-11-15 15:54:01.888385 2905971 Using minimum position amount/price
2022-11-15 15:54:01.888586 2905971 |- Minimum Amount: 1.00000000
2022-11-15 15:54:01.888666 2905971 |- Minimum Cost:   0.05088000
2022-11-15 15:54:02.284503 2905971 Previous Balance: 5.00000000 TRX
2022-11-15 15:54:02.285201 2905971 |- Forcing balance
2022-11-15 15:54:02.285626 2905971 Placing Order
2022-11-15 15:54:02.285948 2905971 |- Asset: TRX/USDT
2022-11-15 15:54:02.286265 2905971 |- Action: close
2022-11-15 15:54:02.286575 2905971 |- Amount: 5.00000000
2022-11-15 15:54:02.286863 2905971 |- Price: 0.05088000
2022-11-15 15:54:02.287189 2905971 |- Total: 0.25440000
2022-11-15 15:54:03.815198 2905971 |- Order Confirmation ID: 6373b61b8e16810001d3f62d
2022-11-15 15:54:04.133270 2905971 New Balance: 0.00000000 TRX
2022-11-15 15:54:04.617748 2905971 Processing Completed: 0:00:04.531401 seconds

2022-11-24 15:47:08.972100 3612957 PlaceOrder SPOT 0.0.0.1.0
2022-11-24 15:47:08.972779 3612957 Order parsed
2022-11-24 15:47:08.973710 3612957 |- Exchange: binance
2022-11-24 15:47:08.974014 3612957 |- Market: spot
2022-11-24 15:47:08.974279 3612957 |- Account: Sandbox
2022-11-24 15:47:08.974540 3612957 |- Action: buy
2022-11-24 15:47:08.974751 3612957 |- Asset: TRXUSDT
2022-11-24 15:47:08.974955 3612957 |- RemapSymbol: Yes
2022-11-24 15:47:08.975146 3612957 |- Quote: 15
2022-11-24 15:47:08.975338 3612957 |- OrderType: market
2022-11-24 15:47:08.975531 3612957 TradingView Symbol Remap
2022-11-24 15:47:08.975722 3612957 |- In: TRXUSDT
2022-11-24 15:47:08.976030 3612957 |- Out: TRX/USDT
2022-11-24 15:47:10.267467 3612957 Previous Balance: 423695.60000000 TRX
2022-11-24 15:47:10.267690 3612957 Placing Order
2022-11-24 15:47:10.267771 3612957 |- Asset: TRX/USDT
2022-11-24 15:47:10.267822 3612957 |- Action: buy
2022-11-24 15:47:10.267869 3612957 |- Amount: 284.84618306
2022-11-24 15:47:10.267914 3612957 |- Price: 0.05266000
2022-11-24 15:47:10.267957 3612957 |- Total: 15.00000000
2022-11-24 15:47:10.416252 3612957 |- Order Confirmation ID: 1736797
2022-11-24 15:47:11.665466 3612957 New Balance: 429103.80000000 TRX
2022-11-24 15:47:12.778368 3612957 Processing Completed: 0:00:04.270199 seconds