{"id":13577185,"url":"https://github.com/DNS-OARC/dsc","last_synced_at":"2025-04-05T11:31:28.300Z","repository":{"id":2230443,"uuid":"45467624","full_name":"DNS-OARC/dsc","owner":"DNS-OARC","description":"DNS Statistics Collector","archived":false,"fork":false,"pushed_at":"2024-04-25T08:10:32.000Z","size":3111,"stargazers_count":103,"open_issues_count":9,"forks_count":25,"subscribers_count":21,"default_branch":"develop","last_synced_at":"2024-05-01T11:50:08.951Z","etag":null,"topics":["c","collector","dns","dns-statistics-collector","dnstap","dsc","monitoring","packet-capture","pcap","statistics"],"latest_commit_sha":null,"homepage":"https://www.dns-oarc.net/oarc/data/dsc","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DNS-OARC.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":"https://www.dns-oarc.net/donate"}},"created_at":"2015-11-03T13:18:07.000Z","updated_at":"2024-06-08T01:55:01.689Z","dependencies_parsed_at":"2024-03-15T08:25:27.810Z","dependency_job_id":"0c3c99ae-b9e4-4fb5-bfe5-11cfee5ec6a5","html_url":"https://github.com/DNS-OARC/dsc","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdsc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdsc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdsc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNS-OARC%2Fdsc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DNS-OARC","download_url":"https://codeload.github.com/DNS-OARC/dsc/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247330797,"owners_count":20921696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c","collector","dns","dns-statistics-collector","dnstap","dsc","monitoring","packet-capture","pcap","statistics"],"created_at":"2024-08-01T15:01:18.955Z","updated_at":"2025-04-05T11:31:27.902Z","avatar_url":"https://github.com/DNS-OARC.png","language":"C","funding_links":["https://www.dns-oarc.net/donate"],"categories":["C","c"],"sub_categories":[],"readme":"# DNS Statistics Collector\n\n[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=dns-oarc%3Adsc\u0026metric=bugs)](https://sonarcloud.io/summary/new_code?id=dns-oarc%3Adsc) [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=dns-oarc%3Adsc\u0026metric=security_rating)](https://sonarcloud.io/summary/new_code?id=dns-oarc%3Adsc)\n\nDNS Statistics Collector (DSC) is a tool used for collecting and exploring\nstatistics from busy DNS servers. It can be set up to run on or near\nnameservers to generate aggregated data that can then be transported to\ncentral systems for processing, displaying and archiving.\n\nTogether with `dsc-datatool` the aggregated data can be furthur enriched\nand converted for import into for example InfluxDB which can then be\naccessed by Grafana for visualzation, see this wiki on how to set up that:\n- https://github.com/DNS-OARC/dsc-datatool/wiki/Setting-up-a-test-Grafana\n\nDSC data transforming and enriching tool can be found here:\n- https://github.com/DNS-OARC/dsc-datatool\n\nMore information about DSC may be found here:\n- https://www.dns-oarc.net/tools/dsc\n- https://www.dns-oarc.net/oarc/data/dsc\n\nIssues should be reported here:\n- https://github.com/DNS-OARC/dsc/issues\n\nGeneral support and discussion:\n- Mattermost: https://chat.dns-oarc.net/community/channels/oarc-software\n\n## Dependencies\n\n`dsc` requires a couple of libraries beside a normal C compiling\nenvironment with autoconf, automake, libtool and pkgconfig.\n\n`dsc` has a non-optional dependency on the PCAP library and optional\ndependency on the MaxMindDB library (for the `asn` and `country` indexer).\n\nTo install the dependencies under Debian/Ubuntu:\n```\napt-get install -y libpcap-dev\n```\n\nTo install the dependencies under CentOS (with EPEL/PowerTools enabled):\n```\nyum install -y libpcap-devel\n```\n\nTo install the dependencies under FreeBSD 10+ using `pkg`:\n```\npkg install -y libpcap\n```\n\nNOTE: It is recommended to install the PCAP library from source/ports on\nOpenBSD since the bundled version is an older and modified version.\n\n### DNSTAP support\n\nTo enable DNSTAP support, first install the necessary dependencies and\nthen run `configure` with `--enable-dnstap`.\n\n- Debian/Ubuntu: `apt-get install -y libdnswire-dev libuv1-dev`\n- CentOS: `yum install -y dnswire-devel libuv-devel`\n- FreeBSD: `pkg install -y libuv`\n- OpenBSD: `pkg_add libuv`\n\n`dnswire` packages for Debian, Ubuntu and CentOS exists at\n[https://dev.dns-oarc.net/packages/](https://dev.dns-oarc.net/packages/),\nfor other distributions please see\n[https://github.com/DNS-OARC/dnswire](https://github.com/DNS-OARC/dnswire).\n\n## Building from source tarball\n\nThe [source tarball from DNS-OARC](https://www.dns-oarc.net/dsc/download)\ncomes prepared with `configure`:\n\n```\ntar zxvf dsc-version.tar.gz\ncd dsc-version\n./configure [options]\nmake\nmake install\n```\n\nNOTE: If building fails on FreeBSD/OpenBSD, try adding these configure\noptions: `--with-extra-cflags=\"-I /usr/local/include\" --with-extra-ldflags=\"-L/usr/local/lib\"`.\n\n## Building from Git repository\n\nIf you are building `dsc` from it's Git repository you will first need\nto initiate the Git submodules that exists and later create autoconf/automake\nfiles, this will require a build environment with autoconf, automake, libtool\nand pkgconfig to be installed.\n\n```\ngit clone https://github.com/DNS-OARC/dsc.git\ncd dsc\ngit submodule update --init\n./autogen.sh\n./configure [options]\nmake\nmake install\n```\n\nNOTE: If building fails on FreeBSD/OpenBSD, try adding these configure\noptions: `--with-extra-cflags=\"-I /usr/local/include\" --with-extra-ldflags=\"-L/usr/local/lib\"`.\n\n## Puppet\n\nJohn Bond at ICANN DNS Engineering team has developed a puppet module for DSC,\nthe module and code can be found here:\n- https://forge.puppet.com/icann/dsc\n- https://github.com/icann-dns/puppet-dsc\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDNS-OARC%2Fdsc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDNS-OARC%2Fdsc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDNS-OARC%2Fdsc/lists"}