Files
logos-messaging-module/docs/query-node.md

1.9 KiB

Query a running node

A delivery node exposes no HTTP/REST API. All node info — identity, version, and Prometheus metrics — is read through the logoscore CLI talking to the daemon. Assumes a node started per run-node.md.

Run the commands inside the container (docker exec logos-node ...) or directly if you have logoscore on the host.

List available info

logoscore call delivery_module getAvailableNodeInfoIDs --json | jq
{
  "method": "getAvailableNodeInfoIDs",
  "module": "delivery_module",
  "result": {
    "error": null,
    "success": true,
    "value": "@[Version, Metrics, MyMultiaddresses, MyENR, MyPeerId]"
  },
  "status": "ok"
}

Read a specific value

logoscore call delivery_module getNodeInfo MyENR --json | jq
{
  "method": "getNodeInfo",
  "module": "delivery_module",
  "result": {
    "error": null,
    "success": true,
    "value": "enr:-LW4QItc5tHj3rWoFaaQIUWvaBYijDf2TJKW83SNdyylJVAYVoUlBl1h5..."
  },
  "status": "ok"
}

The value lives at .result.value. Extract it with jq -r:

logoscore call delivery_module getNodeInfo MyPeerId --json | jq -r '.result.value'

Info IDs

ID Command Returns
MyPeerId getNodeInfo MyPeerId libp2p peer ID
MyENR getNodeInfo MyENR discv5 ENR URI
MyMultiaddresses getNodeInfo MyMultiaddresses Listen multiaddresses
Metrics getNodeInfo Metrics Prometheus text exposition
Version getNodeInfo Version liblogosdelivery version

The logoscore binary version is in logoscore status --json.daemon.version.