Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pmacct/pmacct

pmacct is a small set of multi-purpose passive network monitoring tools [NetFlow IPFIX sFlow libpcap BGP BMP RPKI IGP Streaming Telemetry].
https://github.com/pmacct/pmacct

avro bgp bmp geoip2 ipfix json kafka libpcap mysql ndpi netflow nflog pmacct postgresql rabbitmq rpki sflow sql sqlite3

Last synced: 21 days ago
JSON representation

pmacct is a small set of multi-purpose passive network monitoring tools [NetFlow IPFIX sFlow libpcap BGP BMP RPKI IGP Streaming Telemetry].

Awesome Lists containing this project

README

        

[![Build status](https://github.com/pmacct/pmacct/workflows/ci/badge.svg?branch=master)](https://github.com/pmacct/pmacct/actions)

DOCUMENTATION
=============

- Online:
* GitHub Wiki Pages: https://github.com/pmacct/pmacct/wiki
* GitHub master code: https://github.com/pmacct/pmacct/

- Distribution tarball:
* ChangeLog: History of features version by version
* CONFIG-KEYS: Available configuration directives explained
* QUICKSTART: Examples, command-lines, quickstart guides
* FAQS: FAQ document
* docs/: Miscellaneous internals, UNIX signals, SQL triggers documents
* examples/: Sample configs, maps, AMQP/Kafka consumers, clients
* sql/: SQL documentation, default SQL schemas and customization tips

# DOCKER IMAGES

Official pmacct docker images can be found in [docker hub](https://hub.docker.com/u/pmacct). To use them, simply (e.g. `sfacctd`):

```bash
~# docker pull pmacct/sfacctd:latest
~# docker run -v /path/to/sfacctd.conf:/etc/pmacct/sfacctd.conf pmacct/sfacctd
```

For more details, options and troubleshooting please read the [Docker documentation section](docs/DOCKER.md)

# BUILDING

Resolve dependencies, ie.:

* `apt-get install libpcap-dev pkg-config libtool autoconf automake make bash libstdc++-dev g++` for *[Debian/Ubuntu]*
* `yum install libpcap-devel pkgconfig libtool autoconf automake make bash libstdc++-devel gcc-c++` for *[CentOS/RHEL]*

Build GitHub code:

```bash
~# git clone https://github.com/pmacct/pmacct.git
~# cd pmacct
~# ./autogen.sh
~# ./configure #check-out available configure knobs via ./configure --help
~# make
~# make install #with super-user permission
```

# RELICENSE INITIATIVE

The pmacct project is looking to make its code base available under a more permissive
BSD-style license. More information about the motivation and process can be found in
this [announcement](https://www.mail-archive.com/[email protected]/msg03881.html).

# CONTRIBUTING

- Prerequisites:
* Set up git: https://help.github.com/articles/set-up-git/
* *[Specify username, a commit email address matching the GitHub profile one, and a SSH key]*

- Code:
* Fork the pmacct repo: https://help.github.com/articles/fork-a-repo/
* *[Jot down your code in the local clone of your fork, commit and push code changes to your fork]*
* Generate a Pull Request: https://help.github.com/articles/about-pull-requests/

- Wiki (documentation and diagrams):
* Ask by unicast email to be added to the project collaborators
* *[Edit wiki content online or clone it locally and commit and push changes]*
* If having to add a diagram: https://gist.github.com/subfuzion/0d3f19c4f780a7d75ba2