Host utilities package for django projects. Bootstrap 5 templates are provided. Host metric data includes:
- Host OS, release, uptime
- CPU count and utilization
- Memory usage
- Disk partations and utilization
- Processes running, idle, sleeping
- Network interfaces and connections
Author | David Slusser |
Description | Host utilities package for django projects. |
Requirements |
Python 3.x +Django 3.2.x + |
Workflow | Description | Status |
---|---|---|
Bandit | security checks | |
Black | code formatting | |
Mypy | static type checking | |
Pylint | static code analysis | |
Pytest | unit testing |
Workflow | Description | Status |
---|---|---|
Docs | ReadTheDocs Build |
Full documentation is available here:
https://django-hostutils.readthedocs.io/en/latest/index.html
django-hostutils is licensed under the GNU-3 license (see the LICENSE file for details).
https://github.com/davidslusser/django-hostutils/blob/docs/LICENSE
-
pip install django-hostutils
-
add the following to your INSTALLED_APPS
djangoaddicts.hostutils
-
add the following to your project-level urls.py:
path("hostutils/", include("djangoaddicts.hostutils.urls"), ),
Several pages are available. If you have a Bootstrap 5 nav-menu you can add the following snippet in your navbar where appropriate:
{% include 'hostutils/bs5/snippets/hostutils_nav_menu.htm' %}
Individual pages can also be linked directly:
-
Host overview page:
{% url 'hostutils:host_details' %}
-
CPU stats page:
{% url 'hostutils:host_cpu' %}
-
Disk stats page:
{% url 'hostutils:host_disk' %}
-
Memory stats page:
{% url 'hostutils:host_memory' %}
-
Network stats page:
{% url 'hostutils:host_network' %}
-
Process stats page:
{% url 'hostutils:host_process' %}