Skip to content

docs(helm): restore LMCache dashboard explanation in Observability section#982

Merged
ruizhang0101 merged 2 commits into
vllm-project:mainfrom
samhoss93:docs/lmcache-dashboard-explanation
Jun 25, 2026
Merged

docs(helm): restore LMCache dashboard explanation in Observability section#982
ruizhang0101 merged 2 commits into
vllm-project:mainfrom
samhoss93:docs/lmcache-dashboard-explanation

Conversation

@samhoss93

Copy link
Copy Markdown
Contributor

What

Adds back a short explanation of the LMCache dashboard's six fields to helm/README.md's Observability section.

Why

The old observability/README.md documented this under "Import LMCache Dashboard," and is now deprecated with a banner pointing readers to helm/README.md#observability for the same content. During the monitoring refactor in #860, the dashboard itself (helm/dashboards/lmcache-dashboard.json) moved into the chart and is now auto-provisioned via helm/templates/dashboards.yaml — a real improvement, no more manual kubectl apply step. But the explanation of what the dashboard actually shows didn't make the move over, so the deprecation banner currently points to a section that doesn't have it.

This PR only adds the explanatory text (adapted to note it's auto-provisioned now). It intentionally drops the old manual kubectl apply/restart commands from the original doc, since those are obsolete now that the chart handles provisioning.

Scope

Single doc change, no code/behavior change.

@gemini-code-assist gemini-code-assist Bot left a comment

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.

Code Review

This pull request updates the Helm documentation in helm/README.md to include a new section about the LMCache Dashboard, describing its automatic provisioning and the metrics it displays. Feedback was provided to improve the readability and grammar of the newly added text, specifically suggesting minor phrasing adjustments to make the documentation more natural.

Comment thread helm/README.md Outdated
Comment on lines +462 to +464
### LMCache Dashboard

If you use the LMCache image in production stack, the chart includes a dedicated LMCache dashboard (provisioned automatically alongside the main vLLM dashboard when `grafanaDashboards.enabled: true`). It contains six fields showing the benefits of CPU offloading: Average time to first token (sec), Cache hit rate (%) in last 1 minute, LMCache retrieve speed (K Tokens / sec), Local CPU cache usage (GB), Number of requested tokens in total, and Number of hit tokens in total.

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.

medium

The sentence can be improved for better readability and grammatical correctness. Specifically, "in production stack" should be "in the production stack", and "when grafanaDashboards.enabled: true" can be phrased more naturally as "when grafanaDashboards.enabled is set to true".

Suggested change
### LMCache Dashboard
If you use the LMCache image in production stack, the chart includes a dedicated LMCache dashboard (provisioned automatically alongside the main vLLM dashboard when `grafanaDashboards.enabled: true`). It contains six fields showing the benefits of CPU offloading: Average time to first token (sec), Cache hit rate (%) in last 1 minute, LMCache retrieve speed (K Tokens / sec), Local CPU cache usage (GB), Number of requested tokens in total, and Number of hit tokens in total.
### LMCache Dashboard
If you use the LMCache image in the production stack, the chart includes a dedicated LMCache dashboard (provisioned automatically alongside the main vLLM dashboard when `grafanaDashboards.enabled` is set to `true`). It contains six fields showing the benefits of CPU offloading: Average time to first token (sec), Cache hit rate (%) in last 1 minute, LMCache retrieve speed (K Tokens / sec), Local CPU cache usage (GB), Number of requested tokens in total, and Number of hit tokens in total.

…ction

The LMCache dashboard's six fields were documented in the old
observability/README.md, which is now deprecated and points readers to
helm/README.md#observability for this content. That content never
made it over during the helm chart monitoring refactor (vllm-project#860), even
though the dashboard itself is still shipped and auto-provisioned via
helm/templates/dashboards.yaml.

Signed-off-by: Sam <samhoss93@gmail.com>
@samhoss93 samhoss93 force-pushed the docs/lmcache-dashboard-explanation branch from f336e46 to a4b997c Compare June 24, 2026 02:48

@ruizhang0101 ruizhang0101 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

LGTM

@ruizhang0101 ruizhang0101 merged commit 094289c into vllm-project:main Jun 25, 2026
8 checks passed
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