Node Inspection Service

Aptos nodes collect metrics and system information while running. These metrics provide a way to track, monitor and inspect the health and performance of the node dynamically, at runtime. Node metrics and system information can be queried or exported via an inspection service that runs on each node. To see the list of important metrics and counters, see the Important Node Metrics document.

You can configure various aspects of the node inspection service. This document describes how to expose and see the metrics locally, on the respective node. You may also view these metrics remotely by making the port accessible via firewall rules.

Examining node metrics

If you’d like to examine the metrics of your node, start running a node and review the inspection service locally by loading this URL in your browser:

http://localhost:9101/metrics

This will display the values of all the metrics and counters of your node at the time you queried it. To see updates to these values, simply refresh the page.

Likewise, if you wish to view the metrics in json format, visit the following URL:

http://localhost:9101/json_metrics

Change inspection service port

The inspection service should run on all nodes by default, at port 9101. To change the port the inspection service listens on (e.g., to 1000), add the following to your node configuration file:

inspection_service:
  port: 1000

Expose system configuration

The inspection service also provides a way to examine the configuration of your node at runtime (i.e., the configuration settings that your node started with).

To enable this feature, add the following to your node configuration file:

inspection_service:
  expose_configuration: true

And visit the configuration URL:

http://localhost:9101/configuration

Expose system information

Likewise, the inspection service also provides a way to examine the system information of your node at runtime (i.e., build and hardware information). Simply visit the following URL:

http://localhost:9101/system_information

If you’d like to disable this endpoint, add the following to your node configuration file:

inspection_service:
  expose_system_information: false