Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DNS-OARC/dsc
DNS Statistics Collector
https://github.com/DNS-OARC/dsc
c collector dns dns-statistics-collector dnstap dsc monitoring packet-capture pcap statistics
Last synced: about 9 hours ago
JSON representation
DNS Statistics Collector
- Host: GitHub
- URL: https://github.com/DNS-OARC/dsc
- Owner: DNS-OARC
- License: other
- Created: 2015-11-03T13:18:07.000Z (about 9 years ago)
- Default Branch: develop
- Last Pushed: 2024-04-25T08:10:32.000Z (6 months ago)
- Last Synced: 2024-05-01T11:50:08.951Z (6 months ago)
- Topics: c, collector, dns, dns-statistics-collector, dnstap, dsc, monitoring, packet-capture, pcap, statistics
- Language: C
- Homepage: https://www.dns-oarc.net/oarc/data/dsc
- Size: 2.97 MB
- Stars: 103
- Watchers: 21
- Forks: 25
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - DNS-OARC/dsc - DNS Statistics Collector (monitoring)
README
# DNS Statistics Collector
[](https://sonarcloud.io/summary/new_code?id=dns-oarc%3Adsc) [](https://sonarcloud.io/summary/new_code?id=dns-oarc%3Adsc)
DNS Statistics Collector (DSC) is a tool used for collecting and exploring
statistics from busy DNS servers. It can be set up to run on or near
nameservers to generate aggregated data that can then be transported to
central systems for processing, displaying and archiving.
Together with `dsc-datatool` the aggregated data can be furthur enriched
and converted for import into for example InfluxDB which can then be
accessed by Grafana for visualzation, see this wiki on how to set up that:
- https://github.com/DNS-OARC/dsc-datatool/wiki/Setting-up-a-test-Grafana
DSC data transforming and enriching tool can be found here:
- https://github.com/DNS-OARC/dsc-datatool
More information about DSC may be found here:
- https://www.dns-oarc.net/tools/dsc
- https://www.dns-oarc.net/oarc/data/dsc
Issues should be reported here:
- https://github.com/DNS-OARC/dsc/issues
General support and discussion:
- Mattermost: https://chat.dns-oarc.net/community/channels/oarc-software
## Dependencies
`dsc` requires a couple of libraries beside a normal C compiling
environment with autoconf, automake, libtool and pkgconfig.
`dsc` has a non-optional dependency on the PCAP library and optional
dependency on the MaxMindDB library (for the `asn` and `country` indexer).
To install the dependencies under Debian/Ubuntu:
```
apt-get install -y libpcap-dev
```
To install the dependencies under CentOS (with EPEL/PowerTools enabled):
```
yum install -y libpcap-devel
```
To install the dependencies under FreeBSD 10+ using `pkg`:
```
pkg install -y libpcap
```
NOTE: It is recommended to install the PCAP library from source/ports on
OpenBSD since the bundled version is an older and modified version.
### DNSTAP support
To enable DNSTAP support, first install the necessary dependencies and
then run `configure` with `--enable-dnstap`.
- Debian/Ubuntu: `apt-get install -y libdnswire-dev libuv1-dev`
- CentOS: `yum install -y dnswire-devel libuv-devel`
- FreeBSD: `pkg install -y libuv`
- OpenBSD: `pkg_add libuv`
`dnswire` packages for Debian, Ubuntu and CentOS exists at
[https://dev.dns-oarc.net/packages/](https://dev.dns-oarc.net/packages/),
for other distributions please see
[https://github.com/DNS-OARC/dnswire](https://github.com/DNS-OARC/dnswire).
## Building from source tarball
The [source tarball from DNS-OARC](https://www.dns-oarc.net/dsc/download)
comes prepared with `configure`:
```
tar zxvf dsc-version.tar.gz
cd dsc-version
./configure [options]
make
make install
```
NOTE: If building fails on FreeBSD/OpenBSD, try adding these configure
options: `--with-extra-cflags="-I /usr/local/include" --with-extra-ldflags="-L/usr/local/lib"`.
## Building from Git repository
If you are building `dsc` from it's Git repository you will first need
to initiate the Git submodules that exists and later create autoconf/automake
files, this will require a build environment with autoconf, automake, libtool
and pkgconfig to be installed.
```
git clone https://github.com/DNS-OARC/dsc.git
cd dsc
git submodule update --init
./autogen.sh
./configure [options]
make
make install
```
NOTE: If building fails on FreeBSD/OpenBSD, try adding these configure
options: `--with-extra-cflags="-I /usr/local/include" --with-extra-ldflags="-L/usr/local/lib"`.
## Puppet
John Bond at ICANN DNS Engineering team has developed a puppet module for DSC,
the module and code can be found here:
- https://forge.puppet.com/icann/dsc
- https://github.com/icann-dns/puppet-dsc