{"id":30799383,"url":"https://github.com/triole/arp-exporter","last_synced_at":"2025-09-05T19:11:50.353Z","repository":{"id":256922141,"uuid":"856781859","full_name":"triole/arp-exporter","owner":"triole","description":"exports the arp table enriched with metadata as json or prometheus metrics, runs as cli tool or web server","archived":false,"fork":false,"pushed_at":"2024-11-30T21:42:58.000Z","size":865,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-30T22:34:38.589Z","etag":null,"topics":["arp","arptables","prometheus"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/triole.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-09-13T07:37:49.000Z","updated_at":"2024-11-30T21:42:06.000Z","dependencies_parsed_at":"2024-09-13T23:17:42.043Z","dependency_job_id":"3ad2e23c-6169-4156-92dc-6557e0a6d021","html_url":"https://github.com/triole/arp-exporter","commit_stats":null,"previous_names":["triole/arp-exporter"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/triole/arp-exporter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/triole%2Farp-exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/triole%2Farp-exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/triole%2Farp-exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/triole%2Farp-exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/triole","download_url":"https://codeload.github.com/triole/arp-exporter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/triole%2Farp-exporter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273806206,"owners_count":25171569,"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","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["arp","arptables","prometheus"],"created_at":"2025-09-05T19:11:37.802Z","updated_at":"2025-09-05T19:11:50.339Z","avatar_url":"https://github.com/triole.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ARP Exporter\n\n\u003c!-- toc --\u003e\n\n- [Synopsis](#synopsis)\n- [Help](#help)\n- [Vendors](#vendors)\n\n\u003c!-- /toc --\u003e\n\n## Synopsis\n\nThe arp-exporter allows to export the arp table as json or prometheus metric. It works as command line tool or web server. Running a server will provide the endpoints `/json` and `/metrics` delivering the relevant information. There also are a few request parameters that allow address filtering and other things. Feel free to check the index page at `/` for more information.\n\n## Help\n\n```go mdox-exec=\"r -h\"\nUsage: arp-exporter [flags]\n\narp table exporter, supports prometheus metrics or json format\n\nFlags:\n  -h, --help                      Show context-sensitive help.\n  -f, --arp-table-file=STRING     retrieve arp table from file, default is by\n                                  command 'arp -an'\n  -m, --mac-info=STRING           look up and display mac address vendor\n                                  information\n  -l, --list-vendors              list all vendors in db\n  -n, --hostname-config=STRING    host name configuration file\n  -e, --enable-vendors            enable displaying mac vendors\n  -s, --server                    run web server\n  -b, --bind=\":9100\"              where to bind the server to\n      --log-file=\"/dev/stdout\"    log file\n      --log-level=\"info\"          log level\n      --log-no-colors             disable output colours, print plain text\n      --log-json                  enable json log, instead of text one\n  -V, --version-flag              display version\n```\n\n## Hostname Lookup\n\nThe tool supports hostname lookup if a hostnames config is provided using `-n`. The hostname config consists of an array that contains a list of device information. These can be the mac address, the device's name and the id of the network interface. If a mac address of the arp table matches a mac address of the hostname config entry, the information will be added to the final output data. This enables you to enrich the arp table or metrics result with metadata like for example the name of the device. A hostname config looks like the following...\n\n```go mdox-exec=\"tail -n+2 examples/hostnames.yaml\"\n- name: my_pc\n  itf: eth0\n  mac: bc:fc:e7:yy:zz:zz\n- name: my_tablet\n  itf: wifi\n  mac: 00:1a:11:aa:bb:cc\n- name: another_pc\n  itf: wifi\n  mac: 78:d6:b2:jj:kk:ll\n```\n\n## Vendors\n\nIf enabled using `-e`, the arp-exporter also adds vendor information to the output. The vendor database is embedded into the tool and was taken from [maclookup.app](https://maclookup.app/downloads/json-database).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftriole%2Farp-exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftriole%2Farp-exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftriole%2Farp-exporter/lists"}