Objective
With Real Time Monitoring (RTM), you can partially monitor your server and its activity regarding CPU, RAM, disk partitions, etc. To display this information directly in your OVHcloud Control Panel, it’s necessary to install the RTM package on your server first.
This guide explains how to install RTM on Linux.
Requirements
- access to the OVHcloud Control Panel
- root access via SSH (or via graphical user interface) on your server
Instructions
Some firewall restrictions may prevent your infrastructure from being monitored, even if you have added RTM. Please remember to authorise server access for the OVHcloud monitoring IP addresses. You can find the details this guide.
RTM on Linux
Components
With dedicated servers, RTM gathers real-time information on the CPU, RAM, disks, RAID and hardware. Below, you can find some details regarding the components used.
Beamium
https://github.com/ovh/beamium
Beamium collects HTTP terminal metrics, such as http://127.0.0.1:9100/metrics
, and supports the Prometheus Sensision formats.
Once it has been implemented, Beamium can filter and transfer data to a Warp 10™ Time Series platform. When metrics are collected, it uses DFO (Disk Failover) to avoid any potential loss linked to network issues or unavailable services.
Beamium is written in Rust to guarantee efficiency, a low footprint, and high performance.
Configuration example:
# noderig endpoint to fetch
scrapers:
noderig:
url: http://127.0.0.1:9100/metrics
format: sensision
period: 60000
# Warp10 platform to send data
sinks:
metrics:
url: https://rtm.ovh.net/
token: 526873a6b912637ee4c44b525413
Size : 1000000
selector: (os|rtm).*
ttl: 60
labels:
host: hostname
host_type: you can add tag for server and retrieve it in grafana host list
parameters:
source-dir: /opt/beamium/sources
sink-dir: /opt/beamium/sinks
log-level: 1
scan-period: 60000
log-file: /var/log/beamium/beamium.log
The configuration file will be filled in automatically once the installation is complete.
Noderig
https://github.com/ovh/noderig
Noderig collects an operating system’s metrics, and exposes them via an HTTP URL (http://127.0.0.1:9100/metrics
). Each collector can be easily configured using a basic level cursor.
Noderig metrics:
- CPU
- Memory
- Load
- Disk
- Net
- External collectors
Configuration example:
cpu: 1
mem: 1
load: 2
disk: 2
net: 2
net-opts:
interfaces:
- eth0
- eth1
period: 60000
collectors: /opt/noderig
RTM Binaries
rtmHardware:
- Collects information on the hardware, such as the motherboard, PCI devices, disk health, etc. Also collects information on the software, such as the kernel and BIOS version.
rtmHourly:
- Collects information on the top processes, open ports, and the number of ongoing processes.
rtmRaidCheck:
- Verifies the health of the RAID (if available).
Installing RTM automatically
Once you have connected to your server via SSH, run the following command:
# wget -qO - https://last-public-ovh-infra-yak.snap.mirrors.ovh.net/yak/archives/apply.sh | OVH_PUPPET_MANIFEST=distribyak/catalog/master/puppet/manifests/common/rtmv2.pp bash
This automatic installation may not work on your distribution (depending on certain dependencies). If it produces an error, please proceed with the manual installation, following the instructions outlined in the sections below.
Installing RTM manually
Manual installation on Debian/Ubuntu
Step 1: Adding OVHcloud repositories
- by using add-apt-repository
#metrics repo
# add-apt-repository "deb http://last.public.ovh.metrics.snap.mirrors.ovh.net/$(lsb_release --id --short | tr 'A-Z' 'a-z') $(lsb_release --codename --short) main"
# rtm repo
# add-apt-repository "deb http://last.public.ovh.rtm.snap.mirrors.ovh.net/$(lsb_release --id --short | tr 'A-Z' 'a-z') $(lsb_release --codename --short) main"
- by adding them manually
For Debian:
<distribution codename>
is the name of your distribution (for example: “buster”).
# nano /etc/apt/sources.list.d/rtm.list
#metrics repo
deb http://last.public.ovh.metrics.snap.mirrors.ovh.net/debian <distribution codename> main
# rtm repo
deb http://last.public.ovh.rtm.snap.mirrors.ovh.net/debian <distribution codename> main
For Ubuntu:
<distribution codename>
is the name of your distribution (for example: “bionic”).
# nano /etc/apt/sources.list.d/rtm.list
Add these lines and save the file:
# metrics repo
deb http://last.public.ovh.metrics.snap.mirrors.ovh.net/ubuntu <distribution codename> main
# rtm repo
deb http://last.public.ovh.rtm.snap.mirrors.ovh.net/ubuntu <distribution codename> main
Concerning current distributions, please note that the necessary packages might not be included yet in the repositories of up-to-date Linux OS versions. In that case, please use the codename of an older (Ubuntu) version as a workaround.
Step 2: Installing the apt key
# curl https://last-public-ovh-rtm.snap.mirrors.ovh.net/ovh_rtm.pub | apt-key add -
# curl http://last.public.ovh.metrics.snap.mirrors.ovh.net/pub.key | apt-key add -
Step 3: Installing the RTM packages
# apt-get update
# apt-get install ovh-rtm-metrics-toolkit
Manual installation on CentOS
Add the RTM and the metrics repository for CentOS:
# nano /etc/yum.repos.d/ovh-rtm.repo
Add these lines and save the file:
[rtm]
name=OVH RTM RHEL/ CentOS $releasever - $basearch
baseurl=http://last.public.ovh.rtm.snap.mirrors.ovh.net/centos/$releasever/$basearch/Packages/
enabled=1
repo_gpgcheck=1
gpgcheck=0
gpgkey=http://last.public.ovh.rtm.snap.mirrors.ovh.net/ovh_rtm.pub
[metrics]
name=OVH METRICS RHEL/ CentOS $releasever - $basearch
baseurl=http://last.public.ovh.metrics.snap.mirrors.ovh.net/centos/$releasever/$basearch/Packages/
enabled=1
repo_gpgcheck=1
gpgcheck=0
gpgkey=http://last.public.ovh.metrics.snap.mirrors.ovh.net/pub.key
Install the RTM packages:
# yum update
# yum install ovh-rtm-metrics-toolkit
Manual installation on FreeBSD
Add the RTM and the metrics repository for FreeBSD:
# mkdir -p /usr/local/etc/pkg/repos
# nano /usr/local/etc/pkg/repos/OVH.conf
Add these lines and save the file:
# OVH mirror
RTM: {
url: "http://last.public.ovh.rtm.snap.mirrors.ovh.net/FreeBSD-pkg/${ABI}/latest",
mirror_type: "none",
enabled: yes
}
Metrics: {
url: "http://last-public-ovh-metrics.snap.mirrors.ovh.net/FreeBSD-pkg/${ABI}/latest",
mirror_type: "none",
enabled: yes
}
Install the RTM packages:
# pkg install -y noderig beamium ovh-rtm-binaries
# pkg install -y ovh-rtm-metrics-toolkit
Start the services:
# service noderig start
# service beamium start
The RTM package is currently not compatible with Windows systems. We are continuously developing and improving our services; eventually there will be a Windows option as well.
RTM in the OVHcloud Control Panel
Once you have successfully installed RTM, you can view the monitoring data for your server in the the OVHcloud Control Panel. (It might be necessary to refresh your browser or to log out and log in again). Navigate to the Bare Metal Cloud
section and select your server from the left-hand menu. On the General information
tab, scroll down to find the monitoring information.
Comments
0 comments
Please sign in to leave a comment.