Getting started

​Speculare Client is the collector daemon that run on your VMs/servers/... It run constantly on any servers you want to monitor and send the data collected (cpu, ram, disk/net io, ...) to Speculare Server.
Setup
As of now Speculare Client does not provide easy setup solution such as a one-line installer (but it's planned). The current recommanded way to install Speculare Client is to build it from source. But don't be afraid, it's easy and straightforwards.
You can also build it once for your platform (ie: Linux-x86) and then send the binary to each of your servers.
Install dependencies
Speculare Client is a Rust project that rely on very few dependencies. But some of them are still required for https communication.
1
# Install Rust
2
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
3
​
4
# Install APT dependencies
5
sudo apt-get install libssl-dev pkg-config build-essential
Copied!
Build the binary
You can build the binary using:
1
cargo build --release
Copied!
The resulting binary will be located in ./target/release/speculare-client.
Configuration files
The client binary depends on a Config.toml file whose path will be passed as arguments to the binary. 
You can create your Config.toml from the Config.example.toml given in the source code.
1
speculare-client "/path/to/Config.toml"
Copied!
Install as a service
Here is a sample speculare-client.service for systemd:
1
[Unit]
2
Description=Speculare Client Process
3
After=network.target
4
StartLimitIntervalSec=600
5
StartLimitBurst=10
6
​
7
[Service]
8
Restart=on-failure
9
RestartSec=60s
10
Group=www-data
11
ExecStart=/root/speculare-client "/path/to/Config.toml"
12
​
13
[Install]
14
WantedBy=multi-user.target
Copied!

Speculare Alerts - Previous

Getting started

Next - Speculare PGCDC

Getting started

Last modified 6mo ago

Copy link

Contents

Setup