summaryrefslogtreecommitdiffstats
path: root/collectors/nfacct.plugin/README.md
blob: ae6597a409f6dc2712d23435109c32404fd9c6e0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
<!--
title: "Monitor Netfilter statistics (nfacct.plugin)"
custom_edit_url: "https://github.com/netdata/netdata/edit/master/collectors/nfacct.plugin/README.md"
sidebar_label: "Netfilter statistics (nfacct.plugin)"
learn_status: "Published"
learn_topic_type: "References"
learn_rel_path: "Integrations/Monitor/Networking"
-->

# Monitor Netfilter statistics (nfacct.plugin)

`nfacct.plugin` collects Netfilter statistics.

## Prerequisites

If you are using [our official native DEB/RPM packages](https://github.com/netdata/netdata/blob/master/packaging/installer/methods/packages.md), install the
`netdata-plugin-nfacct` package using your system package manager.

If you built Netdata locally:

1.  install `libmnl-dev` and `libnetfilter-acct-dev` using the package manager of your system.

2.  re-install Netdata from source. The installer will detect that the required libraries are now available and will also build `netdata.plugin`.

Keep in mind that NFACCT requires root access, so the plugin is setuid to root.

## Charts

The plugin provides Netfilter connection tracker statistics and nfacct packet and bandwidth accounting:

Connection tracker:

1.  Connections.
2.  Changes.
3.  Expectations.
4.  Errors.
5.  Searches.

Netfilter accounting:

1.  Packets.
2.  Bandwidth.

## Configuration

If you need to disable NFACCT for Netdata, edit /etc/netdata/netdata.conf and set:

```
[plugins]
    nfacct = no
```

## Debugging

You can run the plugin by hand:

```
sudo /usr/libexec/netdata/plugins.d/nfacct.plugin 1 debug
```

You will get verbose output on what the plugin does.