SysDB - Documentation

The SysDB documentation consists of manpages covering each tool and all plugins shipped with the core distribution, the SysDB query language and some generic overview documents. All manual pages are written using the AsciiDoc document format and shipped as part of the core distribution.

Documentation is a critical part of all software. As such, we take good and complete documentation very seriously. Also, it is a great way for everybody to contribute to Open Source projects. Any contribution in that area is highly appreciated and very encouraged. Also, this website is managed in Git as well and available from Github. Feel free to propose changes by opening an issue or sending a pull request.

Manpages

The top-level manpages provide an overview of how SysDB works and how to use the server and client tools.

sysdb(7): SysDB overview
sysdb(1): interactive client tool
sysdbd(1): data collection and database server
sysdbd.conf(5): sysdbd configuration
sysdbql(7): SysDB query language (SysQL)

Backend Manpages

Backend plugins are the working horses of SysDB and responsible for collecting the information stored in the database. They provide means to connect to the backend systems, query relevant information, and submit them to the central store. Plugins may be loaded dynamically into the SysDB daemon.

Store Manpages

The central part of SysDB's database is the object store which stores all objects (hosts, services) known to SysDB. The implementation is provided by a "store" plugin and may be backed by arbitrary data-stores. At least one store plugin has to be loaded to let the daemon do its work.

Time-series Fetcher Manpages

Time-series fetcher plugins provide generic means to retrieve time-series data from a backend's data-store. All plugins providing metrics information may also provide the necessary details about how to access the respective data-store. This may require additional configuration for the backend plugins. See their respective documentation for details.