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
|
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# Plugin to monitor the amount of users sucessfully logging in to 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 requests
import sys
import os
class NextcloudUsers:
def __init__(self):
self.config = [
# users
'graph_title Nextcloud User Activity',
'graph_args --base 1000 -l 0',
'graph_printf %.0lf',
'graph_vlabel connected users',
'graph_info graph showing the number of connected user',
'graph_category nextcloud',
'last5minutes.label last 5 minutes',
'last5minutes.info users connected in the last 5 minutes',
'last5minutes.min 0',
'last1hour.label last hour',
'last1hour.info users connected in the last hour',
'last1hour.min 0',
'last24hours.label last 24 hours',
'last24hours.info users connected in the last 24 hours',
'last24hours.min 0',
'num_users.label number of users',
'num_users.info total number of users',
'num_users.min 0'
]
self.result = list()
def parse_data(self, api_response):
users = api_response['ocs']['data']['activeUsers']
num_users = api_response['ocs']['data']['nextcloud']['storage']['num_users']
# append for every key in users the key and the value to the results
for key, value in users.items():
self.result.append('{k}.value {v}'.format(k=key, v=value))
def run(self):
# init request session with specific header and credentials
with requests.Session() as s:
# read credentials from env
s.auth = (os.environ.get('username'), os.environ.get('password'))
# update header for json
s.headers.update({'Accept': 'application/json'})
# request the data
r = s.get(os.environ.get('url'))
# if status code is successful continue
if r.status_code == 200:
self.parse_data(r.json())
# output results to stdout
for el in self.result:
print(el, file=sys.stdout)
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):
# check if any argument is given
if sys.argv.__len__() >= 2:
# check if first argument is config or autoconf if not fetch data
if sys.argv[1] == "config":
# output config list to stdout
for el in self.config:
print(el, file=sys.stdout)
# if DIRTYCONFIG true also return the corresponding values
if os.environ.get('MUNIN_CAP_DIRTYCONFIG') == '1':
self.run()
elif sys.argv[1] == 'autoconf':
if None in [os.environ.get('username'), os.environ.get('password')]:
print('env variables are missing')
else:
print('yes')
else:
self.run()
if __name__ == "__main__":
NextcloudUsers().main()
|
