Skip to content

Improvement/bb 605 alert for ingestion processing - #2821

Open
benzekrimaha wants to merge 4 commits into
development/9.6from
improvement/BB-605-alert-for-ingestion-processing
Open

benzekrimaha wants to merge 4 commits into
development/9.6from
improvement/BB-605-alert-for-ingestion-processing

Conversation

@benzekrimaha

Copy link
Copy Markdown
Contributor

Issue: BB-605

@codecov

codecov Bot commented Aug 20, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 75.98%. Comparing base (09d85b1) to head (0c452ac).

Additional details and impacted files

Impacted file tree graph
see 4 files with indirect coverage changes

Components Coverage Δ
Bucket Notification 80.25% <ø> (ø)
Core Library 82.60% <ø> (-0.24%) ⬇️
Ingestion 75.65% <ø> (ø)
Lifecycle 81.25% <ø> (ø)
Oplog Populator 85.80% <ø> (ø)
Replication 63.72% <ø> (-0.04%) ⬇️
Bucket Scanner 85.76% <ø> (ø)
@@                 Coverage Diff                 @@
##           development/9.6    #2821      +/-   ##
===================================================
- Coverage            76.09%   75.98%   -0.11%     
===================================================
  Files                  206      206              
  Lines                14426    14426              
===================================================
- Hits                 10977    10962      -15     
- Misses                3439     3454      +15     
  Partials                10       10              
Flag Coverage Δ
api:retry 9.20% <ø> (ø)
api:routes 8.97% <ø> (ø)
bucket-scanner 85.76% <ø> (ø)
ft_test:queuepopulator 9.73% <ø> (ø)
ingestion 12.74% <ø> (ø)
lib 8.96% <ø> (-0.02%) ⬇️
lifecycle 19.14% <ø> (-0.01%) ⬇️
notification 0.98% <ø> (ø)
oplogPopulator 0.13% <ø> (ø)
replication 18.77% <ø> (-0.11%) ⬇️
unit 57.61% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@benzekrimaha
benzekrimaha force-pushed the improvement/BB-846-retry-ingestion-reader-setup branch from bd6999f to 2f9c7f5 Compare August 20, 2026 13:15
@benzekrimaha
benzekrimaha force-pushed the improvement/BB-605-alert-for-ingestion-processing branch from 0e20eb4 to a682dd2 Compare August 20, 2026 13:16
@benzekrimaha
benzekrimaha force-pushed the improvement/BB-846-retry-ingestion-reader-setup branch 3 times, most recently from 570a524 to 24f4b57 Compare September 8, 2026 07:35
@francoisferrand
francoisferrand force-pushed the improvement/BB-846-retry-ingestion-reader-setup branch 2 times, most recently from bf0d146 to 4a35f25 Compare September 9, 2026 15:42
Base automatically changed from improvement/BB-846-retry-ingestion-reader-setup to development/9.6 September 9, 2026 15:57
@bert-e

bert-e commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Hello benzekrimaha,

My role is to assist you with the merge of this
pull request. Please type @bert-e help to get information
on this process, or consult the user documentation.

Available options
name description privileged authored
/after_pull_request Wait for the given pull request id to be merged before continuing with the current one.
/bypass_author_approval Bypass the pull request author's approval
/bypass_build_status Bypass the build and test status
/bypass_commit_size Bypass the check on the size of the changeset TBA
/bypass_incompatible_branch Bypass the check on the source branch prefix
/bypass_jira_check Bypass the Jira issue check
/bypass_peer_approval Bypass the pull request peers' approval
/bypass_leader_approval Bypass the pull request leaders' approval
/bypass_source_branch_lineage Bypass the cross-branch contamination check
/approve Instruct Bert-E that the author has approved the pull request. ✍️
/create_pull_requests Allow the creation of integration pull requests.
/create_integration_branches Allow the creation of integration branches.
/no_octopus Prevent Wall-E from doing any octopus merge and use multiple consecutive merge instead
/unanimity Change review acceptance criteria from one reviewer at least to all reviewers
/wait Instruct Bert-E not to run until further notice.
Available commands
name description privileged
/help Print Bert-E's manual in the pull request.
/status Print Bert-E's current status in the pull request.
/clear Remove all comments from Bert-E from the history TBA
/retry Re-start a fresh build TBA
/build Re-start a fresh build TBA
/force_reset Delete integration branches & pull requests, and restart merge process from the beginning.
/reset Try to remove integration branches unless there are commits on them which do not appear on the source branch.

Status report is not available.

@bert-e

bert-e commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Incorrect fix version

The Fix Version/s in issue BB-605 contains:

  • 8.6.58

Considering where you are trying to merge, I ignored possible hotfix versions and I expected to find:

  • 9.6.0

Please check the Fix Version/s of BB-605, or the target
branch of this pull request.

