Skip to content

Update monitor-built-in-alerting.md - #23929

Open
huoyao1125 wants to merge 3 commits into
release-8.5from
huoyao1125-patch-2
Open

huoyao1125 wants to merge 3 commits into
release-8.5from
huoyao1125-patch-2

Conversation

@huoyao1125

@huoyao1125 huoyao1125 commented Sep 22, 2026

Copy link
Copy Markdown
Collaborator

What is changed, added, or deleted? (Required)

Adds 3 new rows to the "Performance overview alerts" table (applies to Essential and Premium plans): the new Query Latency Count Threshold alert conditions that fire when more than N SQL statements exceed 256 ms / 512 ms / 4096 ms within 1 minute. Also fixes a trailing-whitespace formatting issue on the "Performance overview alerts" heading.

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

  • master (the latest development version)
  • v9.0 (TiDB 9.0 versions)
  • v8.5 (TiDB 8.5 versions)
  • v8.1 (TiDB 8.1 versions)
  • v7.5 (TiDB 7.5 versions)
  • v7.1 (TiDB 7.1 versions)
  • v6.5 (TiDB 6.5 versions)

What is the related PR or file link(s)?

  • Related code change PR links (if applicable): tidbcloud/runbooks#2802
  • This PR is translated from:
  • Other reference link(s):

AI agent involvement

  • The changes in this PR were primarily made by an AI agent on behalf of the PR author.

Do your changes match any of the following descriptions?

  • Delete files
  • Change aliases
  • Need modification after applied to another branch
  • Might cause conflicts after applied to another branch

Summary by CodeRabbit

  • Documentation
    • Added three premium-plan performance overview alerts for more than 20 SQL statements exceeding 256 ms, 512 ms, or 4096 ms within one minute.
    • Added guidance to review schemas and indexes, inspect slow queries, and contact TiDB Cloud Support when issues persist.
    • Organized performance overview alerts into separate premium and essential sections.
    • Updated essential-plan changefeed alerts so they no longer include premium-plan coverage.

@ti-chi-bot

ti-chi-bot Bot commented Sep 22, 2026

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign qiancai for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@ti-chi-bot ti-chi-bot Bot added missing-translation-status This PR does not have translation status info. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Sep 22, 2026
@coderabbitai

coderabbitai Bot commented Sep 22, 2026

Copy link
Copy Markdown

Review in Change Stack →

Navigate logical layers of code changes, visualize relationships, and explore their blast radius.

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Repository: pingcap/docs/.coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: b3582677-ad52-4547-b08b-b4b0a4733466

📥 Commits

Reviewing files that changed from the base of the PR and between 2eadf5a and 29ca6b4.

📒 Files selected for processing (1)
  • tidb-cloud/monitor-built-in-alerting.md

Included review availability: Your plan provides up to 4 included reviews per hour; 3 remain after this review.


📝 Walkthrough

Walkthrough

The alerting documentation separates Premium and Essential alert sections. It adds three Premium SQL-duration alerts with troubleshooting and support guidance.

Changes

Alerting documentation

Layer / File(s) Summary
Separate plan-specific alert conditions
tidb-cloud/monitor-built-in-alerting.md
The document adds Premium alerts for more than 20 statements exceeding 256 ms, 512 ms, or 4096 ms within one minute. It limits the performance and changefeed sections to Essential plans. Each Premium alert includes schema, index, slow-query, and TiDB Cloud Support guidance.

Priority: ⬇️ Low

Estimated code review effort: 1 (Trivial) | ~3 minutes

Change: Other

Merge Risk: 🔵 Low · up to 29ca6

The page adds performance alerts that are not listed in the monitoring overview, which may make them harder for users to discover and understand.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly identifies the documentation file being updated and matches the pull request changes.
Description check ✅ Passed The description includes the required change summary, affected TiDB version, related PR link, AI involvement declaration, and change-type checklist.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches 💡 1
🛠️ Fix failing CI checks 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Commit to this branch
  • Create a new PR

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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 1


ℹ️ Review info
⚙️ Run configuration

Configuration used: Repository: pingcap/docs/.coderabbit.yaml

Review profile: ASSERTIVE

Plan: Advanced

Run ID: fbef8e0e-05f4-4db9-af61-7adb66b43c3b

📥 Commits

Reviewing files that changed from the base of the PR and between fda7251 and 2eadf5a.

📒 Files selected for processing (1)
  • tidb-cloud/monitor-built-in-alerting.md

Included review availability: Your plan provides up to 4 included reviews per hour; 2 remain after this review.

Comment thread tidb-cloud/monitor-built-in-alerting.md Outdated
Comment on lines +138 to +140
| More than 20 SQL statements exceeded 256 ms within 1 minute | This is an early-warning signal based on latency metrics. Because TiDB's slow log only records queries that exceed 300 ms by default, not every counted query is guaranteed to have a matching entry in the slow query list. <ol><li>Check for recent schema or index changes.</li><li>Review the slow query list in the TiDB Cloud console. It might take several minutes for the corresponding slow query records to appear.</li></ol><br/>If you cannot identify the root cause, contact [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md).|
| More than 20 SQL statements exceeded 512 ms within 1 minute | <ol><li>Check for recent schema or index changes.</li><li>Review the slow query list in the TiDB Cloud console. It might take several minutes for the corresponding slow query records to appear.</li></ol><br/>If you cannot identify the root cause, contact [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md).|
| More than 20 SQL statements exceeded 4096 ms within 1 minute | <ol><li>Check for recent schema or index changes.</li><li>Review the slow query list in the TiDB Cloud console. It might take several minutes for the corresponding slow query records to appear.</li></ol><br/>If you cannot identify the root cause, contact [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md).|

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

🔎 Supported by static analysis

🏁 Script executed:

sed -n '20,45p' tidb-cloud/monitoring-concepts.md
printf '\n--- detailed alerting page ---\n'
sed -n '110,150p' tidb-cloud/monitor-built-in-alerting.md
printf '\n--- related category references ---\n'
rg -n -i 'performance overview alerts|resource usage|data migration|changefeed alerts|built-in alert' tidb-cloud/monitoring-concepts.md tidb-cloud/monitor-built-in-alerting.md

Repository: pingcap/docs

Length of output: 16101


Keep the built-in alert overview consistent.

monitoring-concepts.md says TiDB Cloud provides only three alert types, but this page documents a separate Performance overview alerts category. Update the overview to include this category, with its plan scope, or reclassify this section if it is not a separate built-in alert type.

🧰 Tools
🪛 GitHub Check: vale

[failure] 138-138:
[vale] reported by reviewdog 🐶
[PingCAP.LyHyphens] ' early-' doesn't need a hyphen.

Raw Output:
{"message":"[PingCAP.LyHyphens] ' early-' doesn't need a hyphen.","location":{"path":"tidb-cloud/monitor-built-in-alerting.md","range":{"start":{"line":138,"column":75},"end":{"line":138,"column":82}}},"severity":"ERROR","code":{"value":"PingCAP.LyHyphens","url":"https://developers.google.com/style/hyphens"}}

@ti-chi-bot ti-chi-bot Bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Sep 22, 2026
@ti-chi-bot

ti-chi-bot Bot commented Sep 22, 2026

Copy link
Copy Markdown

@huoyao1125: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
pull-verify 29ca6b4 link true /test pull-verify

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

missing-translation-status This PR does not have translation status info. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant