Skip to content

feat(benchmarks): make busybox image configurable via BUSYBOX_IMAGE env var#98

Open
k-wall wants to merge 3 commits into
SamBarker:feat/omb-kafka-metricsfrom
k-wall:feat/configurable-busybox-image
Open

feat(benchmarks): make busybox image configurable via BUSYBOX_IMAGE env var#98
k-wall wants to merge 3 commits into
SamBarker:feat/omb-kafka-metricsfrom
k-wall:feat/configurable-busybox-image

Conversation

@k-wall
Copy link
Copy Markdown

@k-wall k-wall commented May 19, 2026

Summary

Makes the busybox image used by result collection pods configurable via the BUSYBOX_IMAGE environment variable, allowing users to avoid Docker Hub rate limits by using alternative registries.

Problem

During testing on OpenShift, result collection failed due to Docker Hub rate limiting:

Failed to pull image "busybox:1.37.0@sha256:...": 
toomanyrequests: You have reached your unauthenticated pull rate limit

The busybox image was hardcoded in two places:

  • run-benchmark.sh - OMB results reader pod (collects result.json from PVC)
  • collect-results.sh - JFR debug pod (collects JFR recordings from PVC)

This blocked test completion even though the actual benchmark ran successfully and metrics were collected.

Solution

Added BUSYBOX_IMAGE environment variable to both scripts with sensible defaults:

BUSYBOX_IMAGE="${BUSYBOX_IMAGE:-busybox:1.37.0@sha256:b3255e7dfbcd10cb367af0d409747d511aeb66dfac98cf30e97e87e4207dd76f}"

Users can now override to use alternative registries:

Quay.io (Red Hat):

BUSYBOX_IMAGE="quay.io/quay/busybox:latest" ./scripts/run-benchmark.sh ...

GHCR (GitHub Container Registry):

BUSYBOX_IMAGE="ghcr.io/dockerhub-mirror/busybox:latest" ./scripts/run-benchmark.sh ...

Benefits

  • Avoids Docker Hub rate limits in CI/testing environments
  • Better for OpenShift/Red Hat environments (quay.io has better connectivity)
  • Air-gapped support - users can point to local mirrors
  • Backward compatible - defaults to existing docker.io image

Documentation

Added to Environment section in both scripts' usage:

BUSYBOX_IMAGE    Busybox image for result collection pods (default: docker.io busybox:1.37.0)

Testing

Verified on OpenShift with:

  • BUSYBOX_IMAGE="quay.io/quay/busybox:latest" - successfully avoided rate limits
  • Default (no override) - maintains existing behavior

🤖 Generated with Claude Code

SamBarker and others added 3 commits May 15, 2026 20:41
When kafka.metrics.enabled=true in the Helm values (e.g. via
cluster-overrides.yaml), Strimzi deploys a JMX Prometheus exporter
sidecar on each Kafka broker pod. Metrics are exposed on port 9404.

Adds poll-kafka-metrics.sh, which port-forwards to a broker pod and
polls /metrics every METRICS_INTERVAL seconds, writing timestamped
snapshots to kafka-metrics.txt in the probe output directory. If the
endpoint is not available (metrics disabled), the script exits cleanly
after 15 s so the benchmark is not disrupted.

Wires the kafka metrics poller into run-benchmark.sh alongside the
existing proxy metrics poller — started before the benchmark and stopped
after it completes.

The captured metrics enable direct observation of Kafka-side
bottlenecks during connection sweeps:
- kafka_server_requesthandlerpool_requesthandleravagidle (near 0 = I/O
  thread pool saturated)
- kafka_network_socketserver_networkprocessoravagidle (network threads)
- kafka_server_brokertopicmetrics_bytesin/outpersec_rate (throughput)
- kafka_server_replicamanager_isrshrinks_rate (replication lag)
- kafka_network_requestmetrics_totaltimems_produce (produce latency)

Assisted-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Signed-off-by: Sam Barker <sam@quadrocket.co.uk>
…nv var

The result collection pods use busybox to mount PVCs and copy files.
Previously the image was hardcoded to docker.io busybox:1.37.0, which
can hit Docker Hub rate limits in CI/testing environments.

Added BUSYBOX_IMAGE environment variable to both scripts:
- run-benchmark.sh: for OMB results collection pod
- collect-results.sh: for JFR debug pod

Default remains docker.io busybox:1.37.0 for backward compatibility.
Users can now override to use alternative registries:
  BUSYBOX_IMAGE="quay.io/quay/busybox:latest" ./scripts/run-benchmark.sh ...

This is particularly useful for:
- OpenShift/Red Hat environments (quay.io has better connectivity)
- CI environments hitting Docker Hub rate limits
- Air-gapped environments with local mirrors

Assisted-by: Claude Sonnet 4.5 <noreply@anthropic.com>
Signed-off-by: Keith Wall <kwall@apache.org>
@SamBarker SamBarker force-pushed the feat/omb-kafka-metrics branch from 3b17c62 to d1d36cf Compare May 20, 2026 01:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants