]> arthur.barton.de Git - netdata.git/blob - python.d/README.md
preserve configs across installaitons
[netdata.git] / python.d / README.md
1 Every plugin supports changing its data collection frequency by setting `update_every` variable in its configuration file.
2
3 The following python.d plugins are supported:
4
5 # mysql
6
7 The plugin will monitor one or more mysql servers
8
9 It will produce the following charts (if data is available):
10
11 1. **Bandwidth** in kbps
12  * in
13  * out
14
15 2. **Queries** in queries/sec
16  * queries
17  * questions
18  * slow queries
19
20 3. **Operations** in operations/sec
21  * opened tables
22  * flush
23  * commit
24  * delete
25  * prepare
26  * read first
27  * read key
28  * read next
29  * read prev
30  * read random
31  * read random next
32  * rollback
33  * save point
34  * update
35  * write
36
37 4. **Table Locks** in locks/sec
38  * immediate
39  * waited
40
41 5. **Select Issues** in issues/sec
42  * full join
43  * full range join
44  * range
45  * range check
46  * scan
47
48 6. **Sort Issues** in issues/sec
49  * merge passes
50  * range
51  * scan
52
53 ### configuration
54
55 You can provide, per server, the following:
56
57 1. a name, anything you like, but keep it short
58 2. username which have access to database (deafults to 'root')
59 3. password (defaults to none)
60 4. mysql socket (optional)
61 5. mysql host (ip or hostname)
62 3. mysql port (defaults to 3306)
63
64 Here is an example for 2 servers updating data every 10 seconds
65
66 ```js
67 update_every = 10
68
69 config=[
70     {
71         'name'     : 'local',
72         'user'     : 'root',
73         'password' : 'blablablabla',
74         'socket'   : '/var/run/mysqld/mysqld.sock'
75     },{
76         'name'     : 'remote',
77         'user'     : 'admin',
78         'password' : 'bla',
79         'host'     : 'example.org',
80         'port'     : '9000'
81     }]
82 ```
83
84 If no configuration is given, the plugin will attempt to connect to mysql server via unix socket at `/var/run/mysqld/mysqld.sock` without password and username `root`
85
86 ---
87