Control Plane Monitoring

How do I access Worker Node control plane logs?

Node Engine Component

Run the following command to access the logs:

sudo NodeEngine logs

Or you can manually access the logs in

/var/log/oakestra/nodeengine.log

Net Manager Component

NetManager logs are available at this location on every Worker Node:

/var/log/oakestra/netmanager.log

How do I activate Debug Mode in NetManager?

You can add the debug true flag in your netcfg.json file as follows:

1: Stop the Worker Node using sudo NodeEngine stop

2: Edit the netcfg.json file located at /etc/netmanager/netcfg.json and add "Debug": true

/etc/netmanager/netcfg.json
{
  "NodePublicAddress": "0.0.0.0",
  "NodePublicPort": "50103",
  "ClusterUrl": "0.0.0.0",
  "ClusterMqttPort": "10003",
  "Debug": true
}

3: Restart the Worker Node using sudo NodeEngine start

Legacy v0.4.301 or previous releases

If you’re running a legacy NetManager and NodeEngine v0.4.301 or previous releases, just start the NetManager using the -D flag. E.g., NetManager -p 6000 -D

You can check your NodeEngine version by running NodeEngine version

Accessing Root Orchestrator database component

You can access a live MongoDB shell of each one of the Oakestra’s databases by running the following commands:

For the System Manager database run:

docker exec -it mongo mongo localhost:10007

For the Root Service Manager DB run:

docker exec -it mongo mongo_net localhost:10008

This command opens a shell to the corresponding MongoDB instance running on the root orchestrator. From here, you can run MongoDB commands to query the database.

For example:

show dbs #shows all available databases.
use clusters #move to the clusters database
db.clusters.find().pretty() #pretty print of the clusters collection
use jobs #move to the jobs database
db.jobs.find().pretty() #pretty print of all the jobs

Access Cluster Orchestrator database component

You can access a live MongoDB shell of each one of the Oakestra Cluster’s databases by running the following commands:

For the System Manager DB run:

docker exec -it cluster_mongo mongo localhost:10107

For the Root Service Manager DB run:

docker exec -it cluster_mongo_net mongo_net localhost:10108

This command opens a shell to the corresponding MongoDB instance running on the cluster orchestrator. From here, you can run MongoDB commands to query the database.