Overview
This documentation guides you through integrating AWS EC2 infrastructure metrics into SigNoz using the Hostmetrics receiver in OpenTelemetry Collector. The Hostmetrics receiver is designed to collect metrics about the host system from various sources. It supports various scrapers for collecting different metrics, including CPU, disk, load, filesystem, memory, network, paging, and process metrics.
Manual Setup with OpenTelemetry
The manual setup using OpenTelemetry Hostmetrics receiver provides comprehensive EC2 monitoring, collecting detailed host metrics. This method works for both SigNoz Cloud and Self-Hosted.
Prerequisites
- An EC2 instance
- SSH Access to the instance
Setup
To collect infrastructure metrics, you need to install the OpenTelemetry Collector on your EC2 instance. The collector's hostmetrics receiver is enabled by default in the SigNoz distribution.
Follow the Install OpenTelemetry Collector on VM guide.
What's Collected
| Data Type | Description |
|---|---|
| CPU | Usage, load averages, utilization per core |
| Memory | Used, available, free, and cached memory |
| Disk | I/O operations, throughput, filesystem usage |
| Network | Bytes sent/received, packet drops, errors |
Validate
Once installed, your EC2 infrastructure metrics will be visible in SigNoz:
- Navigate to Infrastructure Monitoring -> Hosts.
- You will see your EC2 instance listed.
One-Click Integration
One-Click Integration is available for SigNoz Cloud only and includes pre-built dashboards. This method uses AWS CloudFormation and CloudWatch, which may incur additional AWS charges.
Step 1: Connect Your AWS Account
Follow the One-Click AWS Integrations Guide to:
- Deploy the CloudFormation stack
- Connect your AWS account to SigNoz
Step 2: Enable EC2 Monitoring
Once connected, SigNoz will auto-discover your EC2 instances and begin collecting CloudWatch metrics.
What's Collected
| Metric | Description |
|---|---|
CPUUtilization | CPU usage percentage |
DiskReadBytes | Disk read bytes |
DiskWriteBytes | Disk write bytes |
NetworkIn | Network bytes received |
NetworkOut | Network bytes sent |
StatusCheckFailed | Instance status check failures |
Pre-built Dashboards
Navigate to Dashboards and search for "EC2" to find automatically imported dashboards.
Next Steps
- Hostmetrics Configuration Guide – Complete hostmetrics setup instructions
- Send Logs from EC2 – Configure application and server log collection
- Infrastructure Monitoring Overview – View your infrastructure metrics in SigNoz
- One-Click vs Manual Setup – Compare integration approaches