⚠️Xitogent v1 is not supported anymore, please login to your Xitoring dashboard and install Xitogent v2. more information can be found on documents
What is Xitoring
Innovations that makes your daily routine easier
Xitoring is an innovative monitoring platform (SaaS) for servers. We bring data from your server using our agent Xitogent to make sure your server is doing fine and avoid any downtime, performance issues, and increasing your customer’s satisfaction.
Our global probing nodes are always monitoring your servers and as soon as a hiccup is detected, we’ll notify the right contact. We’re continuously working to make our software better and providing incredible features in the future.
Introduced in 2021 to make a revolution in the Server Monitoring industry for whom those are tired of those traditional ways and looking forward to Automation
Monitoring for Free
Monitor 5 Servers for free, no limited time, no credit cards, You just need to register
What is Xitogent
Xitogent is a python-based and open-source application that is the core of Xitoring, Xitogent can collect data from your servers in an efficient way. it’s very lightweight, easy to install, and configurable. We are always developing Xitogent to improve and add features, At this time Xitogent has been tested on all major Linux Distros which are the most used OSes in the market.
The Xitogent runs as a service on your server and automatically send your server statistics continuously to your nearest Xitoring’s Server and we use the data to generate graphs or find out if something’s wrong on your server (e.g. we’ll automatically notify you if your CPU or memory usage is above normal).
The Agent runs on a recurring interval and sends statistics to the nearest probe node, we’ll use the data to make sure everything is fine on your server and then use it to make useful graphs (Server Load, CPU Usage, Memory Usage, Disk IO, and Disk Usage).
What data will Xitogent collect from your Servers?
We only collect data that is necessary for generating Server Graphs and Server Statistics including CPU Usage, Server Load, Memory Usage, Disk IO, Disk Usage, Top processes, Installed Common Softwares, and general details including Hostname and IP Addresses.
Which OSes are supported?
We support major Linux distributions and we’ll release the Windows Server’s Agent soon.
Xitogent is successfully tested on the following distributions but it’s proofed to work on most major distributions.
- Centos 6/7/8
- Fedora 27/30/31/32
- Redhat 8
- Ubuntu 14.04/15.04/16.04/18.04/19.04/20.04
- Debian 5/6/7/8/9/10
- OpenSuse 15.1
- Rocky Linux 8.4
- CloudLinux 8.4
- AlmaLinux 8.4
Xitogent can be installed using our Installer Script, it will automatically download and set up the environment for Xitogent to work, but the main difference between the automatic installation and manual installation is that when you Install Xitogent with our installer script you will get the binary version set up on your system, but say you want to use the non-binary version, in case of that you need to manually set up everything yourself step by step.
As we said before, Xitogent is a Python-Based tool so if you want to use the non-binary version you need to have Python installed first. As of version 1.0.0, Xitogent will require python 3.6 and higher.
On CentOS 7 and later
yum install python3 python3-pip
On Ubuntu 20.04
apt install python3 python3-pip
Install Python libraries
There are 3 main Python dependencies that Xitogent needs to run, requests, psutil, and localStoragePy. you can easily install them using pip.
pip install requests pip install psutil pip install localStoragePy
Creating config file
By default, Xitogent uses
/etc/xitogent/xitogent.conf as the config file so you need to create the directory and the config file within it.
mkdir /etc/xitogent touch /etc/xitogent/xitogent.conf
But you can place the config file somewhere else and point Xitogent to it using
-c flag for more information check the Xitogent help list.
python xitogent.py -c /path/to/config start
Register your Server
After setting up everything for Xitogent on your Server, now it's for Xitogent to set up your server for monitoring. for registering your server to the Xitoring App some of the arguments are necessary required:
register This argument is used only for the first time and will register/add your server to your Xitoring panel.
--key You can find your key from the Xitoring panel > Servers > Add Server modal.
--auto_update=false Make sure to disable auto-update because auto-update is not possible when you are using the non-binary version.
Find the Key
In Xitoring App go to the Account page from the sidebar panel, On the right side of that page you can see the API Access section there is a default API key generated for your account which is the one that is used in the default add server command in Servers page, you either can use that API key or you can create a new one and specify a expire date for it. using each one of those options is your choice.
Below is an example of a complete register command where 4 modules, auto triggers, auto discovery are enabled and auto update is disabled:
python xitogent.py register --key=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx --module_ftp=ture --module_dns=true --module_http=true --module_ping=true --auto_discovery=true --auto_trigger=true --auto_update=false
You can learn more about Xitogent arguments and params using
After registering your Server to your panel, you need to start the Xitogent process to gather and send data, for starting Xitogent from the command line you can easily execute:
python xitogent.py start
You can easily stop the Xitogent process using:
python xitogent.py stop
python xitogent.py pause argument will stop Xitogent from collecting and sending data for monitoring, you can use it for multiple purposes like maintenance, network configuration changes, etc. the most important feature of Xitogent pause is that you can determine how much time you need it to stay pause and after that xitogent will automatically start collecting and sending data. for example:
the following example will pause Xitogent for 2 hours.
python xitogent.py pause 2h
Obviously, you can unpause Xitogent with:
python xitogent.py unpause
You can get a brief report of Xitogent with
python xitogent.py status command it will output a report like below:
Status running Uptime 07:45:36 Sent sequences 4689 Failed sequences 0
Creating Service for Xitogent
You can manage the Xitogent process with service managers like systemd and SysV or just run it as a daemon background process, you need to create a service file based on the service manager that your OS uses.
The default path for systemd services is:
You can create a service file for Xitogent using:
Here is an example of a Xitogent systemd service file content:
[Unit] Description=Xitogent Service After=network.target [Service] Type=forking PIDFile=/var/run/xitogent.pid ExecStart=/usr/bin/python /etc/xitogent/xitogent.py start -d -c /etc/xitogent/xitogent.conf ExecStop=/usr/bin/python /etc/xitogent/xitogent.py stop Restart=on-failure RestartSec=10s [Install] WantedBy=multi-user.target
After creating a service file you need to run the following command to take effect.
For older Linux distros like CentOS 6 there is no systemd so you have to stick with the old SysV service manager. you can use the example service file included in the project files called
Make sure that you place the service file in the correct path which is:
No service manager
If your OS doesn't have a service manager or you don't want to use it forever reason, you can run Xitogent with the
-d flag to run in in background:
python xitogent.py start -d
After all these steps depend on your OS your Server will be added to the Xitoring panel and you can monitor all of your resources and services easily If you have further questions about anything you can always contact our support team through support [at] xitoring .com or read more on Document.