Skip to content
This repository has been archived by the owner on Mar 21, 2024. It is now read-only.

Document the latest metrics improvements #242

Merged
merged 9 commits into from
Jul 31, 2023
Merged

Document the latest metrics improvements #242

Changes from 1 commit
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
45630fa
document the latest metrics improvements
irevoire May 30, 2023
daf56bc
Update text/0174-metrics-api.md
irevoire May 31, 2023
f3b6638
Update text/0174-metrics-api.md
irevoire May 31, 2023
b2b0ff1
adds some details on the meilisearch_db_size metrics
irevoire May 31, 2023
efd96f1
update the open api metrics smaple
irevoire Jun 1, 2023
912820f
update a bad copy paste
irevoire Jun 1, 2023
12ba8f8
Update open-api.yaml
gmourier Jun 26, 2023
dfc7fac
prefix prometheus metrics by meilisearch_
gmourier Jul 7, 2023
3e9d541
Introduce two new metrics
Kerollmops Jul 19, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 43 additions & 13 deletions text/0174-metrics-api.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,15 +33,17 @@ A metric is composed by several fields:

Meilisearch returns the metrics specified in the table below.

| Name | Type |
|---------------------------------------------------------------------------|-----------|
| [`http_requests_total`](#321-http_requests_total) | counter |
| [`http_response_time_seconds`](#322-http_response_time_seconds) | histogram |
| [`meilisearch_database_size_bytes`](#323-meilisearch_database_size_bytes) | gauge |
| [`meilisearch_index_docs_count`](#324-meilisearch_index_docs_count) | gauge |
| [`meilisearch_index_count`](#325-meilisearch_index_count) | gauge |

#### 3.2.1 `http_requests_total`
| Name | Type |
|----------------------------------------------------------------------------------------|-----------|
| [`meilisearch_http_requests_total`](#321-meilisearch_http_requests_total) | counter |
| [`meilisearch_http_response_time_seconds`](#322-meilisearch_http_response_time_seconds)| histogram |
| [`meilisearch_db_size_bytes`](#323-meilisearch_db_size_bytes) | gauge |
| [`meilisearch_used_db_size_bytes`](#324-meilisearch_used_db_size_bytes) | gauge |
| [`meilisearch_index_docs_count`](#325-meilisearch_index_docs_count) | gauge |
| [`meilisearch_index_count`](#326-meilisearch_index_count) | gauge |
| [`meilisearch_nb_tasks`](#327-meilisearch_nb_tasks) | counter |

#### 3.2.1 `meilisearch_http_requests_total`

Returns the number of times an API resource is accessed.

Expand All @@ -51,7 +53,7 @@ Returns the number of times an API resource is accessed.
http_requests_total{method=":httpMethod",path=":resourcePath"} :numberOfRequest
irevoire marked this conversation as resolved.
Show resolved Hide resolved
```

#### 3.2.2. `http_responses_time_seconds`
#### 3.2.2. `meilisearch_http_response_time_seconds`

Returns a time histogram showing the number of times an API resource call goes into a time bucket (expressed in second).

Expand All @@ -77,7 +79,7 @@ http_response_time_seconds_sum{method=":httpMethod",path=":resourcePath"} :numbe
http_response_time_seconds_count{method=":httpMethod",path=":resourcePath"} :numberOfRequest
irevoire marked this conversation as resolved.
Show resolved Hide resolved
```

#### 3.2.3. `meilisearch_database_size_bytes`
#### 3.2.3. `meilisearch_db_size_bytes`

Returns the size of the database in bytes.
irevoire marked this conversation as resolved.
Show resolved Hide resolved

Expand All @@ -87,7 +89,17 @@ Returns the size of the database in bytes.
meilisearch_db_size_bytes :databaseSizeInBytes
```

#### 3.2.4. `meilisearch_index_docs_count`
#### 3.2.4. `meilisearch_used_db_size_bytes`

Returns the size of the database actually used by meilisearch in bytes.

```
# HELP meilisearch_used_db_size_bytes Meilisearch Used DB Size In Bytes
# TYPE meilisearch_used_db_size_bytes gauge
meilisearch_used_db_size_bytes :databaseSizeInBytes
```

#### 3.2.5. `meilisearch_index_docs_count`

Returns the number of documents for an index.

Expand All @@ -97,7 +109,7 @@ Returns the number of documents for an index.
meilisearch_index_docs_count{index=":indexUid"} :numberOfDocuments
```

#### 3.2.5. `meilisearch_index_count`
#### 3.2.6. `meilisearch_index_count`

Returns the total number of index for the Meilisearch instance.

Expand All @@ -107,6 +119,24 @@ Returns the total number of index for the Meilisearch instance.
meilisearch_index_count :numberOfIndex
````

#### 3.2.7. `meilisearch_nb_tasks`

Returns the total number of index for the Meilisearch instance.
irevoire marked this conversation as resolved.
Show resolved Hide resolved

```
# HELP meilisearch_nb_tasks Meilisearch Number of tasks
# TYPE meilisearch_nb_tasks gauge
meilisearch_nb_tasks{kind=":kind",value=":value"} :number
````

Here is a list of available kind and associated values:

| Kind | values |
|-----------|------------------------------------------------------------------------|
| indexes | Any created indexes |
| statuses | Any task statuses (i.e.: succeeded, failed, enqueued, etc...) |
| types | Any task types (i.e.: documentAdditionOrUpdate, settingsUpdate, etc...)|

### 3.3. API Endpoints Definition

#### 3.3.1. `GET` - `/metrics`
Expand Down