Monitoring and managing services¶

Check the state of nodes and manage units in your system.

Monitoring nodes¶

You can check the state of nodes in your system. The bluechictl status command indicates whether nodes are online and when they were last seen. You can monitor single nodes or all the nodes in your system.

Commands to monitor nodes

Command	Purpose
`bluechictl status`	Verify the status of all nodes.
`bluechictl status -w`	Continuously watch the status of all nodes.
`bluechictl status _<NodeName>_`	Verify the status of a specific node.
`bluechictl status _<NodeName>_ -w`	Continuously watch the status of a specific node.

Monitoring units¶

Services, such as bluechi-controller.service and bluechi-agent.service are examples of units. Use these commands to list units and monitor changes to the services.

Commands to monitor units

Command	Purpose
`bluechictl list-units`	List all units on all nodes.
`bluechictl list-units --filter=demo-\*.service`	Use a glob pattern to filter services; this example lists services that start with `demo`.
`bluechictl list-units _<NodeName>_`	List all units on a specific node.
`bluechictl monitor _<NodeName>_ _<UnitName>_`	View changes on a specific node and unit.
`bluechictl monitor \* \*`	Use the wildcard character `*` to view changes on all units on all node.

Managing units¶

Additional bluechictl commands exist to start and stop services and manage them in other ways during the testing process.

Commands to manage units

Command	Purpose
`bluechictl start`	Starts `systemd` units on managed nodes.
`bluechictl stop`	Stops `systemd` units on managed nodes.
`bluechictl enable`	Enables services on managed nodes.
`bluechictl disable`	Disables services on managed nodes.
`bluechictl freeze`	Temporarily prevents identified services from receiving CPU time.
`bluechictl thaw`	Restores CPU time to identified services.

For more information about how to use bluechictl commands, see Examples on how to use BlueChi on the BlueChi Documentation site.

Additional resources