---
title: "Telemetry Service"
slug: "telemetry-service"
updated: 2025-05-06T12:23:54Z
published: 2025-05-06T12:23:54Z
canonical: "docs.fmad.io/telemetry-service"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fmad.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Telemetry Service

FMADIO offers a remote telemetry service, where syslog traffic is sent to FMADIO monitoring infrastructure over a secure SSH tunnel. This allow FMADIO staff to monitor the system and get ahead of any issues the system may have.

To configure the service follow these steps

---

## Configuration

### Step 1) Generate unique SSH key

FMADIO devices by default have a pre-installed ssh key. To correctly secure and uniquely identify the system generate your own SSH key as follows.

```plaintext
ssh-keygen -t rsa -b 3072
```

Using a password less key ensures the automatic setup requires no manual intervention.

Example output per below

```plaintext
fmadio@fmadio100p3-539:~$ ssh-keygen -t rsa -b 3072
Generating public/private rsa key pair.
Enter file in which to save the key (/home/fmadio/.ssh/id_rsa):
/home/fmadio/.ssh/id_rsa already exists.
Overwrite (y/n)? y
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/fmadio/.ssh/id_rsa
Your public key has been saved in /home/fmadio/.ssh/id_rsa.pub
The key fingerprint is:
SHA256:G/***************************** fmadio@fmadio100p3-539
The key's randomart image is:
+---[RSA 3072]----+
|  Eo.oo=Bo  .    |
|  o .o.. o.. +   |
| . ..+  +.o o o  |
|. .   =..+   . ..|
| .     +S o     o|
|    .  ..+ o   . |
|   ..+.oo.  o .  |
|  o. o= =  o   . |
|   oo..o .  .oo  |
+----[SHA256]-----+
fmadio@fmadio100p3-539:~$
```

Send the public key (below) to [support@fmad.io](mailto:support@fmad.io)

```plaintext
/opt/fmadio/etc/fmadio_id_rsa.pub
```

### Step 2) Copy to persistent Storage

The SSH public/private keys are on the volatile file system. Copy the keys to the persistent storage.

```plaintext
cp .ssh/id_rsa /opt/fmadio/etc/fmadio_id_rsa
```

```plaintext
cp .ssh/id_rsa.pub /opt/fmadio/etc/fmadio_id_rsa.pub
```

NOTE: the key is renamed with an fmadio_* prefix. The system copies the keys from this location and renames them in the .ssh/id_rsa .ssh/id_[rsa.pub](http://rsa.pub) directory during the boot process.

### Step 3) Copy the reference boot script

There is a reference boot script located in

```plaintext
/opt/fmadio/etc_ro/boot.lua.telemetry_mon2
```

Copy this to to the /opt/fmadio/etc/boot.lua file to automatically establish ssh tunnel to the telemetry service.

```plaintext
cp /opt/fmadio/etc_ro/boot.lua.telemetry_mon2  /opt/fmadio/etc/boot.lua
```

After copying replace the "username" to the username provided by fmadio support and save the file.

![](https://cdn.document360.io/b9aab0c4-36d0-4616-9673-30b661455571/Images/Documentation/image(228).png?sv=2026-02-06&spr=https&st=2026-11-13T19%3A32%3A35Z&se=2026-11-13T20%3A32%3A35Z&sr=c&sp=r&sig=fWqDMIJBTjdTxg4TNzm3sRrdgYL8nFQ6PsqnGl8%2BNpM%3D)

### Step 4) Copy the reference rsyslog config

In addition to ssh tunnel setup, rsyslog configuration to forward syslog messages to the SSH tunnel.

Copy the reference config to /opt/fmadio/etc/ directory as follows.

```plaintext
cp /opt/fmadio/etc_ro/syslogd.conf.tunnel /opt/fmadio/etc/syslogd.conf
```

No modifications are required.

### Step 5) Reboot the system

Reboot the system to check all the above steps are executed correctly

### Step 6) Validate

After rebooting log into the Grafana monitoring site with the assigned username and confirm data is being recevied.

Any problems please contact [support@fmad.io](mailto:support@fmad.io)

---

## Debugging

Logfiles can usually be found in the syslog. There are usually some kind of error or warning messages on what the issue is

```plaintext
/mnt/store0/log/messages
```

###