Repository navigation
Releases: umatare5/xflow-exporter
Release list
v0.13.2
xflow-exporter v0.13.2
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
In this release, the Go toolchain updates to 1.27.3 with accumulated bug fixes:
- Address the eMudhra Intermediate CA compromise in Go TLS.
- This release carries accumulated bug fixes and dependency updates.
Important
A minor release may remove a metric, drop a label, or change what one reports. Read the CHANGELOG before upgrading.
🐳 Container Images
# Show the help
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.13.2 --help
# Run with the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.13.2📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Features
Bug Fixes
- d0548b3: fix(deps): update all minor dependencies (#114) (@renovate[bot])
- 9655563: fix(deps): update all minor dependencies (#119) (@renovate[bot])
- 6d2a054: fix(deps): update module github.com/urfave/cli/v3 to v3.14.0 (#117) (@renovate[bot])
- 7ca3769: fix(deps): update module golang.org/x/net to v0.60.0 [security] (#116) (@renovate[bot])
Documentation Updates
- 2cd90e7: docs(readme): replace absolute paths with relative paths (#112) (@umatare5)
- afa21a3: docs(readme): replace relative paths with absolute paths (#111) (@umatare5)
Others
- 2de07f5: Clarify comments in flow record setup (@umatare5)
- 19e9722: Update README.md (@umatare5)
- c2436f6: chore(deps): update all patch dependencies (#113) (@renovate[bot])
- 56e41d7: chore(deps): update all patch dependencies (#118) (@renovate[bot])
- bd4819e: chore(deps): update go toolchain directive to v1.27.2 [security] (#115) (@renovate[bot])
- 1142549: chore(deps): update go toolchain directive to v1.27.3 [security] (#120) (@renovate[bot])
Full Changelog: v0.13.1...v0.13.2
📚 Documentation
Contributors
Assets 9
v0.13.1
xflow-exporter v0.13.1
A Prometheus Exporter for traffic flows: NetFlow, IPFIX and sFlow.
In this release, enforcing the template bound costs less:
- A domain at its template bound scans for expired templates only once one can have expired, not per new ID.
- A new ID that finds no room among live templates is still refused and counted as
invalid_template. - No metric, label or flag changed, and the docs, comments and dashboard descriptions now use American English.
Important
A minor release may remove a metric, drop a label, or change what one reports. Read the CHANGELOG before upgrading.
🐳 Container Images
# Show the help
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.13.1 --help
# Run with the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.13.1📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Bug Fixes
Documentation Updates
Others
- d581941: Rebuild on every make build and keep worktrees on make clean (#105) (@umatare5)
- c67b030: Render the coverage badge in CI instead of committing it (#109) (@umatare5)
Full Changelog: v0.13.0...v0.13.1
📚 Documentation
Contributors
Assets 9
v0.13.0
xflow-exporter v0.13.0
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
In this release, template handling changed:
- Templates are now valid per transport session, so two export processes stop swapping layouts.
- A refused or discarded template now leaves its data undecoded, not read with a stale layout.
Important
A minor release may remove a metric, drop a label, or change what one reports. Read the CHANGELOG before upgrading.
🐳 Container Images
# Show the help
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.13.0 --help
# Run with the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.13.0📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Bug Fixes
- 37e80f0: fix(decoder): apply a scoped sampling rate only to what it names (#96) (@umatare5)
- f6d516b: fix(decoder): bound the template fields one device holds (#95) (@umatare5)
- 870a47d: fix(decoder): discard a malformed IPFIX message whole (#99) (@umatare5)
- f5902f3: fix(decoder): free the expired templates of live domains in the sweep (#94) (@umatare5)
- eb2db41: fix(decoder): log the template elements no reader consumes (#98) (@umatare5)
- a224475: fix(decoder): read applicationId as RFC 6759 lays it out (#100) (@umatare5)
- f27eb6a: fix(decoder): replace a counter only when the record omits it (#103) (@umatare5)
- 44a81f6: fix(decoder): scope templates by transport session (#93) (@umatare5)
- ae5b2c4: fix(decoder): take an absolute flow clock only as a whole pair (#101) (@umatare5)
- eb5a4d1: fix(decoder): withdraw a refused template and read past it (#102) (@umatare5)
Documentation Updates
- 20e6e15: docs: align the documentation set with cisco-wnc-exporter (#90) (@umatare5)
- 34a6968: docs: close the remaining gaps against cisco-wnc-exporter (#91) (@umatare5)
- c286e84: docs: consolidate markdownlint-cli2.jsonc comment (#92) (@umatare5)
- 53dae6c: docs: state the RFC deviations and correct the audited claims (#97) (@umatare5)
Others
Full Changelog: v0.12.0...v0.13.0
📚 Documentation
Contributors
Assets 9
v0.12.0
xflow-exporter v0.12.0
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
In this release, the label set changed: direction now carries the observation point and the new endpoint names the flow's two ends. Additionally, a value the device never reported is now withheld rather than published as a fabricated zero.
Important
A minor release may rename or remove a metric, change a default, or drop a built-in application name. Read the CHANGELOG before upgrading.
🐳 Container Images
# Latest version
docker run --rm ghcr.io/umatare5/xflow-exporter:latest --help
# Specific version
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.12.0 --help
# With the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.12.0📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Bug Fixes
- 6fcffd1: fix(deps): update all minor dependencies (#70) (@renovate[bot])
- ea5ad85: fix(deps): update all patch dependencies (#69) (@renovate[bot])
Others
- 6e58d09: Bound flow histogram series and the range one series holds (#73) (@umatare5)
- c1eacd2: Bound the devices holding domain state (#75) (@umatare5)
- 405d78b: Count the records no sampling declaration settles a rate for (#74) (@umatare5)
- 3861cf8: Hold each wire element to the width and count its spec defines (#76) (@umatare5)
- d44c0a0: Hold the metric pages to what the collectors publish (#72) (@umatare5)
- 9db6e4e: Key every traffic family on the observation point it was taken at (#83) (@umatare5)
- 5f31c2d: Key the service families on the port a service table names (#84) (@umatare5)
- fdf617c: List every entry an aggregation table holds behind a flag (#71) (@umatare5)
- 6711731: Measure each flow clock back from the export or withhold it (#77) (@umatare5)
- d98b3db: Name the end of a flow the way RFC 5103 names it (#86) (@umatare5)
- 6e3bc06: Narrow the collector table so no cell wraps on GitHub (#67) (@umatare5)
- a6e3412: Number each transport session's export sequence apart (#79) (@umatare5)
- 868b373: Redact the endpoint, bound the writes, and cut the scrape work (#78) (@umatare5)
- e445d4a: Restore the absence rule and move the credential out of the URL (#80) (@umatare5)
- 5ede6ff: Route an aggregate by the fold its own template declares (#82) (@umatare5)
- d79e6da: Settle each sampling rate against the declaration that names it (#81) (@umatare5)
- 30d6ca7: Stop a retry from holding the test stub server open (#87) (@umatare5)
- 956099f: Update README.md (#68) (@umatare5)
- 7918cdf: Withhold the counted family no device measured (#85) (@umatare5)
Full Changelog: v0.11.0...v0.12.0
📚 Documentation
Contributors
Assets 9
v0.11.0
xflow-exporter v0.11.0
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
In this release, new enrichment VLAN mapping is available. Additionally, much of the documentation and metrics help messages have been refactored.
Important
A minor release may rename or remove a metric, change a default, or drop a built-in application name. Read the CHANGELOG before upgrading.
🐳 Container Images
# Latest version
docker run --rm ghcr.io/umatare5/xflow-exporter:latest --help
# Specific version
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.11.0 --help
# With the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.11.0📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Others
- 4eb070e: Break traffic down by the VLAN a mapping file puts each address on (#65) (@umatare5)
- d8c3e97: Restructure the documentation set and repair its cross-links (#66) (@umatare5)
- f2331b8: State what each series counts and what the sampling audit returns (#64) (@umatare5)
Full Changelog: v0.10.0...v0.11.0
📚 Documentation
Contributors
Assets 9
v0.10.0
xflow-exporter v0.10.0
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
In this release, I verified the operation of Netflow v5/v8 using C891 and sFlow v5 using HP 2530 and fixed several bugs.
Important
A minor release may rename or remove a metric, change a default, or drop a built-in application name. Read the CHANGELOG before upgrading.
🐳 Container Images
# Latest version
docker run --rm ghcr.io/umatare5/xflow-exporter:latest --help
# Specific version
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.10.0 --help
# With the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.10.0📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Documentation Updates
- c2c5865: docs: updated the protocols table to include planned verification for Juniper devices (#60) (@umatare5)
Others
- ed8e368: Clamp the sampling correction and refuse an overlong sampled packet (#52) (@umatare5)
- a1b8b38: Correct a sampled record by the sampler it names (#57) (@umatare5)
- 5561421: Drop the device this decoder never read from the verified table (#56) (@umatare5)
- 8dad4d3: Gather the contributor conventions and cut them to reading length (#48) (@umatare5)
- 8a41f52: Name the flow count a v9 aggregation cache does declare (#61) (@umatare5)
- 4f482ef: Point the contributor pages at the shared baseline (#50) (@umatare5)
- 553c94a: Record C891FJ-K9's v9 export, separate its v5 and v9 views (#58) (@umatare5)
- e7c5072: Record the v5 sampler a device names without its rate (#62) (@umatare5)
- 6f0f1cc: Ship only the licences and the parsed config beside the binary (#49) (@umatare5)
- eba90d0: Split the docs by owner, rename the collector, and fix the rendering (#47) (@umatare5)
- 535a09b: Track the NetFlow v5 and v8 export sequence, part the flow counters (#59) (@umatare5)
- 0e79e42: chore(deps): update umatare5/common action to v0.19.0 (#51) (@renovate[bot])
Full Changelog: v0.9.1...v0.10.0
📚 Documentation
Contributors
Assets 9
v0.9.1
xflow-exporter v0.9.1
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
In this release, it introduces enhancements to the dry-run validation and SNMP walk behavior, implements weekly CI workflows, and includes minor documentation corrections.
Important
A minor release may rename or remove a metric, change a default, or drop a built-in application name. Read the CHANGELOG before upgrading.
🐳 Container Images
# Latest version
docker run --rm ghcr.io/umatare5/xflow-exporter:latest --help
# Specific version
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.9.1 --help
# With the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.9.1📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Documentation Updates
- 8230100: docs: Fix spelling of 'Licence' to 'License' (@umatare5)
- e8a023a: docs: Fix spelling of 'Licence' to 'License' in README (@umatare5)
- b4b510d: docs: align the headings and spelling with controld-exporter (#45) (@umatare5)
Others
- 5ddf92d: Open the sources --dry-run names, which only startup opened (#42) (@umatare5)
- 2fb41ef: Pin the counter, threat and interface guards left unheld (#40) (@umatare5)
- cb43cd2: Record what a dry run now opens and what it still does not check (#43) (@umatare5)
- 37c5b73: Release v0.9.1 (#46) (@umatare5)
- 33c46a9: Report failed scheduled runs and build a weekly release snapshot (#44) (@umatare5)
- b837b78: Run the build and tests weekly (#39) (@umatare5)
- 8541d5a: Stop the SNMP walk writing a file the exporter refuses (#41) (@umatare5)
Full Changelog: v0.9.0...v0.9.1
📚 Documentation
Contributors
Assets 9
v0.9.0
xflow-exporter v0.9.0
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
In this release, I verified the operation of IPFIX and NetFlow v9 using the C9800 and fixed several bugs.
Important
A minor release may rename or remove a metric, change a default, or drop a built-in application name. Read the CHANGELOG before upgrading.
🐳 Container Images
# Latest version
docker run --rm ghcr.io/umatare5/xflow-exporter:latest --help
# Specific version
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.9.0 --help
# With the default ports published
docker run --rm -p 10053:10053 -p 4739:4739/udp ghcr.io/umatare5/xflow-exporter:v0.9.0📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Features
- 864d30f: feat!: name only the protocols a traffic breakdown reads (#35) (@umatare5)
- d3181e2: feat!: receive flows on the registered port 4739 (#33) (@umatare5)
Bug Fixes
- 835a1d9: fix: close the review findings that block the v0.9.0 release (#37) (@umatare5)
- ca54590: fix: decode each device's datagrams in wire order (#30) (@umatare5)
- 06bd9af: fix: withhold the size histogram where the record carried no byte count (#29) (@umatare5)
Documentation Updates
- cfd6378: docs: cosmetic fix (@umatare5)
- 3e18452: docs: fix verified devices, NetFlow Lite claims, and changelog (#27) (@umatare5)
- f443cf5: docs: give each overview point something only it says (#22) (@umatare5)
- 361d557: docs: hold the architecture diagram to the line it illustrates (#23) (@umatare5)
- 3811257: docs: rename configuration.md to help.md (#28) (@umatare5)
- dfb691e: docs: unify the security sections and restate the domain rules (#34) (@umatare5)
Others
- 6007309: Change logo dimensions in README.md (@umatare5)
- ae13667: Extend the shared Renovate profile and pin the Alpine tag (#36) (@umatare5)
- 5f59f83: Resolve device, interface and service names from a mapping file (#25) (@umatare5)
- 9d9ca90: Update README with govulncheck badge (#21) (@umatare5)
- 33f23ac: Update logo image width in README.md (@umatare5)
- c849e74: chore(deps): update dependency golangci/golangci-lint to v2.13.2 (#24) (@renovate[bot])
- a7a2d6b: chore(deps): update umatare5/common action to v0.18.0 (#26) (@renovate[bot])
- 79520bb: chore: release v0.9.0 (#32) (@umatare5)
Full Changelog: v0.8.0...v0.9.0
📚 Documentation
Contributors
Assets 9
v0.8.0
xflow-exporter v0.8.0
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
Important
A minor release may rename or remove a metric. Read the CHANGELOG before upgrading.
🐳 Container Images
# Latest version
docker run --rm ghcr.io/umatare5/xflow-exporter:latest --help
# Specific version
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.8.0 --help
# With the default ports published
docker run --rm -p 10053:10053 -p 2055:2055/udp ghcr.io/umatare5/xflow-exporter:v0.8.0📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Documentation Updates
- df2485a: docs: add Prometheus recording rules example (#17) (@umatare5)
- 219a01d: docs: add badges, architecture diagram and Grafana dashboard update (#11) (@umatare5)
- c6d2f91: docs: cosmetic fix (@umatare5)
- 942996c: docs: record the pre-commit and link check tooling (#15) (@umatare5)
- 6591d77: docs: set file path links in code style (#16) (@umatare5)
- 6f25fe1: docs: update (@umatare5)
- 1cd2e9a: docs: update README.md (@umatare5)
Others
- a21143d: Refresh the service port table for current networks (#19) (@umatare5)
- 60f100a: chore: release v0.8.0 (#20) (@umatare5)
Full Changelog: v0.7.0...v0.8.0
📚 Documentation
Contributors
Assets 9
v0.7.0-pre
xflow-exporter v0.7.0
This release contains the Prometheus Exporter for NetFlow, IPFIX and sFlow.
Important
A minor release may rename or remove a metric. Read the CHANGELOG before upgrading.
🐳 Container Images
# Latest version
docker run --rm ghcr.io/umatare5/xflow-exporter:latest --help
# Specific version
docker run --rm ghcr.io/umatare5/xflow-exporter:v0.7.0 --help
# With the default ports published
docker run --rm -p 10053:10053 -p 2055:2055/udp ghcr.io/umatare5/xflow-exporter:v0.7.0📦 Binary Installation
Download a prebuilt binary for your platform from the release assets below.
Changelog
Features
Others
Full Changelog: v0.6.0...v0.7.0