Skip to content

HDDS-15586. Add freon command to read a user-supplied list of existing keys#10529

Open
greenwich wants to merge 1 commit into
apache:masterfrom
greenwich:HDDS-15586
Open

HDDS-15586. Add freon command to read a user-supplied list of existing keys#10529
greenwich wants to merge 1 commit into
apache:masterfrom
greenwich:HDDS-15586

Conversation

@greenwich

@greenwich greenwich commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

What changes were proposed in this pull request?

HDDS-15586 Add freon command to read a user-supplied list of existing keys

Discussed and supported on the community forum: #10460

There is no freon command that points at an arbitrary, heterogeneous set of existing keys (a real dataset already in a bucket) and measures read throughput. This is needed for read-path
performance and capacity/scaling work, where freshly generated uniform keys are page-cache-hot and not representative of production data.

Add a freon subcommand OzoneClientKeyListReader (ocklr) that:

  • takes --key-file <path> — a local file with one key name per line; blank lines and # comments ignored;
  • reuses BaseFreonGenerator — a warm shared OzoneClient, -t threads, -n total reads (task i reads keys[i % keys.size()], so -n loops the list), DropWizard timer;
  • per read calls bucket.readKey(key), drains the stream into a fixed buffer and counts bytes (no content/digest assumptions); reports the key-read timer plus an aggregate bytes/wall-time
    MB/s line.

What is the link to the Apache JIRA

https://issues.apache.org/jira/browse/HDDS-15586

How was this patch tested?

Unit tests are committed too.

@greenwich greenwich marked this pull request as ready for review June 17, 2026 02:42
@greenwich greenwich force-pushed the HDDS-15586 branch 2 times, most recently from b2fe16a to 735f9e2 Compare June 17, 2026 02:49
@greenwich greenwich changed the title Add freon command to read a user-supplied list of existing keys HDDS-15586 Add freon command to read a user-supplied list of existing keys Jun 17, 2026
@greenwich greenwich changed the title HDDS-15586 Add freon command to read a user-supplied list of existing keys HDDS-15586. Add freon command to read a user-supplied list of existing keys Jun 17, 2026
@adoroszlai adoroszlai requested a review from kerneltime June 18, 2026 10:57
@chungen0126 chungen0126 self-requested a review June 19, 2026 20:13
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