SC Metrics Agent

The SC Metrics Agent is a lightweight, open-source utility that collects system-level metrics from your computes and forwards them to Strettch Cloud. It enables monitoring features including usage graphs, resource tracking, and performance analytics. Supported Systems: Ubuntu 20.04+, Debian 8+ View the source code on GitHub

Automatic Installation

The SC Metrics Agent installs automatically when you create a new compute instance. No action needed—just wait a few minutes after creation, then view your metrics from the dashboard’s Graphs tab.

Manual Installation

Need to install the agent on an existing instance? Here’s how:

Quick Install (Recommended)

Run this single command to install the agent:

curl -sSL https://repo.cloud.strettch.com/metrics/install.sh | sudo bash

The script will automatically detect your OS, set up repositories, and install the agent:

--- Installing sc-metrics-agent for noble ---
-> Cleaning up old repository configurations...
   -> Updating package lists
   -> Installing prerequisites
   -> Downloading GPG key
   -> Adding repository
   -> Updating package index
   -> Installing sc-metrics-agent
...
Setting up sc-metrics-agent (3.17.1) ...
Configuring SC-Metrics-Agent...
ℹ️  Creating required directories...
ℹ️  Configuring metrics collection...
✅ Metrics agent configured successfully
ℹ️  Enabling sc-metrics-agent.service...
✅ sc-metrics-agent.service enabled
ℹ️  Starting services...
✅ sc-metrics-agent.service started successfully

╔═════════════════════════════════════════╗
║ SC-Metrics-Agent Installation Complete  ║
╚═════════════════════════════════════════╝

Service Status:
  • Main Service: active
  • Auto-Update:  active

✅ sc-metrics-agent installed successfully!

Review Before Installing

Prefer to inspect the script first? Download and review it:

curl -sSL https://repo.cloud.strettch.com/metrics/install.sh

Verify Installation

Check that the agent is running:

systemctl status sc-metrics-agent

You should see Active: active (running):

● sc-metrics-agent.service - Strettch Cloud Metrics Agent
     Loaded: loaded (/etc/systemd/system/sc-metrics-agent.service; enabled; preset: enabled)
     Active: active (running) since Tue 2025-10-14 10:15:30 UTC; 45s ago
       Docs: https://docs.cloud.strettch.com/agents/sc-metrics-agent
   Main PID: 578620 (sc-metrics-agen)
      Tasks: 6 (limit: 9435)
     Memory: 2.1M (peak: 2.5M)
        CPU: 38ms
     CGroup: /system.slice/sc-metrics-agent.service
             └─578620 /usr/bin/sc-metrics-agent

View your metrics from the dashboard’s Graphs tab within a few minutes. To check the installed agent version:

dpkg -l | grep sc-metrics-agent

Managing the Agent

Basic Commands

sudo systemctl start sc-metrics-agent

sudo systemctl stop sc-metrics-agent

sudo systemctl restart sc-metrics-agent

systemctl status sc-metrics-agent

Auto-Start on Boot

sudo systemctl enable sc-metrics-agent

sudo systemctl disable sc-metrics-agent

Viewing Logs

sudo journalctl -u sc-metrics-agent -f

sudo journalctl -u sc-metrics-agent --since=1h

sudo journalctl -u sc-metrics-agent -n 100

Updates

The agent updates automatically. You can also trigger updates manually:

sudo systemctl start sc-metrics-agent-updater

sudo journalctl -u sc-metrics-agent-updater -f

Uninstalling

To completely remove the agent:

sudo apt-get purge sc-metrics-agent

The uninstall process will stop all services and remove the agent:

Reading package lists... Done
Building dependency tree... Done
The following packages will be REMOVED:
  sc-metrics-agent*
After this operation, 6,823 kB disk space will be freed.
Do you want to continue? [Y/n] Y
...
Removing sc-metrics-agent (3.17.1) ...
Removing SC-Metrics-Agent (keeping configuration)...
Stopping sc-metrics-agent-update-scheduler.timer...
Stopping sc-metrics-agent.service...
Disabling sc-metrics-agent-update-scheduler.timer...
Disabling sc-metrics-agent.service...
SC-Metrics-Agent removed (configuration preserved in /etc/sc-metrics-agent)
Purging configuration files for sc-metrics-agent (3.17.1) ...

Note: After uninstalling, metrics collection and usage graphs will be unavailable.

Troubleshooting

Metrics Not Showing?

Verify the agent is running:
systemctl status sc-metrics-agent

Check recent logs:

sudo journalctl -u sc-metrics-agent -n 50

Restart the service:

sudo systemctl restart sc-metrics-agent

Wait a few minutes for metrics to appear in the dashboard

Need Help?

Contact support at cloud@strettch.com with:

Output from systemctl status sc-metrics-agent
Recent logs: journalctl -u sc-metrics-agent -n 100
Your compute instance ID
Description of the issue

Security

The agent uses encrypted communication to securely transmit metrics data to Strettch Cloud. It runs with minimal privileges and updates automatically for security patches.

SC Compute

DNS

Teams

Agents

Automatic Installation

Manual Installation

Quick Install (Recommended)

Review Before Installing

Verify Installation

Managing the Agent

Basic Commands

Auto-Start on Boot

Viewing Logs

Updates

Uninstalling

Troubleshooting

Metrics Not Showing?

Need Help?

Security

​Automatic Installation

​Manual Installation

​Quick Install (Recommended)

​Review Before Installing

​Verify Installation

​Managing the Agent

​Basic Commands

​Auto-Start on Boot

​Viewing Logs

​Updates

​Uninstalling

​Troubleshooting

​Metrics Not Showing?

​Need Help?

​Security

Automatic Installation

Manual Installation

Quick Install (Recommended)

Review Before Installing

Verify Installation

Managing the Agent

Basic Commands

Auto-Start on Boot

Viewing Logs

Updates

Uninstalling

Troubleshooting

Metrics Not Showing?

Need Help?

Security