--- /dev/null
+---
+layout: default
+title: Controlling the Daemon
+---
+
+The main daemon that runs on nodes keeps internal stats and supports reloading of agents and changing
+logging level without restarting.
+
+If you want to reload all the agents without restarting the daemon you can just send it signal *USR1*
+and it will reload its agents.
+
+You can send *USR2* to cycle the log level through DEBUG to FATAL and back again, just keep sending
+the signal and look at the logs.
+
+Reloading agents work in most cases though we recommend a full daemon restart in production use
+due to the nature of the ruby class loading system. If you are changing agent contents and relying
+on the reload behavior you might end up with agents not being in a consistent state.
+
+## Obtaining daemon statistics
+
+The daemon keeps a number of statistics about its operation, you can view these using the _inventory_
+application:
+
+{% highlight console %}
+% mco inventory example.com
+ Server Statistics:
+ Version: 2.2.0
+ Start Time: Mon Sep 24 17:37:28 +0100 2012
+ Config File: /etc/mcollective/server.cfg
+ Collectives: mcollective, fr_collective
+ Main Collective: mcollective
+ Process ID: 24473
+ Total Messages: 52339
+ Messages Passed Filters: 44118
+ Messages Filtered: 8221
+ Expired Messages: 0
+ Replies Sent: 29850
+ Total Processor Time: 527.06 seconds
+ System Time: 349.32 seconds
+
+.
+.
+.
+{% endhighlight %}
+
+The statistics mean:
+
+|Statistic |Meaning |
+|------------|-------------------------------------------|
+|Start Time |Local time on the node when the daemon started|
+|Collectives |All known collectives this agent responds on|
+|Main Collective |The primary collective|
+|Process ID |The process ID of the mcollectived|
+|Total Messages |Total messages received from the middleware|
+|Messages Passed Filters|Amount of messages that was determined to be applicable to this node based on filters|
+|Messages Filtered |Messages that did not apply to this node|
+|Expired Messages |Received messages that had expired their TTL values|
+|Replies Sent |Not all received messages result in replies, this counts the actual replies sent|
+|Total Processor Time |Processor time including user and system time consumed since start|
+|System Time |System Processor time only|
+
+You can get the raw values using the *rpcutil* agent using the *daemon_stats* action.
+
+{% highlight console %}
+% mco rpc rpcutil daemon_stats
+Discovering hosts using the mongo method .... 26
+
+ * [ ============================================================> ] 26 / 26
+
+.
+.
+.
+
+example.com
+ Agents: ["stomputil",
+ "nrpe",
+ "package",
+ "rpcutil",
+ "rndc",
+ "urltest",
+ "iptables",
+ "puppetd",
+ "discovery",
+ "service",
+ "eximng",
+ "filemgr",
+ "process"]
+ Config File: /etc/mcollective/server.cfg
+ Failed Filter: 168432
+ Passed Filter: 91231
+ PID: 1418
+ Replies: 91127
+ Start Time: 1347545937
+ Threads: ["#<Thread:0x7f44350964f8 sleep>",
+ "#<Thread:0x7f4434f7f538 sleep>",
+ "#<Thread:0x7f44390ce368 sleep>",
+ "#<Thread:0x7f44350981b8 run>"]
+ Times: {:cutime=>1111.13, :utime=>3539.21, :cstime=>1243.64, :stime=>5045.21}
+ Total Messages: 259842
+ TTL Expired: 179
+ Failed Security: 0
+ Security Validated: 259842
+ Version: 2.2.0
+
+
+Summary of Agents:
+
+ package = 26
+ process = 26
+ discovery = 26
+ service = 26
+ puppetd = 26
+ filemgr = 26
+ nrpe = 26
+ rpcutil = 26
+ stomputil = 26
+ iptables = 11
+ urltest = 7
+ libvirt = 4
+ eximng = 4
+ registration = 3
+ rndc = 3
+ angelianotify = 2
+
+Summary of Version:
+
+ 2.2.0 = 26
+
+Finished processing 26 / 26 hosts in 289.20 ms
+{% endhighlight %}
+
+## Obtaining running configuration settings
+
+All configuration settings of any mcollective daemon can be retrieved using the *get_config_item*
+action of the *rpcutil* agent:
+
+{% highlight console %}
+% mco rpc rpcutil get_config_item item=collectives -I example.com
+Discovering hosts using the mongo method .... 1
+
+ * [ ============================================================> ] 1 / 1
+
+
+example.com:
+ Property: collectives
+ Value: ["mcollective", "fr_collective"]
+
+
+Summary of Value:
+
+ mcollective = 1
+ fr_collective = 1
+
+
+Finished processing 1 / 1 hosts in 59.05 ms
+{% endhighlight %}
Code Review / packages / precise / mcollective.git / blobdiff