# SigNoz Agent

SigNoz Agent is a lightweight OpenTelemetry collector for the signoz-aio observability stack. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/287/signoz-agent

## Description

SigNoz Agent is a lightweight OpenTelemetry collector for the signoz-aio observability stack. It receives local application telemetry, scrapes optional Prometheus targets, collects optional host and Docker metrics, and tails optional Docker container logs before forwarding data to your main SigNoz endpoint. Use it on remote Unraid servers, separate Docker hosts, or any machine where you want collection separated from the main signoz-aio backend.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

43/100 (Fair), based on 4 of 4 factors.
- Maintained: 71 (last commit 156 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 30 (4 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/jsonbored/signoz-agent
- GitHub: https://github.com/JSONbored/signoz-aio
- Unraid: https://ca.unraid.net/apps/signoz-agent-056zy4311337i7?q=signoz-agent
- Official website: https://aethereal.dev

## Common questions

### How should I configure the endpoint when signoz-aio runs on another host?

Set the OpenTelemetry Protocol endpoint to the signoz-aio host or IP with port 4317.

### Does signoz-agent mount the host filesystem or Docker socket by default?

No. It defaults to no host root, Docker socket, or Docker log mounts; those are advanced opt-in settings.

### Can I run signoz-agent on a separate machine from the signoz-aio backend?

Yes. It is designed to collect telemetry from remote machines and forward it to signoz-aio.

### Can I customize collector pipelines in signoz-agent without replacing signoz-aio?

Yes. It can run advanced collector pipelines without replacing the backend AIO template.

### Where should I report a problem with the signoz-agent template?

Use the JSONbored/signoz-aio issue tracker, since both templates share the same support surface.

## Alternatives

- Better Stack: AI-driven monitoring platform providing incident management, real-time logs, uptime, traces, error tracking, infrastructure analytics, and…
- Datadog: Datadog Agent is an on-host monitoring agent that collects metrics, logs, and traces from hosts, containers, and Kubernetes clusters and se…
- Grafana: Grafana is an open-source monitoring and observability platform for querying, visualizing, alerting on, and sharing dashboards for metrics…
- Graylog: Graylog is a centralized log management platform built on open standards for capturing, storing, and analyzing terabytes of machine data in…
- Kibana: Kibana is the data visualization layer for querying, analyzing, and managing data stored in Elasticsearch.
- Nagios: Nagios is an open-source monitoring system that checks hosts, network services, and IT infrastructure resources so IT administrators can id…
- NetWorx: NetWorx is a simple, yet versatile and powerful tool that helps you objectively evaluate your bandwidth consumption situation.
- Netdata: Netdata is a real-time performance and health monitoring solution that collects per-second metrics from your servers, containers, networks,…
- SigNoz: SigNoz is a self-hostable open-source observability platform that unifies logs, metrics, traces, alerts, and dashboards using OpenTelemetry…
- TrafficMonitor: Monitors real-time network speed, CPU, and memory usage on Windows with a floating window or taskbar widget, customizable skins, and traffi…
- Zabbix: Zabbix is an enterprise-class, open-source distributed monitoring solution designed to monitor the performance and availability of network…

---
Source: Our Local Host (https://ourlocalhost.com/app/287/signoz-agent), the self-hosted and open-source app directory.
