# Agent
Server Monitoring (sleuren.com) is a web service that monitors and displays statistics of your server performance.
Agent is OS agnostic software compatible with Python 2.7, 3.5, and 3.6. It's been optimized to have low CPU consumption and comes with an extendable set of useful plugins.
[](https://github.com/sleuren/agent/actions/workflows/test-and-deploy.yml)
## Documentation
You can find the full documentation at [docs.sleuren.com](https://sleuren.com/docs).
## Automatic Installation (All Linux Distributions)
You can install the default configuration of Sleuren on all Linux distributions with just one click.
1. Connect to your server via SSH.
2. Find your `TOKEN`. To do so, [go to the project installation page](https://sleuren.com/dashboard).
3. Run the following command:
```sh
wget -q -N https://sleuren.com/sleuren.sh && bash sleuren.sh TOKEN
```
## Manual Installation
To customize installation options, install sleuren agent manually.
1. Connect to your server via SSH.
2. Run the following command, which differs depending on your server platform:
- Debian GNU/Linux:
```sh
apt-get install python3-devel python3-setuptools python3-pip
pip3 install sleuren
wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini
```
- Fedora/CentOS version 6 or earlier (python 2.7):
```sh
yum install python-devel python-setuptools gcc
easy_install sleuren netifaces psutil
wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini
```
- Fedora/CentOS version 7 and later (python 3):
```sh
yum install python36-devel python36 gcc
pip3 install sleuren
wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini
```
3. Find your `TOKEN`. To do so, [go to the project installation page](https://sleuren.com/dashboard).
4. Run the following command (TOKEN is the one you got during the previous step):
```sh
sleuren hello TOKEN /etc/sleuren-token.ini
```
5. Create a systemd service at `/etc/systemd/system/sleuren.service` by adding the following:
```ini
[Unit]
Description=Sleuren agent
[Service]
ExecStart=/usr/local/bin/sleuren
User=sleuren
[Install]
WantedBy=multi-user.target
```
6. Run the following command:
```sh
chmod 644 /etc/systemd/system/sleuren.service
systemctl daemon-reload
systemctl enable sleuren
systemctl start sleuren
```
Raw data
{
"_id": null,
"home_page": "https://github.com/sleuren/agent",
"name": "sleuren",
"maintainer": "sleuren",
"docs_url": null,
"requires_python": "",
"maintainer_email": "hello@sleuren.com",
"keywords": "sleuren monitoring agent",
"author": "sleuren",
"author_email": "hello@sleuren.com",
"download_url": "https://files.pythonhosted.org/packages/26/3a/da787d4ae63e3155a8ddfde619d87367a695d40d4fb009643da315d9e981/sleuren-1.0.8.tar.gz",
"platform": null,
"description": "# Agent\n\nServer Monitoring (sleuren.com) is a web service that monitors and displays statistics of your server performance.\n\nAgent is OS agnostic software compatible with Python 2.7, 3.5, and 3.6. It's been optimized to have low CPU consumption and comes with an extendable set of useful plugins.\n\n[](https://github.com/sleuren/agent/actions/workflows/test-and-deploy.yml)\n\n## Documentation\n\nYou can find the full documentation at [docs.sleuren.com](https://sleuren.com/docs).\n\n## Automatic Installation (All Linux Distributions)\n\nYou can install the default configuration of Sleuren on all Linux distributions with just one click.\n\n1. Connect to your server via SSH.\n\n2. Find your `TOKEN`. To do so, [go to the project installation page](https://sleuren.com/dashboard).\n\n3. Run the following command:\n\n ```sh\n wget -q -N https://sleuren.com/sleuren.sh && bash sleuren.sh TOKEN\n ```\n\n## Manual Installation\n\nTo customize installation options, install sleuren agent manually.\n\n1. Connect to your server via SSH.\n2. Run the following command, which differs depending on your server platform:\n\n - Debian GNU/Linux:\n\n ```sh\n apt-get install python3-devel python3-setuptools python3-pip\n pip3 install sleuren\n wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini\n ```\n\n - Fedora/CentOS version 6 or earlier (python 2.7):\n\n ```sh\n yum install python-devel python-setuptools gcc\n easy_install sleuren netifaces psutil\n wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini\n ```\n\n - Fedora/CentOS version 7 and later (python 3):\n\n ```sh\n yum install python36-devel python36 gcc\n pip3 install sleuren\n wget -O /etc/sleuren.ini https://sleuren.com/scripts/sleuren.ini\n ```\n\n3. Find your `TOKEN`. To do so, [go to the project installation page](https://sleuren.com/dashboard).\n\n4. Run the following command (TOKEN is the one you got during the previous step):\n\n ```sh\n sleuren hello TOKEN /etc/sleuren-token.ini\n ```\n\n5. Create a systemd service at `/etc/systemd/system/sleuren.service` by adding the following:\n\n ```ini\n [Unit]\n Description=Sleuren agent\n [Service]\n ExecStart=/usr/local/bin/sleuren\n User=sleuren\n [Install]\n WantedBy=multi-user.target\n ```\n\n6. Run the following command:\n\n ```sh\n chmod 644 /etc/systemd/system/sleuren.service\n systemctl daemon-reload\n systemctl enable sleuren\n systemctl start sleuren\n ```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Server monitoring agent",
"version": "1.0.8",
"project_urls": {
"Homepage": "https://github.com/sleuren/agent"
},
"split_keywords": [
"sleuren",
"monitoring",
"agent"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "31c72752747b995195003634d5ff707296c4e18ccc74333bcdb980abafe6e521",
"md5": "aaf784904d5ddd99ba1dc8cf47c4f280",
"sha256": "0975d73b72b26c354e39b9c51dc441b4166d2a153cba10fdb1f32bda1c8510de"
},
"downloads": -1,
"filename": "sleuren-1.0.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aaf784904d5ddd99ba1dc8cf47c4f280",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 62254,
"upload_time": "2023-05-25T11:45:52",
"upload_time_iso_8601": "2023-05-25T11:45:52.572220Z",
"url": "https://files.pythonhosted.org/packages/31/c7/2752747b995195003634d5ff707296c4e18ccc74333bcdb980abafe6e521/sleuren-1.0.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "263ada787d4ae63e3155a8ddfde619d87367a695d40d4fb009643da315d9e981",
"md5": "e98d49f1487541734ecee04f790018a6",
"sha256": "674f897622e32cec3a2982a03003274adaecc433fd79b887bf049b90d52c5235"
},
"downloads": -1,
"filename": "sleuren-1.0.8.tar.gz",
"has_sig": false,
"md5_digest": "e98d49f1487541734ecee04f790018a6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 39430,
"upload_time": "2023-05-25T11:45:54",
"upload_time_iso_8601": "2023-05-25T11:45:54.412930Z",
"url": "https://files.pythonhosted.org/packages/26/3a/da787d4ae63e3155a8ddfde619d87367a695d40d4fb009643da315d9e981/sleuren-1.0.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-25 11:45:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sleuren",
"github_project": "agent",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "sleuren"
}
JSON
