Gateway Status
The easiest way to monitor the status of the Gateway and make sure it is working as expected is by examining the Gateway status log file. If you are executing the bloXroute Gateway from a Docker container, you will need to volume mount the status log to the host machine. The Gateway status log can also be viewed from the bloXroute-cli.
For pip install, the Gateway status log is located at ~/bloxroute/gateway_status.log.
For Docker container, the file can be found inside the container under /home/bxgateway/bloxroute/gateway_status.log.
The Gateway status file contains important information that can be used to verify status and troubleshooting. The most important section is the Summary section. The Summary section contains current information about connections and accounts.
Sections
Descriptions
gateway_status
Status of the Gateway, online or offline
account_info
Type of account associated, if any, with the Gateway, and whether it is using the limited free daily quota
block_relay_connection_state
Status of the connection to the Block Relay: established or closed
transaction_relay_connection_state
Status of the connection to the Transaction Relay: established or closed
blockchain_node_connection_state
Status of the connection to the blockchain node: established or closed
remote_blockchain_node_connection_state
Status of the connection to the remote blockchain node: established or closed
ip_address
IP address of the Gateway, as resolved by the self resolving mechanism or specified by the –external-ip parameter
continent
Continent in which the ip geolocation system places the ip address
country
Country in which the ip geolocation system places the ip address
update_required
Whether or not there is a newer version of the Gateway available for download and installation
quota_level
Percentage of the transaction quota already consumed

gateway_status: get status of the gateway

pip install
Docker
1
$ bloxroute-cli gateway_status
2
​
Copied!
1
$ docker exec -it bxgateway bloxroute-cli gateway_status
2
# replace "bxgateway" with the actual Gateway container name
3
Copied!
Result:
1
{
2
"gateway_status": "Online",
3
"account_info": "This gateway is associated to account: a6c9e3bd-e41c-42cd-9796-28a9dfe06530",
4
"relay_connection_state": "Established",
5
"blockchain_node_connection_states": {
6
"127.0.0.1 30303": "Established"
7
},
8
"remote_blockchain_node_connection_state": "Established",
9
"ip_address": "XXX.XXX.XXX.XXX",
10
"continent": "AS",
11
"country": "China",
12
"update_required": false
13
"Quota_level": null
14
}
15
​
Copied!

bdn_performance: get percentage of blocks/transactions first received from BDN

pip install
Docker
1
$ bloxroute-cli bdn_performance
2
​
Copied!
1
$ docker exec -it bxgateway bloxroute-cli bdn_performance
2
# replace "bxgateway" with the actual gateway container name
3
​
Copied!
Result
1
{
2
"interval_start_time": "2020-09-01 22:10:52.063009",
3
"interval_end_time": "2020-09-01 22:25:52.096951",
4
"127.0.0.1 30303": {
5
"blocks_from_bdn_percentage": "90.72%",
6
"transactions_from_bdn_percentage": "79.13%",
7
"total_blocks_seen": 68
8
}
9
}
10
​
Copied!
Last modified 1mo ago
Copy link