add parser recursion and lexical token metrics

[jhrldev]

Adds two new metrics: apollo.router.operations.recursion for the number of recursion level reached, and apollo.router.operations.lexical_tokens for the number of lexical tokens in a query.

---

Checklist

Complete the checklist (and note appropriate exceptions) before the PR is marked ready-for-review.

• PR description explains the motivation for the change and relevant context for reviewing
• PR description links appropriate GitHub/Jira tickets (creating when necessary)
• Changeset is included for user-facing changes
• Changes are compatible¹
• Documentation² completed
• Performance impact assessed and acceptable
• Metrics and logs are added³ and documented
• Tests added and passing⁴
  • Unit tests
  • Integration tests
  • Manual tests, as necessary

Exceptions

Note any exceptions here

Notes

Footnotes

1. It may be appropriate to bring upcoming changes to the attention of other (impacted) groups. Please endeavour to do this before seeking PR approval. The mechanism for doing this will vary considerably, so use your judgement as to how and when to do this. ↩

2. Configuration is an important part of many changes. Where applicable please try to document configuration examples. ↩

3. A lot of (if not most) features benefit from built-in observability and debug-level logs. Please read this guidance on metrics best-practices. ↩

4. Tick whichever testing boxes are applicable. If you are adding Manual Tests, please document the manual testing (extensively) in the Exceptions. ↩

[apollo-cla]

@jhrldev: Thank you for submitting a pull request! Before we can merge it, you'll need to sign the Apollo Contributor License Agreement here: https://contribute.apollographql.com/

[apollo-librarian]

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 1 changed, 0 removed

* graphos/routing/(latest)/observability/router-telemetry-otel/enabling-telemetry/standard-instruments.mdx

Build ID: c7e7c301981c8ea591d909b1
Build Logs: View logs

URL: https://www.apollographql.com/docs/deploy-preview/c7e7c301981c8ea591d909b1

[carodewig]

Thanks for this PR, @jhrldev! I have some suggestions but am excited to see these metrics added.

[rohan-b99]

Implementation looks good to me, I think we just need a changeset (cargo xtask changeset create)

[aaronArinder]

✅ histograms
✅ using allow-listed ingress name (apollo.router.operations.*)
✅ low-cardinality tags on ^ ($$$)

nice work! don't forget the changeset (if you do, no worries, it can be added after)!

stale

[abernix]

@jhrldev I would recommend doing the changeset inside the PR. it makes backporting/cherry-picking easier if there is a single commit / no follow-up PR. My suggestion is to write an initial message and then apply our style guide edits to it using Claude/Copilot/Glean, and commit that within the context of this PR.

[carodewig]

I think we should add these metrics to the docs as well (probably docs/source/routing/observability/router-telemetry-otel/enabling-telemetry/standard-instruments.mdx)

[pragl]

Docs LGTM!

[abernix]

If we don't get docs review in time, we can admin overide through given the simplicity of the addition.

Ha. @pragl is too fast.

dismissing stale request