Can match phase coordinator duration APM metric

[chrisparrinello]

Add a new APM metric to measure the duration of the can-match phase at the coordinator:

• es.search_response.took_durations.can_match.histogram

[elasticsearchmachine]

Pinging @elastic/es-search-foundations (Team:Search Foundations)

[elasticsearchmachine]

Hi @chrisparrinello, I've created a changelog YAML for you.

[github-actions]

🔍 Preview links for changed docs

• docs/reference/query-languages/esql/esql-use-cases.md
• docs/reference/query-languages/esql/kibana/docs/functions/percentile_over_time.md
• docs/reference/elasticsearch/mapping-reference/pattern-text.md
• docs/reference/elasticsearch/mapping-reference/semantic-text.md
• docs/reference/enrich-processor/normalize-for-stream.md
• docs/reference/query-languages/esql/kibana/docs/functions/clamp.md
• docs/reference/query-languages/esql/kibana/docs/functions/clamp_max.md
• docs/reference/query-languages/esql/limitations.md

[github-actions]

ℹ️ Important: Docs version tagging

👋 Thanks for updating the docs! Just a friendly reminder that our docs are now cumulative. This means all 9.x versions are documented on the same page and published off of the main branch, instead of creating separate pages for each minor version.

We use applies_to tags to mark version-specific features and changes.

Expand for a quick overview

When to use applies_to tags:

✅ At the page level to indicate which products/deployments the content applies to (mandatory)
✅ When features change state (e.g. preview, ga) in a specific version
✅ When availability differs across deployments and environments

What NOT to do:

❌ Don't remove or replace information that applies to an older version
❌ Don't add new information that applies to a specific version without an applies_to tag
❌ Don't forget that applies_to tags can be used at the page, section, and inline level

🤔 Need help?

• Check out the cumulative docs guidelines
• Reach out in the #docs Slack channel

[javanna]

left a couple of nits on testing, LGTM otherwise

[javanna]

could you use a more realistic index filter? For instance a date range query instead? I was also wondering if setting the index filter is required for this test to work.

[chrisparrinello]

I changed it to a more complicated test. For this test to have two runs of can-match, we need to make sure we have at least two shards remaining after the open PIT can match. We have to have and index filter on the open PIT for can-match to run during that operation.