Skip to main content
Help improve PyPI by participating in a 5-minute user interface survey!

Simple Django applicattion that provides an alternative to the Zabbix screens.

Project Description

.. image:: https://pypip.in/download/zbx-dashboard/badge.svg
:target: https://pypi.python.org/pypi/zbx-dashboard/
:alt: Downloads
.. image:: https://pypip.in/version/zbx-dashboard/badge.svg
:target: https://pypi.python.org/pypi/zbx-dashboard/
:alt: Latest Version
.. image:: https://travis-ci.org/banzayats/zbx-dashboard.svg?branch=master
:target: https://travis-ci.org/banzayats/zbx-dashboard
:alt: Travis CI

===============================================
zbx_dashboard
===============================================
`zbx_dashboard` is a simple Django applicattion that provides an alternative to the Zabbix screens.
It allows users who are not registered in Zabbix being able to view the graphs and (in the future) more data from Zabbix.

Prerequisites
===============================================
- Django 1.5.*, 1.6.*, 1.7.*
- Python 2.6.8+, 2.7.*

Main features
===============================================
- Group graphs in separate dashboards
- Rearrange graphs on the dashboard
- Each dashboard and the graph can be provided a brief description
- Dashboards may belong to different groups of users

Installation
===============================================
1. Install latest stable version from PyPI:

.. code-block:: none

$ pip install zbx-dashboard

Or latest stable version from GitHub:

.. code-block:: none

$ pip install -e git+https://github.com/banzayats/zbx-dashboard@stable#egg=zbx-dashboard

2. Edit your projects' Django settings:

.. code-block:: python

INSTALLED_APPS = (
'admin_tools',
'admin_tools.theming',
'admin_tools.menu',
'admin_tools.dashboard',
'tinymce',
'widget_tweaks',
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'zbx_dashboard',
)

STATIC_ROOT = os.path.join(BASE_DIR, 'static')

TEMPLATE_CONTEXT_PROCESSORS = (
'django.contrib.auth.context_processors.auth',
'django.core.context_processors.debug',
'django.core.context_processors.i18n',
'django.core.context_processors.request',
'django.core.context_processors.static',
'django.contrib.messages.context_processors.messages',
)

LOGIN_REDIRECT_URL = '/boards'

# Set up your Zabbix server credentials
ZABBIX_URL = 'https://zabbix.org/zabbix/'
ZABBIX_USER = 'guest'
ZABBIX_PASS = ''

# TinyMCE
TINYMCE_DEFAULT_CONFIG = {
'mode': 'exact',
'theme': "advanced",
'relative_urls': False,
'width': 400,
'height': 200,
'plugins': 'inlinepopups,preview,media,contextmenu,paste,fullscreen,noneditable,visualchars,nonbreaking,xhtmlxtras',
'theme_advanced_buttons1': 'fullscreen,|,bold,italic,underline,strikethrough,|,sub,sup,|,bullist,numlist,|,outdent,indent,|,formatselect,removeformat,|,preview,code',
'theme_simple_toolbar_location': 'top',
'theme_advanced_toolbar_align': 'left',
}

LOCALE_PATHS = (
os.path.join(BASE_DIR, 'locale'),
)

3. Add to urls.py:

.. code-block:: python

from django.contrib.auth.views import login, logout

urlpatterns = patterns('',
# ...
url(r'^admin_tools/', include('admin_tools.urls')),
url(r'^boards/', include('zbx_dashboard.urls', namespace="boards")),
url(r'^accounts/login/$', login, name='login'),
url(r'^accounts/logout/$', logout, name='logout'),
url(r'^tinymce/', include('tinymce.urls')),
)

4. Run:

.. code-block:: none

$ python manage.py syncdb

This creates a few tables in your database that are necessary for operation.

5. Make ``static`` directory in your projects' root directory and run:

.. code-block:: none

$ python manage.py collectstatic

6. Test the application. Run the development server:

.. code-block:: none

$ python manage.py runserver 0.0.0.0:5000

Demo
===============================================
Demo site: http://boyard.pp.ua

login: admin, password: admin

Release history Release notifications

This version
History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
zbx-dashboard-0.1.2.tar.gz (417.8 kB) Copy SHA256 hash SHA256 Source None Nov 14, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page