-
Notifications
You must be signed in to change notification settings - Fork 11
Conversation
2d7f6ab
to
18e6e01
Compare
Co-authored-by: Maria Craig <[email protected]>
3906: Add "scoring.*" analytics to multi search route r=Kerollmops a=dureuill # Pull Request ## Related issue Fixes meilisearch/specifications#252 (comment) by implementing (3): multi search now returns the "score.show_ranking_rule" and "score.show_ranking_rule_details" analytics. Co-authored-by: Louis Dureuil <[email protected]>
@@ -191,6 +191,8 @@ The collected data is sent to [Segment](https://segment.com/). Segment is a plat | |||
| `clear_all` | `true` if `DELETE /indexes/:indexUid/documents` endpoint was used in this batch, otherwise `false` | false | `Documents Deleted` | | |||
| vector_store | Whether the [vector store](./0193-experimental-features.md#vector-store) feature is enabled. | `true` | `Experimental features Updated` | | |||
| score_details | Whether the [score details](./0193-experimental-features.md#score-details) feature is enabled. | `true` | `Experimental features Updated` | | |||
| scoring.show_ranking_score | Was `showRankingScore` used in the aggregated event? If yes, `true`, otherwise `false` | `false` | `Documents Searched POST`, `Documents Searched GET`, `Documents Searched by Multi-Search POST` | | |||
| scoring.show_ranking_score_details | Was `showRankingScoreDetails` used in the aggregated event? If yes, `true`, otherwise `false` | `false` | `Documents Searched POST`, `Documents Searched GET`, `Documents Searched GET` | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| scoring.show_ranking_score_details | Was `showRankingScoreDetails` used in the aggregated event? If yes, `true`, otherwise `false` | `false` | `Documents Searched POST`, `Documents Searched GET`, `Documents Searched GET` | | |
| scoring.show_ranking_score_details | Was `showRankingScoreDetails` used in the aggregated event? If yes, `true`, otherwise `false` | `false` | `Documents Searched POST`, `Documents Searched GET`, `Documents Searched by Multi-Search POST` | |
🥅
The score is given by the following formula, assuming `n` ranking rules denoted from `0` to `n-1`: | ||
|
||
``` | ||
score = sum(i in 0..(n-1), (rank_i - 1) / product(j in 0..=i, max_rank_j)) + (rank_(n-1) / product(i in 0..n, max_rank_i)) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
}, | ||
"attribute": { | ||
"order": 3, | ||
"attributes_ranking_order": 0.8333333333333334, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should it be written attributesRankingOrder
to follow the camelCase field naming convention ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yea Louis was onto me today about this. It looks like the implementation is outputting it with underscores rather than camelCase so will need a change there first (and then an update here and in the blog post to make sure they are the same). I'll create an issue on the project as a start point.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Issue created here: meilisearch/meilisearch#3941
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Heya!
Here is the PR on Meilisearch fixing it https://github.com/meilisearch/meilisearch/pull/3949/files, however, there is a difference in the name chosen on Meilisearch side and in the spec:
attributeRankingOrderScore
vs attributesRankingOrder
and queryWordDistanceScore
and attributesQueryWordOrder
, which names should be chosen?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hey many 👋👶
attributeRankingOrderScore and queryWordDistanceScore
Relevant discussion (internal link)
"attribute": { | ||
"order": 3, | ||
"attributes_ranking_order": 0.8333333333333334, | ||
"attributes_query_word_order": 1, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
☝️
* Fix various typos * Fix wrongly tagged routes in open api * Telemetry policy * Add new error and api keys actions * Add experimental features and experimental feature API specs * Update open API * Score details (#252) * ranking score spec * search API changes * telemetry policies score * open api * Fix typos in spec Co-authored-by: Maria Craig <[email protected]> * Add multi search telemetry --------- Co-authored-by: Maria Craig <[email protected]> --------- Co-authored-by: Maria Craig <[email protected]>
properties: | ||
order: | ||
$ref: '#/components/schemas/order' | ||
attribute_ranking_order_score: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@dureuill @brunoocasali this attribute should be attributeRankingOrderScore
?
also query_word_distance_score
=> queryWordDistanceScore
🤖 API Diff Put the link of the GitHub comment generated by bump.sh if generated; Apply the
OpenApi
labelSummary
Specify the ranking score and ranking score details.
Specification for meilisearch/meilisearch#3771
Changes
Out Of Scope
N/A
Attention To Reviewers
experimental_features
branch rather than therelease-v1.3.0
branch. When merging, make sure to merge Experimental features #250 before this PR.Misc
OpenApi
label)Telemetry
label)