├── .gitignore
├── Dockerfile
├── LICENSE
├── Makefile
├── README.md
├── bbb-mon
    ├── api_lib.py
    ├── frontend
    │   ├── index.html
    │   └── main.js
    ├── server.py
    ├── settings.py
    └── views.py
├── build-docker.sh
├── demo.png
├── docker-compose.yaml
└── requirements.txt


/.gitignore:
--------------------------------------------------------------------------------
  1 | # Byte-compiled / optimized / DLL files
  2 | __pycache__/
  3 | *.py[cod]
  4 | *$py.class
  5 | 
  6 | # C extensions
  7 | *.so
  8 | 
  9 | # Distribution / packaging
 10 | .Python
 11 | build/
 12 | develop-eggs/
 13 | dist/
 14 | downloads/
 15 | eggs/
 16 | .eggs/
 17 | lib/
 18 | lib64/
 19 | parts/
 20 | sdist/
 21 | var/
 22 | wheels/
 23 | share/python-wheels/
 24 | *.egg-info/
 25 | .installed.cfg
 26 | *.egg
 27 | MANIFEST
 28 | 
 29 | # PyInstaller
 30 | #  Usually these files are written by a python script from a template
 31 | #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 32 | *.manifest
 33 | *.spec
 34 | 
 35 | # Installer logs
 36 | pip-log.txt
 37 | pip-delete-this-directory.txt
 38 | 
 39 | # Unit test / coverage reports
 40 | htmlcov/
 41 | .tox/
 42 | .nox/
 43 | .coverage
 44 | .coverage.*
 45 | .cache
 46 | nosetests.xml
 47 | coverage.xml
 48 | *.cover
 49 | *.py,cover
 50 | .hypothesis/
 51 | .pytest_cache/
 52 | cover/
 53 | 
 54 | # Translations
 55 | *.mo
 56 | *.pot
 57 | 
 58 | # Django stuff:
 59 | *.log
 60 | local_settings.py
 61 | db.sqlite3
 62 | db.sqlite3-journal
 63 | 
 64 | # Flask stuff:
 65 | instance/
 66 | .webassets-cache
 67 | 
 68 | # Scrapy stuff:
 69 | .scrapy
 70 | 
 71 | # Sphinx documentation
 72 | docs/_build/
 73 | 
 74 | # PyBuilder
 75 | .pybuilder/
 76 | target/
 77 | 
 78 | # Jupyter Notebook
 79 | .ipynb_checkpoints
 80 | 
 81 | # IPython
 82 | profile_default/
 83 | ipython_config.py
 84 | 
 85 | # pyenv
 86 | #   For a library or package, you might want to ignore these files since the code is
 87 | #   intended to run in multiple environments; otherwise, check them in:
 88 | # .python-version
 89 | 
 90 | # pipenv
 91 | #   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
 92 | #   However, in case of collaboration, if having platform-specific dependencies or dependencies
 93 | #   having no cross-platform support, pipenv may install dependencies that don't work, or not
 94 | #   install all needed dependencies.
 95 | #Pipfile.lock
 96 | 
 97 | # PEP 582; used by e.g. github.com/David-OConnor/pyflow
 98 | __pypackages__/
 99 | 
100 | # Celery stuff
101 | celerybeat-schedule
102 | celerybeat.pid
103 | 
104 | # SageMath parsed files
105 | *.sage.py
106 | 
107 | # Environments
108 | .env
109 | .venv
110 | env/
111 | venv/
112 | ENV/
113 | env.bak/
114 | venv.bak/
115 | 
116 | # Spyder project settings
117 | .spyderproject
118 | .spyproject
119 | 
120 | # Rope project settings
121 | .ropeproject
122 | 
123 | # mkdocs documentation
124 | /site
125 | 
126 | # mypy
127 | .mypy_cache/
128 | .dmypy.json
129 | dmypy.json
130 | 
131 | # Pyre type checker
132 | .pyre/
133 | 
134 | # pytype static type analyzer
135 | .pytype/
136 | 
137 | # Cython debug symbols
138 | cython_debug/
139 | 
140 | .idea


--------------------------------------------------------------------------------
/Dockerfile:
--------------------------------------------------------------------------------
 1 | FROM python:3.7-stretch
 2 | EXPOSE 5000
 3 | 
 4 | COPY requirements.txt /app/requirements.txt
 5 | RUN pip install --no-cache-dir -r /app/requirements.txt
 6 | 
 7 | COPY . /app
 8 | WORKDIR /app
 9 | ENTRYPOINT ["python"]
