Skip to content

Haribon v1.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 04 May 01:51

Haribon Release Notes

Version 1.3.0 — Observability and Stability Enhancements

Haribon v1.3.0 continues strengthening the reliability and observability layer of the load balancer. This release focuses on improving runtime stability, safer backend selection, and better production logging behavior while keeping the core architecture lightweight and predictable.


Improvements

Health-Aware Backend Selection

Backend selection now prioritizes healthy services more consistently and avoids routing to unhealthy nodes under edge conditions.

  • Improved health-check evaluation logic
  • Safer fallback behavior when health data is incomplete
  • Prevents accidental routing to unavailable backends under load

Improved Round-Robin Stability

The round-robin mechanism has been refined to ensure:

  • Stable ordering under concurrent requests
  • Consistent backend rotation behavior
  • Reduced risk of repeated backend selection under load

This improves fairness in request distribution across all healthy nodes.


Safer Logging Initialization

Logging system improvements:

  • Automatic fallback to stdout if file logging fails
  • More consistent log writer initialization
  • Prevents silent logging failures during startup

Enhanced File Logging Safety

Log file handling is now more robust:

  • Automatic directory creation for log paths
  • Safer file opening with graceful fallback
  • Better behavior in containerized environments (Docker/Kubernetes)

Improved Request Handling Stability

  • Safer context handling for upstream requests
  • Reduced risk of resource leaks in concurrent requests
  • More predictable request cancellation behavior

Better Observability Readiness

Structured logs are now more consistent for ingestion pipelines:

  • Fully JSON-formatted logs
  • Stable schema for Loki / Promtail ingestion
  • Consistent timestamp and duration reporting

Core Behavior (Unchanged)

  • Round-robin load balancing
  • Health-aware backend filtering
  • YAML configuration support
  • Environment variable overrides
  • Lightweight Go binary design
  • Reverse proxy forwarding

Logging Format

Haribon emits structured logs in this format:

{
  "time": "2026-05-04T01:31:55.3551454Z",
  "method": "GET",
  "path": "/",
  "backend": "http://localhost:4442",
  "status": 200,
  "duration_ms": 5,
  "level": "info"
}

Upgrade Notes

  • No breaking changes
  • Fully backward compatible with v1.2.x configs
  • Safe to upgrade directly from v1.2.0

Summary

Haribon v1.3.0 improves system stability under load, strengthens observability guarantees, and makes logging and backend selection more resilient in production environments without introducing breaking changes.