mudhorn/node_exporter
1
0
Fork 0
mirror of https://github.com/prometheus/node_exporter.git synced 2025-08-20 18:33:52 -07:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #200 from prometheus/document-availability

Browse source 
Document os support of each collector
This commit is contained in:
Tobias Schmidt 2016-01-21 19:41:34 -05:00
parent 33f99c4fc1 e2163db0f7
commit b30806ef41
6 changed files with 49 additions and 46 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

91
README.md
View file

@ -5,60 +5,55 @@
Prometheus exporter for machine metrics, written in Go with pluggable metric Prometheus exporter for machine metrics, written in Go with pluggable metric
collectors. collectors.
## Building and running ## Collectors
make There is varying support for collectors on each operating system. The tables
./node_exporter <flags> below list all existing collectors and the supported systems.
## Running tests
make test
## Available collectors
By default the build will include the native collectors that expose information
from `/proc`.
Which collectors are used is controlled by the `--collectors.enabled` flag. Which collectors are used is controlled by the `--collectors.enabled` flag.
### Enabled by default ### Enabled by default
Name | Description Name | Description | OS
---------|------------ ---------|-------------|----
conntrack | Shows conntrack statistics (does nothing if no `/proc/sys/net/netfilter/` present). conntrack | Shows conntrack statistics (does nothing if no `/proc/sys/net/netfilter/` present). | Linux
diskstats | Exposes disk I/O statistics from `/proc/diskstats`. diskstats | Exposes disk I/O statistics from `/proc/diskstats`. | Linux
entropy | Exposes available entropy. entropy | Exposes available entropy. | Linux
filefd | Exposes file descriptor statistics. filefd | Exposes file descriptor statistics. | Linux
filesystem | Exposes filesystem statistics, such as disk space used. filesystem | Exposes filesystem statistics, such as disk space used. | FreeBSD, Linux, OpenBSD
loadavg | Exposes load average. loadavg | Exposes load average. | Darwin, Dragonfly, FreeBSD, Linux, NetBSD, OpenBSD, Solaris
mdadm | Exposes statistics about devices in `/proc/mdstat` (does nothing if no `/proc/mdstat` present). mdadm | Exposes statistics about devices in `/proc/mdstat` (does nothing if no `/proc/mdstat` present). | Linux
meminfo | Exposes memory statistics from `/proc/meminfo`. meminfo | Exposes memory statistics. | FreeBSD, Linux
netdev | Exposes network interface statistics from `/proc/netstat`, such as bytes transferred. netdev | Exposes network interface statistics such as bytes transferred. | FreeBSD, Linux, OpenBSD
netstat | Exposes network statistics from `/proc/net/netstat`. This is the same information as `netstat -s`. netstat | Exposes network statistics from `/proc/net/netstat`. This is the same information as `netstat -s`. | Linux
stat | Exposes various statistics from `/proc/stat`. This includes CPU usage, boot time, forks and interrupts. stat | Exposes various statistics from `/proc/stat`. This includes CPU usage, boot time, forks and interrupts. | Linux
textfile | Exposes statistics read from local disk. The `--collector.textfile.directory` flag must be set. textfile | Exposes statistics read from local disk. The `--collector.textfile.directory` flag must be set. | _any_
time | Exposes the current system time. time | Exposes the current system time. | _any_
vmstat | Exposes statistics from `/proc/vmstat`. vmstat | Exposes statistics from `/proc/vmstat`. | Linux
version | Exposes node\_exporter version. version | Exposes node\_exporter version. | _any_
### Disabled by default ### Disabled by default
Name | Description Name | Description | OS
---------|------------ ---------|-------------|----
bonding | Exposes the number of configured and active slaves of Linux bonding interfaces. cpu | Exposes CPU statistics | FreeBSD
gmond | Exposes statistics from Ganglia. bonding | Exposes the number of configured and active slaves of Linux bonding interfaces. | Linux
interrupts | Exposes detailed interrupts statistics from `/proc/interrupts`. devstat | Exposes device statistics | FreeBSD
ipvs | Exposes IPVS status from `/proc/net/ip_vs` and stats from `/proc/net/ip_vs_stats`. gmond | Exposes statistics from Ganglia. | _any_
lastlogin | Exposes the last time there was a login. interrupts | Exposes detailed interrupts statistics. | Linux, OpenBSD
megacli | Exposes RAID statistics from MegaCLI. ipvs | Exposes IPVS status from `/proc/net/ip_vs` and stats from `/proc/net/ip_vs_stats`. | Linux
ntp | Exposes time drift from an NTP server. ksmd | Exposes kernel and system statistics from `/sys/kernel/mm/ksm`. | Linux
runit | Exposes service status from [runit](http://smarden.org/runit/). lastlogin | Exposes the last time there was a login. | _any_
supervisord | Exposes service status from [supervisord](http://supervisord.org/). megacli | Exposes RAID statistics from MegaCLI. | Linux
systemd | Exposes service and system status from [systemd](http://www.freedesktop.org/wiki/Software/systemd/). meminfo_numa | Exposes memory statistics from `/proc/meminfo_numa`. | Linux
tcpstat | Exposes TCP connection status information from `/proc/net/tcp` and `/proc/net/tcp6`. (Warning: the current version has potential performance issues in high load situations.) ntp | Exposes time drift from an NTP server. | _any_
runit | Exposes service status from [runit](http://smarden.org/runit/). | _any_
supervisord | Exposes service status from [supervisord](http://supervisord.org/). | _any_
systemd | Exposes service and system status from [systemd](http://www.freedesktop.org/wiki/Software/systemd/). | Linux
tcpstat | Exposes TCP connection status information from `/proc/net/tcp` and `/proc/net/tcp6`. (Warning: the current version has potential performance issues in high load situations.) | Linux
## Textfile Collector ### Textfile Collector
The textfile collector is similar to the [Pushgateway](https://github.com/prometheus/pushgateway), The textfile collector is similar to the [Pushgateway](https://github.com/prometheus/pushgateway),
in that it allows exporting of statistics from batch jobs. It can also be used in that it allows exporting of statistics from batch jobs. It can also be used
@ -83,6 +78,16 @@ echo 'role{role="application_server"} 1' > /path/to/directory/role.prom.$$
mv /path/to/directory/role.prom.$$ /path/to/directory/role.prom mv /path/to/directory/role.prom.$$ /path/to/directory/role.prom
``` ```
## Building and running
make
./node_exporter <flags>
## Running tests
make test
## Using Docker ## Using Docker
You can deploy this exporter using the [prom/node-exporter](https://registry.hub.docker.com/u/prom/node-exporter/) Docker image. You can deploy this exporter using the [prom/node-exporter](https://registry.hub.docker.com/u/prom/node-exporter/) Docker image.

4
collector/interrupts_common.go
View file

@ -11,10 +11,8 @@
// See the License for the specific language governing permissions and // See the License for the specific language governing permissions and
// limitations under the License. // limitations under the License.
// +build linux openbsd
// +build !nointerrupts // +build !nointerrupts
// +build !darwin
// +build !freebsd
// +build !windows
package collector package collector

0
collector/ipvs.go → collector/ipvs_linux.go
View file

0
collector/ipvs_test.go → collector/ipvs_linux_test.go
View file

0
collector/mdadm.go → collector/mdadm_linux.go
View file

0
collector/mdadm_test.go → collector/mdadm_linux_test.go
View file