@benzekrimaha
benzekrimaha marked this pull request as ready for review September 11, 2026 07:54

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this branch is on top of an outdated (merged) branch

  • appears to include 4 commits, which do not belong in this branch
  • the changes are unrelated
  • the branch conflicts with upstream

→ rebase before asking for review

Comment on lines +114 to +115
description: "Ingestion producer has been unable to start reading from a source for the last 10 minutes, so the objects of that location are not ingested. Check the producer logs for the bucket it fails to resolve."
summary: "Ingestion producer cannot start reading from a source"

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
description: "Ingestion producer has been unable to start reading from a source for the last 10 minutes, so the objects of that location are not ingested. Check the producer logs for the bucket it fails to resolve."
summary: "Ingestion producer cannot start reading from a source"
description: "Ingestion producer has been unable to read from a source for the last 10 minutes, so the objects of that location are not ingested. Check the producer logs for the bucket it fails to resolve."
summary: "Ingestion producer cannot read from a source"

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did not take “read”: this alert is getRaftId, i.e. reader setup, not a journal read. I Worded it as “cannot set up a source” so it does not collide with getRaftLog

# alerts above stay far below their threshold when a single source is stuck.
- alert: IngestionProducerSourceSetupFailing
Expr: |
sum(rate(s3_ingestion_source_operations_total{op="getRaftId", status="error", namespace="${namespace}", job="${job_ingestion_producer}"}[5m]))

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should we sum by bucket or location? So the alert points to the specific bucket/location which does not work?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not possible today. s3_ingestion_source_operations_total only has origin, op, status. No bucket and no location sum by would be empty and locationNameRaftID exists on the journal gauges, not on this counter. We can add a locationName label, but it would apply to every source op (getRaftLog, metadata, …), not only getRaftId. I would keep this alert cluster-wide for now and add the label in a follow-up if we want the firing alert to name the location.

# be resolved fails continuously. It is a handful of errors against the reads
# of every healthy source, so it only shows up on the absolute rate: the ratio
# alerts above stay far below their threshold when a single source is stuck.
- alert: IngestionProducerSourceSetupFailing

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this alert is a sub-class of the previous one (IngestionProducerSourceErrorRate5Percent) :

  • Why does it not report issues? Is this because of the threshold, or because one location's error may be lost in the other location's success, or because other calls are incorrectly reducing the ratio?
  • Should we adjust the threshold instead? Or skip some ops which are not relevant to the alert? Or sum by bucket/location?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For me it is the aggregation. A stuck source retries getRaftId every few seconds and those errors are drowned by getRaftLog successes from healthy sources. Lowering the ratio would noisy-alert on read errors and filtering the existing ratio to op="getRaftId" would fire, but then “error rate 5%” would mean setup failure...
The dedicated absolute rate on getRaftId, with for: 10m, is the smallest change that names this failure mode in my opinion

Both rules of the source error rate pair were named
IngestionProducerSourceErrorRate3Percent, so the critical one could not
be told apart from the warning one. Name it after the threshold it uses,
as the zookeeper and publish error rate pairs already do.

Issue: BB-605
A source whose setup fails is now retried on every cron tick, so it
reports a getRaftId error roughly every five seconds for as long as it
cannot be resolved, while its location ingests nothing. Nothing reports
it today: the journal size and read offset gauges of that source are
never published, so the lag and NoMessagesQueued alerts stay blind, and
the error ratio alerts drown the failures in the reads of every healthy
source, which are orders of magnitude more frequent.

Alert on the absolute rate of getRaftId errors instead, which is only
called to set a reader up. Ten minutes of sustained failures are needed
to fire, so a source that recovers on its own, typically while its
location restarts, does not alert.

Issue: BB-605
The ingestion alerts were the only ones shipped without a rendering and
unit test step, so a rule could be published broken or silent.

Cover the new setup failure alert: it fires on a source that keeps
failing, stays silent on one that recovers, and the ratio alerts are
asserted silent on the same series to pin down why it is needed.

Issue: BB-605
getRaftId is reader setup. Calling it a read failure would collide
with getRaftLog.

Issue: BB-605
@benzekrimaha
benzekrimaha force-pushed the improvement/BB-605-alert-for-ingestion-processing branch from a682dd2 to 0c452ac Compare September 16, 2026 06:47
@bert-e

bert-e commented Sep 16, 2026

Copy link
Copy Markdown
Contributor

Waiting for approval

The following approvals are needed before I can proceed with the merge:

  • the author

  • 2 peers

The following reviewers are expecting changes from the author, or must review again:

@scality scality deleted a comment from bert-e Sep 16, 2026
@benzekrimaha

Copy link
Copy Markdown
Contributor Author

Assigning @DarkIsDude for review since Mael is on PTO

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.

4 participants