Skip to content

AIP-97: document the infra-refund config and failure_kind listener use - #18

Draft
1fanwang wants to merge 1 commit into
aip97-p3-infra-refundfrom
aip97-docs
Draft

AIP-97: document the infra-refund config and failure_kind listener use#18
1fanwang wants to merge 1 commit into
aip97-p3-infra-refundfrom
aip97-docs

Conversation

@1fanwang

@1fanwang 1fanwang commented Jul 25, 2026

Copy link
Copy Markdown
Owner

Author-facing docs for AIP-97, stacked on the refund PR (#13).

What

  • Documents the two [core] options added by the refund path: infra_failure_refund_retries (opt-in) and max_infra_refunds (the cap). They now appear in the generated config reference instead of living only as code fallbacks.
  • Updates the listener failure-cause example to route on failure_kind: record an infrastructure disruption as capacity churn for metrics and dashboards, and page on-call for a real failure. Teams that already build Dag and task lifecycle tracking on these listeners get a field that separates infrastructure churn from application bugs.

Testing

conf reads the new defaults at runtime: max_infra_refunds is 3, and infra_failure_refund_retries is False. config.yml parses, and both entries are well formed. The listener change is a docs example.

@coderabbitai

coderabbitai Bot commented Jul 25, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: b9dc6c77-c10b-4d8e-836e-3f169d414e9f

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch aip97-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Adds the two [core] options the refund path introduces (infra_failure_refund_retries
and max_infra_refunds) to config.yml so they appear in the config reference, and
extends the listener failure-cause example to route on failure_kind: record an
infrastructure disruption as capacity churn for metrics and dashboards, page on-call
for a real failure.

Signed-off-by: 1fanwang <1fannnw@gmail.com>
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.

1 participant