10 | CMD ["bbb-mon/server.py"]


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | Copyright 2020 Gregor R. Krmelj
2 | 
3 | Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
4 | 
5 | The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
6 | 
7 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
1 | .PHONY: docker-build
2 | docker-build:
3 | 	bash build-docker.sh


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # BigBlueButton Monitoring Web App
 2 | Super simple monitoring web app for BigBlueButton that will display a list of all current meetings on your BigBlueButton server.
 3 | 
 4 | ![Docker Image Version (latest semver)](https://img.shields.io/docker/v/greenstatic/bigbluebutton-monitoring?label=latest%20docker%20image&logo=Docker&sort=semver)
 5 | ![Docker Pulls](https://img.shields.io/docker/pulls/greenstatic/bigbluebutton-monitoring?logo=Docker)
 6 | ![GitHub](https://img.shields.io/github/license/greenstatic/bigbluebutton-monitoring)
 7 | 
 8 | 
 9 | Required ENV variables:
10 | * API_BASE_URL
11 | * API_SECRET
12 | 
13 | HTTP server will listen on port: 5000
14 | 
15 | Docker Hub: [https://hub.docker.com/r/greenstatic/bigbluebutton-monitoring](https://hub.docker.com/r/greenstatic/bigbluebutton-monitoring)
16 | 
17 | ---
18 | 
19 | See [BigBlueButton-exporter](https://github.com/greenstatic/bigbluebutton-exporter) to integrate BigBlueButton metrics into Prometheus and display them in Grafana.
20 | 
21 | ## Demo Screenshot
22 | ![demo-screenshot](demo.png)
23 | 
24 | ## Installation
25 | We assume you have docker installed and configured, as well as nginx.
26 | ### Using docker-compose
27 | Make sure you have docker-compose installed.
28 | 
29 | 1. On your BigBlueButton server
30 |    ```bash
31 |    mkdir ~/bbb-monitor
32 |    ``` 
33 | 2. Create the file `~/bbb-monitor/docker-compose.yaml` and copy the contents of `docker-compose.yaml` from this repository.
34 | 3. Edit `~/bbb-monitor/docker-compose.yaml` and replace the required fields
35 | 4. Create the file `~/bbb-monitor/secrets.env` and place your API_SECRET in it. It should look something like this:
36 |    ```
37 |    API_SECRET=<TODO: YOUR API SECRET KEY>
38 |    ```
39 | 4. cd into `~/bbb-monitor` and run `sudo docker-compose up -d`.
40 |     * If you wish a specific version of the docker container run instead:
41 |     ```bash
42 |     sudo BBB_MONITORING_VERSION=<YOUR DESIRED DOCKER IMAGE VERSION> docker-compose up -d
43 |     ```  
44 |    
45 | ### Alternative Installation Without docker-compose
46 | ```bash
47 | # Example of API BASE URL: https://bbb.example.com/bigbluebutton/api/
48 | # API SECRET KEY can be found by SSH into BBB and running: `$ bbb-conf --secret`
49 | docker run --name bbb-monitoring -d -p 127.0.0.1:4000:5000 --env API_SECRET=<API SECRET KEY> --env API_BASE_URL=<API BASE URL> greenstatic/bigbluebutton-monitoring
50 | 
51 | 
52 | # If you wish to configure HTTP Basic Auth
53 | sudo apt-get install apache2-utils
54 | sudo htpasswd -c /etc/nginx/.htpasswd admin  # user: admin
55 | # then enter password
56 | 
57 | ```
58 | ### Nginx (Common for Both Installation Methods)
59 | 
60 | Then you can proxy to the `bbb-monitoring` container running on port 4000 (localhost only).
61 | Example nginx config with HTTP basic auth:
62 | ```
63 | # BigBlueButton Monitoring
64 |         location /_monitoring/ {
65 |            auth_basic "BigBlueButton Monitoring";
66 |            auth_basic_user_file /etc/nginx/.htpasswd;
67 |            proxy_pass         http://127.0.0.1:4000/;
68 |            proxy_redirect     default;
69 |            proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
70 |            client_max_body_size       10m;
71 |            client_body_buffer_size    128k;
72 |            proxy_connect_timeout      90;
73 |            proxy_send_timeout         90;
74 |            proxy_read_timeout         90;
75 |            proxy_buffer_size          4k;
76 |            proxy_buffers              4 32k;
77 |            proxy_busy_buffers_size    64k;
78 |            proxy_temp_file_write_size 64k;
79 |            include    fastcgi_params;
80 |         }
81 | ```
82 | 
83 | ## Environment Variables
84 | * API_BASE_URL
85 | * API_SECRET
86 | * DEBUG: - Verbose logging, useful when debugging
87 |     * Values: true/false
88 | 
89 | ## Development
90 | ```bash
91 | # Do not forget to install requirements.txt and have the required ENV variables set!
92 | python3 bbb-mon/server.py
93 | ```
94 | 
95 | On master push, a build job will automatically build a Docker image on Docker Hub (link to Docker Hub repoistory is above).
96 | 


--------------------------------------------------------------------------------
/bbb-mon/api_lib.py:
--------------------------------------------------------------------------------
 1 | import collections
 2 | import hashlib
 3 | import logging
 4 | from typing import Optional
 5 | from urllib.parse import urljoin
 6 | 
 7 | import requests
 8 | import xmltodict as xmltodict
 9 | 
10 | import settings
11 | 
12 | 
13 | class Client:
14 |     def __init__(self, base_url: str, secret: str):
15 |         self.base_url = base_url
16 |         self.secret = secret
17 | 
18 | 
19 | def api_get_call(endpoint: str, client: Client) -> Optional[collections.OrderedDict]:
20 |     """
21 |     TODO - add param option
22 |     """
23 | 
24 |     plaintext = endpoint + client.secret
25 |     sha1 = hashlib.sha1()
26 |     sha1.update(plaintext.encode('utf-8'))
27 |     checksum = sha1.hexdigest()
28 | 
29 |     url = urljoin(client.base_url, endpoint + "?checksum=" + checksum)
30 | 
31 |     try:
32 |         r = requests.get(url)
33 |     except Exception as e:
34 |         logging.error("Failed to perform API call")
35 |         logging.error(e)
36 |         return None
37 | 
38 |     if int(r.status_code / 100) != 2:
39 |         logging.error("Non 2xx HTTP status code response")
40 |         logging.error(r.text)
41 |         return None
42 | 
43 |     if settings.DEBUG:
44 |         print(r.text)
45 | 
46 |     response = xmltodict.parse(r.text)
47 |     if response['response']['returncode'].lower() != "success":
48 |         logging.error("Recieved a non-success response: " + response['response']['message'])
49 |         return None
50 | 
51 |     return response
52 | 
53 | 
54 | def getMeetings(client: Client) -> Optional[collections.OrderedDict]:
55 |     return api_get_call("getMeetings", client)
56 | 
57 | 


--------------------------------------------------------------------------------
/bbb-mon/frontend/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html>
 3 | <head>
 4 |     <meta charset="utf-8">
 5 |     <title>BigBlueButton Monitoring</title>
 6 | 
 7 |     <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/css/bootstrap.min.css" integrity="sha384-Vkoo8x4CGsO3+Hhxv8T/Q5PaXtkKtu6ug5TOeNV6gBiFeWPGFN9MuhOf23Q9Ifjh" crossorigin="anonymous">
 8 | </head>
 9 | <body class="d-flex flex-column h-100">
10 |     <!-- Begin page content -->
11 |     <main role="main" class="flex-shrink-0">
12 |         <div class="container">
13 |             <h1 class="mt-5">BigBlueButton Monitoring</h1>
14 |             <noscript>Sorry, Javascript is needed for this page to work. Yeah it sucks.</noscript>
15 | 
16 |             <p class="lead">Quick overview of all current meetings on BigBlueButton</p>
17 | 
18 |             <p>BigBlueButton Server: <span id="text-server"></span></p>
19 |             <p>Last refresh: <span id="text-last-refresh"></span></p>
20 | 
21 |             <table id="meetings" class="table table-striped">
22 |                 <thead>
23 |                     <tr>
24 |                         <th scope="col">#</th>
25 |                         <th scope="col">Name</th>
26 |                         <th scope="col">No. users</th>
27 |                         <th scope="col">Moderators</th>
28 |                         <th scope="col">Origin Server</th>
29 |                         <th scope="col">Origin Context</th>
30 |                         <th scope="col">Creation</th>
31 |                     </tr>
32 |                 </thead>
33 |                     <tbody id="meetings-body">
34 | 
35 |                     </tbody>
36 |             </table>
37 | 
38 |             <p><small>Automatically refreshes every 15 seconds.</small></p>
39 | 
40 |             <div class="loading-spinner spinner-border" role="status">
41 |                 <span class="loading-spinner sr-only">Loading...</span>
42 |             </div>
43 | 
44 |         </div>
45 |     </main>
46 | 
47 |     <footer class="footer mt-auto py-3">
48 |         <div class="container">
49 |             <small>BigBlueButton Monitoring Version: <span id="text-version"></span> <br></small>
50 |             <span class="text-muted">
51 |                 Copyright &copy; <script>document.write(new Date().getFullYear())</script>
52 |                 <a href="https://github.com/greenstatic/bigbluebutton-monitoring">https://github.com/greenstatic/bigbluebutton-monitoring</a>
53 |             </span>
54 |         </div>
55 |     </footer>
56 | 
57 |     <script src="https://code.jquery.com/jquery-3.4.1.min.js" integrity="sha256-CSXorXvZcTkaix6Yvo6HppcZGetbYMGWSFlBw8HfCJo=" crossorigin="anonymous"></script>
58 |     <script src="https://cdn.jsdelivr.net/npm/popper.js@1.16.0/dist/umd/popper.min.js" integrity="sha384-Q6E9RHvbIyZFJoft+2mJbHaEWldlvI9IOYy5n3zV9zzTtmI3UksdQRVvoxMfooAo" crossorigin="anonymous"></script>
59 |     <script src="https://stackpath.bootstrapcdn.com/bootstrap/4.4.1/js/bootstrap.min.js" integrity="sha384-wfSDF2E50Y2D1uUdj0O3uMBJnjuUD4Ih7YwaYd1iqfktj0Uod8GCExl3Og8ifwB6" crossorigin="anonymous"></script>
60 | 
61 |     <script src="frontend/main.js"></script>
62 | </body>
63 | </html>


--------------------------------------------------------------------------------
/bbb-mon/frontend/main.js:
--------------------------------------------------------------------------------
 1 | function spinner(enable) {
 2 |     if (enable) {
 3 |         $('.loading-spinner').show();
 4 |     }
 5 |     else {
 6 |         $('.loading-spinner').hide();
 7 |     }
 8 | }
 9 | 
10 | function api_meetings() {
11 |     spinner(true);
12 | 
13 |     $.get("./api/meetings", function(data) {
14 |         console.log("API request: /api/meetings");
15 |         $("#meetings-body").empty();
16 | 
17 |         data.forEach(function(element, i) {
18 |             let mods = element.moderators.join(" | ");
19 | 
20 |             let creation = new Date(parseFloat(element.creation));
21 | 
22 |             let originContext = "";
23 |             if (element.metadata['origin-context']) {
24 |                 originContext = element.metadata['origin-context'];
25 |             }
26 | 
27 |             let markup = `<tr>
28 | <td>${i + 1}</td>
29 | <td>${element.name}</td>
30 | <td>${element.noUsers}</td>
31 | <td>${mods}</td>
32 | <td>${element.metadata['origin-server']}</td>
33 | <td>${originContext}</td>
34 | <td>${creation.toLocaleString()}</td>
35 | </tr>`;
36 |             $("#meetings-body").append(markup);
37 |         });
38 |         $("#text-last-refresh").html(new Date().toLocaleString());
39 |         spinner(false);
40 |     });
41 | }
42 | 
43 | function api_server() {
44 |         console.log("API request: /api/server");
45 |         $.get("./api/server", function(data) {
46 |             $("#text-server").html(data.server);
47 |             $("#text-version").html(data.version);
48 |         });
49 | }
50 | 
51 | 
52 | $(function() {
53 |     api_server();
54 |     api_meetings();
55 |     setInterval(api_meetings, 15 * 1000);
56 | });


--------------------------------------------------------------------------------
/bbb-mon/server.py:
--------------------------------------------------------------------------------
 1 | from flask import Flask, jsonify, send_from_directory
 2 | 
 3 | import settings
 4 | import views
 5 | 
 6 | app = Flask(__name__, static_url_path='')
 7 | 
 8 | 
 9 | @app.route('/')
10 | def root():
11 |     return send_from_directory('frontend', "index.html")
12 | 
13 | 
14 | @app.route('/frontend/<path:filename>')
15 | def frontend_static_files(filename):
16 |     return send_from_directory('frontend', filename)
17 | 
18 | 
19 | @app.route('/api/server')
20 | def api_server():
21 |     return jsonify(views.get_server())
22 | 
23 | 
24 | @app.route('/api/meetings')
25 | def api_meetings():
26 |     return jsonify(views.get_meetings())
27 | 
28 | 
29 | if __name__ == '__main__':
30 |     app.run(host="0.0.0.0")
31 | 


--------------------------------------------------------------------------------
/bbb-mon/settings.py:
--------------------------------------------------------------------------------
 1 | import os
 2 | import api_lib
 3 | 
 4 | MAJOR = 0
 5 | MINOR = 3
 6 | BUGFIX = 3
 7 | 
 8 | VERSION = "{}.{}.{}".format(MAJOR, MINOR, BUGFIX)
 9 | 
10 | API_BASE_URL = os.environ["API_BASE_URL"]
11 | # SSH into server and run: `$ bbb-conf --secret` to get secret
12 | API_SECRET = os.environ["API_SECRET"]
13 | 
14 | API_CLIENT = api_lib.Client(API_BASE_URL, API_SECRET)
15 | 
16 | debug_env = os.getenv("DEBUG", "false")
17 | DEBUG = True if debug_env.lower() == "true" else False
18 | 


--------------------------------------------------------------------------------
/bbb-mon/views.py:
--------------------------------------------------------------------------------
  1 | import logging
  2 | from collections import OrderedDict
  3 | from datetime import datetime
  4 | from urllib.parse import urlparse
  5 | 
  6 | import xmltodict
  7 | 
  8 | import api_lib
  9 | import settings
 10 | 
 11 | 
 12 | def get_meetings():
 13 |     data = api_lib.getMeetings(settings.API_CLIENT)
 14 | 
 15 |     if data is None:
 16 |         return []
 17 | 
 18 |     if data['response']['meetings'] is None:
 19 |         return []
 20 | 
 21 |     meetings = []
 22 |     try:
 23 |         if type(data['response']['meetings']['meeting']) == list:
 24 |             meetings = data['response']['meetings']['meeting']
 25 |         else:
 26 |             meetings.append(data['response']['meetings']['meeting'])
 27 |     except KeyError:
 28 |         logging.warning("Failed to parse meetings")
 29 |     except TypeError:
 30 |         return []
 31 | 
 32 |     response = []
 33 | 
 34 |     for meeting in meetings:
 35 |         if type(meeting) != OrderedDict:
 36 |             continue
 37 | 
 38 |         moderators = []
 39 | 
 40 |         if type(meeting['attendees']) == OrderedDict:
 41 |             if type(meeting['attendees']['attendee']) == list:
 42 |                 for attendee in meeting['attendees']['attendee']:
 43 |                     if attendee['role'].lower() == "moderator":
 44 |                         moderators.append(attendee['fullName'])
 45 | 
 46 |             else:
 47 |                 attendee = meeting['attendees']['attendee']
 48 |                 if attendee['role'].lower() == 'moderator':
 49 |                     moderators.append(attendee['fullName'])
 50 | 
 51 |         origin_server = None
 52 |         try:
 53 |             origin_server = meeting['metadata']['bbb-origin-server-name']
 54 |         except (KeyError, TypeError):
 55 |             logging.debug("BBB origin server name does not exist for meeting")
 56 |             logging.debug("Setting BBB origin as the server itself")
 57 |             origin_server = urlparse(settings.API_BASE_URL).netloc
 58 | 
 59 |         m = {
 60 |             "name": meeting['meetingName'],
 61 |             "id": meeting['meetingID'],
 62 |             "creation": meeting['createTime'],
 63 |             "noUsers": meeting['participantCount'],
 64 |             "moderators": moderators,
 65 |             "metadata": {
 66 |                 "origin-server": origin_server,
 67 |             }
 68 |         }
 69 | 
 70 |         # bbb-context is optional in bbb response
 71 |         try:
 72 |             m['metadata']['origin-context'] = _bbb_context_convert_moodle(meeting['metadata']['bbb-context'])
 73 |         except (KeyError, TypeError):
 74 |             pass
 75 | 
 76 |         response.append(m)
 77 | 
 78 |     return response
 79 | 
 80 | 
 81 | def _bbb_context_convert_moodle(context_html):
 82 |     """
 83 |         Returns the first inner node string from the context html string (useful for the context string returned
 84 |         by the BigBlueButton Moodle plugin.
 85 |     """
 86 | 
 87 |     context_html = "<root>{}</root>".format(context_html)  # removes the bug where there is no root node in context_html
 88 |     return_str = ""
 89 | 
 90 |     try:
 91 |         root = xmltodict.parse(context_html)
 92 | 
 93 |         if type(root['root']) == str:
 94 |             # No XML contents, just plain old string
 95 |             return root['root']
 96 | 
 97 |         for element in root['root']:
 98 |             el = root['root'][element]
 99 |             if type(el) == list and len(el) > 0:
100 |                 return_str = el[0]['#text']
101 |                 break
102 |     except Exception as e:
103 |         logging.error("Failed to parse BBB context string from Moodle, error: " + str(e))
104 | 
105 |     return return_str
106 | 
107 | 
108 | def get_server():
109 |     url_parsed = urlparse(settings.API_BASE_URL)
110 | 
111 |     return {
112 |         "service": "bigbluebutton-monitoring",
113 |         "server": url_parsed.netloc,
114 |         "api": settings.API_BASE_URL,
115 |         "version": settings.VERSION,
116 |         "datetime": datetime.now().isoformat(),
117 |         "source": "https://github.com/greenstatic/bigbluebutton-monitoring"}
118 | 


--------------------------------------------------------------------------------
/build-docker.sh:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env/bash
 2 | set -e
 3 | 
 4 | # Get current version
 5 | SCRIPT_PATH=$(dirname "$0")
 6 | DOCKERFILE_PATH=$SCRIPT_PATH
 7 | SETTINGS_PY=${SCRIPT_PATH}/bbb-mon/settings.py
 8 | 
 9 | VERSION_MAJOR=$(cat $SETTINGS_PY | grep "MAJOR\ *=\ *" | rev | cut -d " " -f 1 | cut -d "=" -f 1 | rev)
10 | VERSION_MINOR=$(cat $SETTINGS_PY | grep "MINOR\ *=\ *" | rev | cut -d " " -f 1 | cut -d "=" -f 1 | rev)
11 | VERSION_BUGFIX=$(cat $SETTINGS_PY | grep "BUGFIX\ *=\ *" | rev | cut -d " " -f 1 | cut -d "=" -f 1 | rev)
12 | 
13 | VERSION="${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_BUGFIX}"
14 | 
15 | # Build docker image
16 | cd ${DOCKERFILE_PATH}
17 | docker build -t greenstatic/bigbluebutton-monitoring:version-${VERSION} .


--------------------------------------------------------------------------------
/demo.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/greenstatic/bigbluebutton-monitoring/dd979741b15e3356ad888f3a259ad8f9a929b37a/demo.png


--------------------------------------------------------------------------------
/docker-compose.yaml:
--------------------------------------------------------------------------------
 1 | version: '3.2'
 2 | services:
 3 |   bbb-exporter:
 4 |     container_name: "bbb-monitoring"
 5 |     image: greenstatic/bigbluebutton-monitoring:${BBB_MONITORING_VERSION:-latest}
 6 |     ports:
 7 |     - "127.0.0.1:4000:5000"
 8 |     environment:
 9 |     - "API_BASE_URL=<TODO: YOUR API URL>"  # example: https://bbb.example.com/bigbluebutton/api/"
10 |     #- "DEBUG=true"
11 |     env_file:
12 |     # Within this file (secrets.env) which needs to be located in the same directory
13 |     # as docker-compose.yaml, you should have the following line
14 |     # API_SECRET=<TODO: YOUR API SECRET KEY>
15 |     - secrets.env
16 | 
17 |     restart: unless-stopped
18 | 


--------------------------------------------------------------------------------
/requirements.txt:
--------------------------------------------------------------------------------
 1 | certifi==2019.11.28
 2 | chardet==3.0.4
 3 | click==7.1.1
 4 | Flask==1.1.1
 5 | idna==2.9
 6 | itsdangerous==1.1.0
 7 | Jinja2==2.11.3
 8 | MarkupSafe==1.1.1
 9 | requests==2.23.0
10 | urllib3==1.25.8
11 | Werkzeug==1.0.0
12 | xmltodict==0.12.0
13 | 


--------------------------------------------------------------------------------