Skip to content

docs: fix prometheus plugin documentation#13275

Open
Yilialinn wants to merge 4 commits intoapache:masterfrom
Yilialinn:docs/update-prometheus
Open

docs: fix prometheus plugin documentation#13275
Yilialinn wants to merge 4 commits intoapache:masterfrom
Yilialinn:docs/update-prometheus

Conversation

@Yilialinn
Copy link
Copy Markdown
Contributor

Summary

  • Fix prefer_name attribute Required field (blank → False) and Default value (Falsefalse) in EN and ZH
  • Add CPU caution note to the "Expose APISIX Metrics on Public API Endpoint" section explaining that the privileged agent optimization is bypassed when using public-api Plugin (EN + ZH)
  • Fix broken code examples: restore missing "uri" field in the "Add Extra Labels" route creation and missing "id" field in the "Monitor TCP/UDP" stream route creation (EN)
  • Add missing "id" field in stream route creation example (ZH)
  • Fix incorrect internal link to public-api plugin (../../../en/latest/plugins/public-api.md./public-api.md) in EN and ZH
  • Translate mixed-language LLM metrics label section headers to Chinese (ZH)

- Fix prefer_name attribute Required field (blank → False) and
  Default value (False → false) in EN and ZH
- Add CPU caution note to 'Expose Metrics on Public API' section (EN+ZH)
- Fix broken code examples: restore missing uri field in route creation
  and missing id field in stream_route creation (EN)
- Add missing id field in stream_route creation example (ZH)
- Fix internal link to public-api plugin (../../.. → ./) in EN+ZH
- Translate mixed-language LLM metrics label section headers to ZH
@dosubot dosubot Bot added size:M This PR changes 30-99 lines, ignoring generated files. doc Documentation things labels Apr 21, 2026
@Yilialinn Yilialinn requested a review from Copilot April 22, 2026 06:37
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates Prometheus plugin documentation (EN/ZH) to correct schema metadata, fix internal links and JSON examples, and add guidance about CPU impact when exposing metrics via the public listener.

Changes:

  • Correct prefer_name attribute table fields (Required/Default) in EN and ZH.
  • Fix broken documentation links and route/stream route example payloads (missing uri / id).
  • Add a CPU caution note to the “Expose APISIX Metrics on Public API Endpoint” section (EN/ZH).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
docs/en/latest/plugins/prometheus.md Fixes prefer_name table fields, adds caution note, corrects public-api link, and repairs example payloads (uri/id).
docs/zh/latest/plugins/prometheus.md Fixes prefer_name default formatting, translates LLM metrics label headings, adds caution note, corrects public-api link, and adds missing stream route id.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/en/latest/plugins/prometheus.md Outdated
Comment thread docs/zh/latest/plugins/prometheus.md Outdated
Comment thread docs/zh/latest/plugins/prometheus.md Outdated
Yilialinn and others added 3 commits April 22, 2026 17:16
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@Yilialinn Yilialinn requested a review from kayx23 April 22, 2026 09:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Documentation things size:M This PR changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants