[Instrumentation.EntityFrameworkCore] Add Filter public API to enable filtering

[akoken]

Changes

This PR introduces the addition of a Filter public API, which enables filtering out activities based on the properties of the
IDbCommand object being executed. The Filter API provides users with the ability to apply custom filters to only collect specific activities, enhancing the flexibility and versatility of the system.

For significant contributions please make sure you have completed the following items:

• Appropriate CHANGELOG.md updated for non-trivial changes
• Design discussion issue #
• Changes in public API reviewed

[linux-foundation-easycla]

The committers listed above are authorized under a signed CLA.

• ✅ login: akoken / name: Abdurrahman Alp Köken (3949354, c80c1a1, 3913b90, bc23dff, 44b8282)
• ✅ login: Kielek / name: Piotr Kiełkowicz (c89bfd0, 1030309, c3d50ec)

[Kielek]

Did you considered usingEnrichWithIDbCommand? It should allow you to modify activity in context of IDbCommand.

[akoken]

Yes, we can modify activity with EnrichWithIDbCommand, but I don't think it's a right place to do that. Encrich and Filter should have their own purpose.

[Kielek]

@akoken, I have checked it internally with other maintainers.

Please consider following Filter option Func<string, IDbCommand, bool> instead of Func<IDbCommand, bool>.

The string parameter could be potentially providerName.

@utpilla, @alanwest FYI

EDIT: markdown list is failing - probably to long lines.

[akoken]

@Kielek, I added providerName to the filter function and fixed the markdown issues.

[codecov]

Codecov Report

Merging #1203 (1030309) into main (dbfeaea) will decrease coverage by 0.68%.
The diff coverage is 54.54%.

❗ Current head 1030309 differs from pull request most recent head c3d50ec. Consider uploading reports for the commit c3d50ec to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1203      +/-   ##
==========================================
- Coverage   73.61%   72.93%   -0.68%     
==========================================
  Files         265      265              
  Lines        9346     9301      -45     
==========================================
- Hits         6880     6784      -96     
- Misses       2466     2517      +51     

Impacted Files	Coverage Δ
...ry.Exporter.Geneva/Metrics/GenevaMetricExporter.cs	70.03% <ø> (-4.52%)	⬇️
...ation/EntityFrameworkInstrumentationEventSource.cs	12.00% <28.57%> (+12.00%)	⬆️
...mplementation/EntityFrameworkDiagnosticListener.cs	52.38% <64.28%> (+1.48%)	⬆️
...eworkCore/EntityFrameworkInstrumentationOptions.cs	100.00% <100.00%> (ø)

... and 1 file with indirect coverage changes