Changelog
All notable changes to OxiPulse, most recent first.
May 28, 2026
Add Cloudflare DNS as a default fallback latency target for instant out-of-the-box monitoring.
- Cloudflare DNS (1.1.1.1:53) is now automatically included as a default latency target when `latency_targets` is empty. This provides immediate, zero-config internet connection latency monitoring alongside the ingestor endpoint.
May 28, 2026
Dynamic network latency metrics via concurrent, non-privileged TCP pings.
- Network latency metric (`system.network.latency`) with `target` and `status` attributes.
- Asynchronous concurrent TCP ping mechanism to measure latencies of multiple targets in parallel without blocking the main telemetry loop.
- New `latency_targets` configuration key (and `OXIPULSE_LATENCY_TARGETS` environment variable) to define a custom list of hosts/ports to monitor.
- Automatic fallback to measure latency to the configured OTLP ingestor endpoint if no custom targets are specified.
- Robust logging setup on Windows — automatically falls back to console logging (stdout) if the daily rolling log directory (`C:\ProgramData\oxipulse`) lacks write permissions or if `OXIPULSE_LOG_STDOUT` is enabled, eliminating start panics.
May 20, 2026
Use short device names for Linux disks.
- Linux disk monitoring now uses short, clean device names instead of absolute sysfs paths.
May 14, 2026
Improve disk labeling for Windows and Linux mount points.
- Uses the mount point as the primary disk label (e.g., `C:` on Windows, `/` on Linux) to make individual disk metrics clear in the dashboard.
May 13, 2026
Disk label fallback improvement on Linux.
- Fallback to using mount points as the disk name when the standard disk label attribute is empty on Linux filesystems.
May 13, 2026
Granular per-disk telemetries utilizing OTel semantic conventions.
- Per-disk metric reporting attaching the OTel standard `disk.name` attribute on disk used and total indicators, enabling multiple disk visualization.
May 11, 2026
Telemetry pings now report agent type.
- Attaches the `agent_type` field to the daily opt-in usage telemetry pings to separate different agent kinds.
May 11, 2026
Add local version flag for easy agent discovery.
- Introduced `--version` and `-V` CLI flags to allow developers and scripts to easily retrieve the installed agent version locally.
May 11, 2026
Real-time network throughput instead of raw total counters.
- Modified network metrics to calculate and report real-time throughput in bytes per second (`net_bps_in` and `net_bps_out`) rather than aggregate raw totals.
May 9, 2026
Documentation cleanups and minor updates.
- Polished internal README guidelines, documentation files, and minor repository adjustments.
May 8, 2026
Typo corrections in changelog history.
- Corrected minor version typos and adjusted dates in the OxiPulse changelog history.
May 8, 2026
Local agent mode for nexus-agent tunnel integration, and critical Windows fixes.
- New `local_agent` deployment mode in config to route OTLP payloads locally to the `nexus-agent` gRPC tunnel client.
- Eliminated the `VCRUNTIME140.dll` dependency on Windows by statically linking the MSVC runtime inside release builds.
- Windows installer now stops any running agent service before overwriting the executable, resolving locked file errors.
April 6, 2026
Update checks now happen 5 minutes after startup instead of 24 hours.
- The auto-updater previously waited a full 24 hours before its first check, so restarting the agent never triggered a prompt update pickup. The agent now checks for a new release 5 minutes after startup and then every 24 hours, meaning a restart is enough to pull a pending update within minutes.
April 6, 2026
Opt-in usage telemetry and remote configuration.
- Opt-in usage telemetry — the agent can now send anonymous usage pings (version, OS, arch, uptime, metrics exported, buffer occupancy) to SecuryBlack once every 24 hours. Disabled by default for all installations, including agents upgrading from previous versions.
- Remote configuration fetch — on startup the agent calls the SecuryBlack API with its token to retrieve server-side settings. This allows telemetry to be enabled or disabled per agent from the dashboard without touching the local config file.
- New config key `telemetry_enabled` (absent → defers to server, `true` → always on, `false` → always off) and corresponding `OXIPULSE_TELEMETRY` environment variable override.
- New optional config key `api_url` and `OXIPULSE_API_URL` environment variable for self-hosted or staging deployments.
April 5, 2026
Report agent version as an OTLP resource attribute and update TLS dependencies.
- Agent version is now attached as the `service.version` resource attribute in every OTLP export, allowing the ingestor to track which version of OxiPulse each agent is running.
- Updated `rustls-webpki` to the latest patch release (security maintenance).
March 27, 2026
Dependency lockfile cleanup following 0.1.6.
- Updated Cargo.lock to fully reflect the dependency changes shipped in 0.1.6. No functional changes.
March 27, 2026
Connectivity, installer fixes and a security dependency update.
- Reachability check now tries IPv4 addresses before IPv6, preventing long stalls when the ingestor host has no IPv6 listener.
- Linux install script reads TTY input via `/dev/tty` so the installer works correctly when executed through a pipe (`curl … | bash`).
- Windows install script uses the `PROCESSOR_ARCHITECTURE` environment variable for architecture detection instead of .NET `RuntimeInformation`, improving compatibility across environments.
- Updated `tar` dependency to the latest patch release (security maintenance).
March 19, 2026
Maintenance release with updated dependencies.
- Updated Cargo.lock to keep dependencies in sync with the published crate.
March 19, 2026
Critical TLS fixes for agents connecting to HTTPS ingestors.
- Enabled explicit TLS in the OTLP exporter so metrics are correctly delivered over HTTPS endpoints.
- Activated TLS in the tonic transport layer to resolve connection failures when the ingestor is behind HTTPS.
March 15, 2026
Fix reachability check port for HTTPS ingestor endpoints.
- Reachability pre-check now uses port 443 when the configured OTLP endpoint scheme is https://, preventing false "unreachable" results on standard HTTPS deployments.
March 15, 2026
Fix file logging in Windows Service mode and improve offline reconnection.
- Log output is now written to disk when the agent runs as a Windows Service (previously only visible in interactive mode).
- Offline reconnection logic corrected — agent resumes sending buffered metrics as soon as the ingestor becomes reachable again.
March 14, 2026
Windows Service integration and installer fix for non-English locales.
- Native Windows Service Manager integration — the agent can now be installed, started, stopped and uninstalled as a proper Windows Service via the PowerShell installer.
- Windows installer now uses well-known SIDs when setting ACL permissions, fixing failures on systems with non-English locale account names.
March 1, 2025
Initial public release. Ultralight telemetry agent for Linux and Windows.
- CPU, RAM, disk and network metric collection via native OS APIs
- OTLP/gRPC export with configurable endpoint and interval
- Offline buffer — metrics persisted to disk when collector is unreachable
- Auto-update — daily check against GitHub Releases with SHA256 verification
- One-line install script for Linux (curl | bash) with systemd service registration
- One-line install script for Windows (irm | iex) with Windows Service registration
- Support for x86_64 and ARM64 on Linux; x86_64 on Windows
- Configuration via environment variables or config.toml file
- Apache 2.0 license
OxiPulse project started