SilverHawk Infra Agent — Installation & Troubleshooting Guide

Learn how to install, configure, and troubleshoot the SilverHawk Infra Agent for system monitoring.

27 Oct 2025infra, agent, monitoring, installation, troubleshooting

Overview

About the Agent

The SilverHawk Infra Agent is a lightweight, cross-platform daemon that continuously collects host-level performance data and streams it securely to your SilverHawk APM Dashboard. It provides visibility into your infrastructure — including CPU, memory, disk, and network utilization — helping teams detect anomalies and optimize performance.

Agent Overhead

The agent is optimized for efficiency. It runs as a background service and consumes less than:

CPU: Under 1%
Memory: 50–80 MB on average
Disk: <100 MB total footprint

The agent batches and compresses metrics before transmission to ensure minimal network overhead.

Data Collected

Agent Metrics

Metric	Description
CPU Usage (%)	Tracks CPU utilization across all cores
Memory Usage (MB, %)	Reports used vs available memory
Disk I/O & Space	Monitors disk throughput and available space
Network I/O	Captures bytes sent/received per interface
Process Stats	Monitors top processes by CPU and memory usage
System Load	Calculates system load averages over 1, 5, and 15 minutes

Why Should I Install the Agent?

Installing the Infra Agent allows SilverHawk to provide deep infrastructure insightsbeyond what basic uptime checks offer. With the agent, you can:

Track real-time CPU, memory, and disk usage per instance.
Visualize system health across all nodes in a unified dashboard.
Detect spikes or resource bottlenecks early using metric trends.
Correlate infrastructure-level metrics with APM traces and logs.
Enable anomaly detection and alerting for proactive issue resolution.

Prerequisites

Before installing, ensure the following:

Requirement	Description
Node.js	v18 or later
NPM or Yarn	Required to install the agent
API Key	Found under your SilverHawk Dashboard → Infra → API Keys
Network Access	Outbound HTTPS to api.silverhawk.dev
Privileges	Root/sudo privileges for system-level metrics

Installation

Download the Agent

bash

npm install -g silverhawk-infra

silverhawk-infra --version

Start the Agent

bash

silverhawk-infra start --api-key YOUR_API_KEY

Response: SilverHawk Agent started successfully

Troubleshooting

Agent Not Showing as Online

bash

silverhawk-agent logs

Ensure outbound access to api.silverhawk.dev
Validate API_KEY in /etc/silverhawk/config.json

NPM Installation Error (ps1 or Permission Issue)

On Windows, you may encounter an error similar to:

bash

File C:\Users\YourUser\AppData\Roaming\npm\silverhawk-agent.ps1 cannot be loaded because running scripts is disabled on this system.

To fix it, open PowerShell as Administrator and run:

bash

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Then retry installation:

bash

npm install -g silverhawk-agent

Summary

Feature	Description
Real-time metrics	CPU, Memory, Disk, Network
Process tracking	PID, CPU%, Memory%, Uptime
Secure transmission	AES + HTTPS encrypted
Auto recovery	Resumes after crash
Cross-platform	Linux, macOS, Windows