DOC-11498 Docs for obs: Support workload-level index recommendations and insights

[florence-crl]

Fixes DOC-11498

In insights.md include file, (1) added workload_index_recs function section and (2) updated the img tags to use files in v25.2 directory.

Rendered previews:

• workload_index_recs function

[github-actions]

Files changed:

• src/current/_includes/v25.2/ui/insights.md:
• src/current/v25.2/ui-insights-page.md

[netlify]

✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name	Link
🔨 Latest commit	2477277
🔍 Latest deploy log	https://app.netlify.com/sites/cockroachdb-interactivetutorials-docs/deploys/681d1989ae7e6400082521e1

[netlify]

✅ Deploy Preview for cockroachdb-api-docs canceled.

Name	Link
🔨 Latest commit	2477277
🔍 Latest deploy log	https://app.netlify.com/sites/cockroachdb-api-docs/deploys/681d19893037b100080e9430

[netlify]

✅ Netlify Preview

Name	Link
🔨 Latest commit	2477277
🔍 Latest deploy log	https://app.netlify.com/sites/cockroachdb-docs/deploys/681d19893adc06000868ad61
😎 Deploy Preview	https://deploy-preview-19569--cockroachdb-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[kevin-v-ngo]

Hi @florence-crl, looks great and love the example joining with statement_statistics so that users can view the query text.

Can we add a description on the time window of the workload over which we look for index recommendations? The default behavior including allowing users to flexibly specifying a timestamp.

@kyle-a-wong, can you confirm the default behavior? If i recall, we take all the statements in statement_statistics. And if a timestamp is specified we filter and only consider those the statements after the timestamp.

[kyle-a-wong]

Hi @florence-crl, looks great and love the example joining with statement_statistics so that users can view the query text.

Can we add a description on the time window of the workload over which we look for index recommendations? The default behavior including allowing users to flexibly specifying a timestamp.

@kyle-a-wong, can you confirm the default behavior? If i recall, we take all the statements in statement_statistics. And if a timestamp is specified we filter and only consider those the statements after the timestamp.

@kevin-v-ngo yes, the default behavior will return index_recommendations sourced from all statements in statement_statistics. Providing a time stamp, such as select workload_index_rec('2025-05-5') will only provide workload index recs that come after 2025-05-5 00:00:00

[florence-crl]

@kevin-v-ngo and @kyle-a-wong I added TIMESTAMPTZ parameter info. Please review again. thanks!