feat: use Koa router name as span name if available

[lukiano]

Which problem is this PR solving?

• This allows to use the Koa router name (if available) as the span name. Usually this name is more meaningful than "method + path". In particular if the route name is the same as the OpenAPI's operationId for that route then it will be easier to associate spans with the OpenAPI spec.

Short description of the changes

• Koa will store the route name in _matchedRouteName. Note that I'm not using the format router - xxx as I'd rather have the span name clean.

Checklist

• Ran npm run test-all-versions for the edited package(s) on the latest commit if applicable.
  NPM failed to compile on the untouched main branch (some type errors related to React)

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: lukiano / name: Luciano Leggieri (97952aa)

[codecov]

Codecov Report

Merging #976 (81ac2c3) into main (a8c5c9f) will increase coverage by 0.28%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##             main     #976      +/-   ##
==========================================
+ Coverage   95.91%   96.20%   +0.28%     
==========================================
  Files          13       18       +5     
  Lines         856     1000     +144     
  Branches      178      203      +25     
==========================================
+ Hits          821      962     +141     
- Misses         35       38       +3     

Impacted Files	Coverage Δ
...ode/opentelemetry-instrumentation-koa/src/utils.ts	100.00% <100.00%> (ø)
...lemetry-instrumentation-koa/src/instrumentation.ts	97.18% <0.00%> (ø)
...tapackages/auto-instrumentations-node/src/utils.ts	98.00% <0.00%> (ø)
...ode/opentelemetry-instrumentation-koa/src/types.ts	100.00% <0.00%> (ø)
...ry-instrumentation-koa/src/enums/AttributeNames.ts	100.00% <0.00%> (ø)

[rauno56]

@lukiano, please sign the CLA.

[lukiano]

I've signed the CLA

[rauno56]

A named route refers to a route + a method so there's no way to use a named route with different methods?

1. The test should not be edited. Add another one for your usecase.
2. Nit: Your test says "insertOperation" even though it's a get operation for a post(not to mistaken for a POST method).
3. Current implementation already does gymnastics with naming the span, move your logic to where the name is calculated already. Do a else-if, for example.

Are you aware of the TAV/test-all-versions setup and how to run it?

API docs for Koa

[lukiano]

I'll work on these changes today. Sorry for the delay.

[lukiano]

I've addressed the feedback and ran tav

[rauno56]

Thanks and congrats about your first contribution, @lukiano!