@cryptotaxi247 / netdata-1 / commits / b682a71fc

better tomcat chart naming

paulfantom committed Aug 16, 2016 at 21:32 UTC b682a71fc942ccdb5954d53c6e97e1574c85e32c
2 files changed +315 -5
python.d/README.md
+312 -2
@@ -1,7 +1,5 @@
1 # Disclaimer
2
3 -**Python support is experimental and implementation may change in the future**
4 -
3 Every module should be compatible with python2 and python3.
4 All third party libraries should be installed system-wide or in `python_modules` directory.
5 Module configurations are written in YAML and **pyYAML is required**.
@@ -127,6 +125,114 @@ If no configuration is given, module will attempt to read log file at `/var/log/
125
126 ---
127
128 +# cpufreq
129 +
130 +Module shows current cpu frequency by looking at appropriate files in /sys/devices
131 +
132 +**Requirement:**
133 +Processor which presents data scaling frequency data
134 +
135 +It produces one chart with multiple lines (one line per core).
136 +
137 +### configuration
138 +
139 +Sample:
140 +
141 +```yaml
142 +sys_dir: "/sys/devices"
143 +```
144 +
145 +If no configuration is given, module will search for `scaling_cur_freq` files in `/sys/devices` directory.
146 +Directory is also prefixed with `NETDATA_HOST_PREFIX` if specified.
147 +
148 +---
149 +
150 +# dovecot
151 +
152 +This module provides statistics information from dovecot server.
153 +Statistics are taken from dovecot socket by executing `EXPORT global` command.
154 +More information about dovecot stats can be found on [project wiki page.](http://wiki2.dovecot.org/Statistics)
155 +
156 +**Requirement:**
157 +Dovecot unix socket with R/W permissions for user netdata or dovecot with configured TCP/IP socket.
158 +
159 +Module gives information with following charts:
160 +
161 +1. **logins and sessions**
162 + * logins
163 + * active sessions
164 +
165 +2. **commands** - number of IMAP commands
166 + * commands
167 +
168 +3. **Faults**
169 + * minor
170 + * major
171 +
172 +4. **Context Switches**
173 + * volountary
174 + * involountary
175 +
176 +5. **disk** in bytes/s
177 + * read
178 + * write
179 +
180 +6. **bytes** in bytes/s
181 + * read
182 + * write
183 +
184 +7. **number of syscalls** in syscalls/s
185 + * read
186 + * write
187 +
188 +8. **lookups** - number of lookups per second
189 + * path
190 + * attr
191 +
192 +9. **hits** - number of cache hits
193 + * hits
194 +
195 +10. **attempts** - authorization attemts
196 + * success
197 + * failure
198 +
199 +11. **cache** - cached authorization hits
200 + * hit
201 + * miss
202 +
203 +### configuration
204 +
205 +Sample:
206 +
207 +```yaml
208 +localtcpip:
209 + name : 'local'
210 + host : '127.0.0.1'
211 + port : 24242
212 +
213 +localsocket:
214 + name : 'local'
215 + socket : '/var/run/dovecot/stats'
216 +```
217 +
218 +If no configuration is given, module will attempt to connect to dovecot using unix socket localized in `/var/run/dovecot/stats`
219 +
220 +---
221 +
222 +# exim
223 +
224 +Simple module executing `exim -bpc` to grab exim queue.
225 +This command can take a lot of time to finish its execution thus it is not recommended to run it every second.
226 +
227 +It produces only one chart:
228 +
229 +1. **Exim Queue Emails**
230 + * emails
231 +
232 +Configuration is not needed.
233 +
234 +---
235 +
236 # hddtemp
237
238 Module monitors disk temperatures from one or more hddtemp daemons
@@ -150,6 +256,101 @@ If no configuration is given, module will attempt to connect to hddtemp daemon o
256
257 ---
258
259 +# IPFS
260 +
261 +Module monitors [IPFS](https://ipfs.io) basic information.
262 +
263 +1. **Bandwidth** in kbits/s
264 + * in
265 + * out
266 +
267 +2. **Peers**
268 + * peers
269 +
270 +### configuration
271 +
272 +Only url to IPFS server is needed.
273 +
274 +Sample:
275 +
276 +```yaml
277 +localhost:
278 + name : 'local'
279 + url : 'http://localhost:5001'
280 +```
281 +
282 +---
283 +
284 +# memcached
285 +
286 +Memcached monitoring module. Data grabbed from [stats interface](https://github.com/memcached/memcached/wiki/Commands#stats).
287 +
288 +1. **Network** in kilobytes/s
289 + * read
290 + * written
291 +
292 +2. **Connections** per second
293 + * current
294 + * rejected
295 + * total
296 +
297 +3. **Items** in cluster
298 + * current
299 + * total
300 +
301 +4. **Evicted and Reclaimed** items
302 + * evicted
303 + * reclaimed
304 +
305 +5. **GET** requests/s
306 + * hits
307 + * misses
308 +
309 +6. **GET rate** rate in requests/s
310 + * rate
311 +
312 +7. **SET rate** rate in requests/s
313 + * rate
314 +
315 +8. **DELETE** requests/s
316 + * hits
317 + * misses
318 +
319 +9. **CAS** requests/s
320 + * hits
321 + * misses
322 + * bad value
323 +
324 +10. **Increment** requests/s
325 + * hits
326 + * misses
327 +
328 +11. **Decrement** requests/s
329 + * hits
330 + * misses
331 +
332 +12. **Touch** requests/s
333 + * hits
334 + * misses
335 +
336 +13. **Touch rate** rate in requests/s
337 + * rate
338 +
339 +### configuration
340 +
341 +Sample:
342 +
343 +```yaml
344 +localtcpip:
345 + name : 'local'
346 + host : '127.0.0.1'
347 + port : 24242
348 +```
349 +
350 +If no configuration is given, module will attempt to connect to memcached instance on `127.0.0.1:11211` address.
351 +
352 +---
353 +
354 # mysql
355
356 Module monitors one or more mysql servers
@@ -284,6 +485,33 @@ Without configuration, module attempts to connect to `http://localhost/stub_stat
485
486 ---
487
488 +# nginx_log
489 +
490 +Module monitors nginx access log and produces only one chart:
491 +
492 +1. **nginx status codes** in requests/s
493 + * 2xx
494 + * 3xx
495 + * 4xx
496 + * 5xx
497 +
498 +### configuration
499 +
500 +Sample for two vhosts:
501 +
502 +```yaml
503 +site_A:
504 + path: '/var/log/nginx/access-A.log'
505 +
506 +site_B:
507 + name: 'local'
508 + path: '/var/log/nginx/access-B.log'
509 +```
510 +
511 +When no configuration file is found, module tries to parse `/var/log/nginx/access.log` file.
512 +
513 +---
514 +
515 # phpfpm
516
517 This module will monitor one or more php-fpm instances depending on configuration.
@@ -325,6 +553,69 @@ Without configuration, module attempts to connect to `http://localhost/status`
553
554 ---
555
556 +# postfix
557 +
558 +Simple module executing `postfix -p` to grab postfix queue.
559 +
560 +It produces only two charts:
561 +
562 +1. **Postfix Queue Emails**
563 + * emails
564 +
565 +2. **Postfix Queue Emails Size** in KB
566 + * size
567 +
568 +Configuration is not needed.
569 +
570 +---
571 +
572 +# redis
573 +
574 +Get INFO data from redis instance.
575 +
576 +Following charts are drawn:
577 +
578 +1. **Operations** per second
579 + * operations
580 +
581 +2. **Hit rate** in percent
582 + * rate
583 +
584 +3. **Memory utilization** in kilobytes
585 + * total
586 + * lua
587 +
588 +4. **Database keys**
589 + * lines are creates dynamically based on how many databases are there
590 +
591 +5. **Clients**
592 + * connected
593 + * blocked
594 +
595 +6. **Slaves**
596 + * connected
597 +
598 +### configuration
599 +
600 +```yaml
601 +socket:
602 + name : 'local'
603 + socket : '/var/lib/redis/redis.sock'
604 +
605 +localhost:
606 + name : 'local'
607 + host : 'localhost'
608 + port : 6379
609 +```
610 +
611 +When no configuration file is found, module tries to connect to TCP/IP socket: `localhost:6379`.
612 +
613 +---
614 +
615 +# sensors
616 +
617 +---
618 +
619 # squid
620
621 This module will monitor one or more squid instances depending on configuration.
@@ -362,4 +653,23 @@ local:
653
654 Without any configuration module will try to autodetect where squid presents its `counters` data
655
656 +---
657 +
658 +# tomcat
659 +
660 +Present tomcat containers memory utilization.
661 +
662 +Charts:
663 +
664 +1. **requests** per second
665 + * accesses
666 +
667 +2. **volume** in KB/s
668 + * volume
669 +
670 +3. **threads**
671 +
672 +
673 +Without configuration, module attempts to connect to `http://localhost:8080/manager/status?XML=true`
674 +
675 ---
\ No newline at end of file
python.d/tomcat.chart.py
+3 -3
@@ -18,17 +18,17 @@ ORDER = ['accesses', 'volume', 'threads', 'jvm']
18
19 CHARTS = {
20 'accesses': {
21 - 'options': [None, "tomcat requests", "requests/s", "statistics", "tomcat.accesses", "area"],
21 + 'options': [None, "Requests", "requests/s", "statistics", "tomcat.accesses", "area"],
22 'lines': [
23 ["accesses", None, 'incremental']
24 ]},
25 'volume': {
26 - 'options': [None, "tomcat volume", "KB/s", "volume", "tomcat.volume", "area"],
26 + 'options': [None, "Volume", "KB/s", "volume", "tomcat.volume", "area"],
27 'lines': [
28 ["volume", None, 'incremental', 1, 1024]
29 ]},
30 'threads': {
31 - 'options': [None, "tomcat threads", "current threads", "statistics", "tomcat.threads", "line"],
31 + 'options': [None, "Threads", "current threads", "statistics", "tomcat.threads", "line"],
32 'lines': [
33 ["current", None, "absolute"],
34 ["busy", None, "absolute"]