Zmstats

Zmstats

Zmstats is how Zimbra exposes its performance metrics and statistics to the world. The information covers a wide array of data: disk usage, cpu utilization, java statistics, zimbra counters and beyond.

---

Zmstats consists of the following components and scripts:

• zmstatctl
  • zmstat-fd
  • zmstat-df
  • zmstat-cpu
  • zmstat-proc
  • zmstat-io
  • zmstat-vm
  • zmstat-convertd
  • zmstat-mtaqueue
  • zmstat-mysql
• zmstat-chart
  • zmstat-chart-config

zmstatctl

zmstatctl is used to start and stop and various zmstat-* data logging scripts

zmstat-chart

zmstat-chart reads an XML configuration file generated by zmstat-chart-config and generates a set of HTML and PNG graph images suitable for rapidly diagnosing problems and load issues.

zmstat-chart-config.xml

Used to control what is graphed and how

Examples:

 <chart title="Mailboxd: JVM Heap Used"
        category="mailboxd"
        infile="mailboxd.csv"
        outfile="mboxd-heap-used.png"
        yAxis="MB">
   <plot data="heap_used" legend="total" divisor="1m"/>
 </chart>

The above defines a chart that reads the counter "heap_used" out of mailboxd.csv. It takes that counter and graphs it to a file "mboxd-heap-used.png". There will be a resulting graph with a yAxis labelled "MB" and "heap_used" divided by 1million (megabytes) will be graphed over time.

Multiple plots can be placed onto a single chart through the use of additional <plot> elements.

See /opt/zimbra/conf/zmstat-chart.xml for more examples

Individual stat scripts and their related counters

zmstat-fd: fd.csv

Captures file descriptor usage on the system

• fd_count: current number of open file descriptors

zmstat-df: df.csv

Captures disk usage

• path: mount point
• disk: device
• disk_use: space used
• disk_pct_used: percentage used
• disk_space: total space

zmstat-cpu: cpu.csv

• cpu:user: total user time
• cpu:nice: total nice process time
• cpu:sys: total system time
• cpu:idle: total idle time
• cpu:iowait: total time in iowait
• cpu:irq: total time in irq
• cpu:softirq: total time in softirq
• cpuN:XXX: same as above, but per individual core/cpu

zmstat-io: io.csv and io-x.csv

• dev:tps: transactions per second
• dev:kB_read/s: read rate
• dev:kB_wrtn/s: write rate
• dev:kB_read: bytes read
• dev:kB_wrtn: bytes written

• dev:rrqm/s: read requests merged per second queued to device
• dev:wrqm/s: write requests merged per second queued to device
• dev:r/s: reads per second
• dev:w/s: writes per second
• dev:rkB/s read rate
• dev:wkB/s: write rate
• dev:avgrq-sz: average size (sectors) of requests
• dev:avgqu-sz: average queue length
• dev:await: average wait time for requests to be served
• dev:svctm: average time to service requests
• dev:%util: percentage of CPU time / bandwidth utilization of device

zmstat-proc: proc.csv

• user: total user time
• sys: total system time
• idle: total idle time
• iowait: total iowait time
• PROC-total-cpu: total cpu usage for PROC
• PROC-utime: usertime for PROC
• PROC-stime: system time for PROC
• PROC-totalMB: total memory footprint for PROC
• PROC-rssMB: resident-set-size of PROC
• PROC-sharedMB: shared memory of PROC
• PROC-process-count: number of threads/subprocesses

zmstat-vm: vm.csv

The output of vmstat(1) is recorded for reviewable statistics.

• r:
• b:
• swpd:
• free:
• buff:
• cache:
• si:
• so:
• bi:
• bo:
• in:
• cs:
• us:
• sy:
• id:
• wa:
• st:
• ...: other counters reported by vmstat