debian-mirror-gitlab/doc/api/sidekiq_metrics.md

154 lines
2.7 KiB
Markdown
Raw Normal View History

2020-11-24 15:15:51 +05:30
# Sidekiq Metrics API **(CORE ONLY)**
2016-06-22 15:30:34 +05:30
2020-10-24 23:57:45 +05:30
> Introduced in GitLab 8.9.
2016-06-22 15:30:34 +05:30
This API endpoint allows you to retrieve some information about the current state
of Sidekiq, its jobs, queues, and processes.
## Get the current Queue Metrics
List information about all the registered queues, their backlog and their
latency.
2020-04-08 14:13:33 +05:30
```plaintext
2016-06-22 15:30:34 +05:30
GET /sidekiq/queue_metrics
```
2020-03-13 15:44:24 +05:30
```shell
2020-06-23 00:09:42 +05:30
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/queue_metrics"
2016-06-22 15:30:34 +05:30
```
Example response:
```json
{
"queues": {
"default": {
"backlog": 0,
"latency": 0
}
}
}
```
## Get the current Process Metrics
List information about all the Sidekiq workers registered to process your queues.
2020-04-08 14:13:33 +05:30
```plaintext
2016-06-22 15:30:34 +05:30
GET /sidekiq/process_metrics
```
2020-03-13 15:44:24 +05:30
```shell
2020-06-23 00:09:42 +05:30
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/process_metrics"
2016-06-22 15:30:34 +05:30
```
Example response:
```json
{
"processes": [
{
"hostname": "gitlab.example.com",
"pid": 5649,
"tag": "gitlab",
"started_at": "2016-06-14T10:45:07.159-05:00",
"queues": [
"post_receive",
"mailers",
"archive_repo",
"system_hook",
"project_web_hook",
"gitlab_shell",
"incoming_email",
"runner",
"common",
"default"
],
"labels": [],
"concurrency": 25,
"busy": 0
}
]
}
```
## Get the current Job Statistics
List information about the jobs that Sidekiq has performed.
2020-04-08 14:13:33 +05:30
```plaintext
2016-06-22 15:30:34 +05:30
GET /sidekiq/job_stats
```
2020-03-13 15:44:24 +05:30
```shell
2020-06-23 00:09:42 +05:30
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/job_stats"
2016-06-22 15:30:34 +05:30
```
Example response:
```json
{
"jobs": {
"processed": 2,
"failed": 0,
2019-12-26 22:10:19 +05:30
"enqueued": 0,
"dead": 0
2016-06-22 15:30:34 +05:30
}
}
```
## Get a compound response of all the previously mentioned metrics
List all the currently available information about Sidekiq.
2020-04-08 14:13:33 +05:30
```plaintext
2016-06-22 15:30:34 +05:30
GET /sidekiq/compound_metrics
```
2020-03-13 15:44:24 +05:30
```shell
2020-06-23 00:09:42 +05:30
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/compound_metrics"
2016-06-22 15:30:34 +05:30
```
Example response:
```json
{
"queues": {
"default": {
"backlog": 0,
"latency": 0
}
},
"processes": [
{
"hostname": "gitlab.example.com",
"pid": 5649,
"tag": "gitlab",
"started_at": "2016-06-14T10:45:07.159-05:00",
"queues": [
"post_receive",
"mailers",
"archive_repo",
"system_hook",
"project_web_hook",
"gitlab_shell",
"incoming_email",
"runner",
"common",
"default"
],
"labels": [],
"concurrency": 25,
"busy": 0
}
],
"jobs": {
"processed": 2,
"failed": 0,
2019-12-26 22:10:19 +05:30
"enqueued": 0,
"dead": 0
2016-06-22 15:30:34 +05:30
}
}
```