1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# Plugin to monitor the amount shares to and from the specified nextcloud instance
#
# Parameters understood:
# config (required)
# autoconf (optional - used by munin-config)
# Magic markers - optional - used by installation scripts and
# munin-config:
#
# #%# family=manual
# #%# capabilities=autoconf
import re
import requests
import sys
import os
class NextcloudShares:
def config(self):
config = {
'shares': [
'graph_title Nextcloud Shares',
'graph_args --base 1024 -l 0',
'graph_vlabel number of shares',
'graph_info graph showing the number of shares',
'graph_category nextcloud',
'num_fed_shares_received.label federated shares recieved',
'num_fed_shares_received.info current total of federated shares recieved',
'num_fed_shares_sent.label federated shares sent',
'num_fed_shares_sent.info current total of federated shares sent',
'num_shares.label total number of shares',
'num_shares.info current over all total of shares',
'num_shares_groups.label group shares',
'num_shares_groups.info current total of group shares',
'num_shares_link.label link shares',
'num_shares_link.info current total of shares through a link',
'num_shares_link_no_password.label link shares without a password',
'num_shares_link_no_password.info current total of shares through a link without a password protection',
'num_shares_user.label user shares',
'num_shares_user.info current total of user shares'
]
}
return config
def get_data(self, api_response):
data ={
'nextcloud_shares': [],
}
shares = api_response['ocs']['data']['nextcloud']['shares']
# use regex to remove permission stats from api response
reg = re.compile("num.*")
share_keys = shares.keys()
sharelist = list(filter(reg.match, share_keys))
for key in sharelist:
data['nextcloud_shares'].append(str(key) + ".value " + str(shares[key]))
return data
def run(self):
# read the configuration from munin environment
URL = os.environ['url']
auth = (os.environ['username'], os.environ['password'])
# init requests session with specific header and credentials
with requests.Session() as s:
s.auth = auth
s.headers.update({'Accept': 'application/json'})
s.stream = False
# request data from api
r = s.get(URL)
# if status code is successful close connection and continue
if r.status_code == 200:
s.close()
api_response = r.json()
result = self.get_data(api_response)
for key in result.keys():
print('\n'.join(result[key]))
elif r.status_code == 996:
print('server error')
elif r.status_code == 997:
print('not authorized')
elif r.status_code == 998:
print('not found')
else:
print('unknown error')
def main(self):
if (sys.argv.__len__() == 2) and (sys.argv[1] == "config"):
for key in self.config().keys():
print('\n'.join(self.config()[key]))
try:
if os.environ['MUNIN_CAP_DIRTYCONFIG'] == '1':
self.run()
except KeyError:
pass
elif (sys.argv.__len__() == 2) and (sys.argv[1] == 'autoconf'):
# check host if env variables are set
try:
if None not in {os.environ['url'], os.environ['username'], os.environ['password']}:
print('yes')
except KeyError:
print('no env configuration options are missing')
else:
self.run()
if __name__ == "__main__":
NextcloudShares().main()
quit(0)
|
