---
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 %}