157 lines
2.9 KiB
Markdown
157 lines
2.9 KiB
Markdown
---
|
|
stage: Systems
|
|
group: Distribution
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
|
|
---
|
|
|
|
# Sidekiq Metrics API **(FREE SELF)**
|
|
|
|
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.
|
|
|
|
```plaintext
|
|
GET /sidekiq/queue_metrics
|
|
```
|
|
|
|
```shell
|
|
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/queue_metrics"
|
|
```
|
|
|
|
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.
|
|
|
|
```plaintext
|
|
GET /sidekiq/process_metrics
|
|
```
|
|
|
|
```shell
|
|
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/process_metrics"
|
|
```
|
|
|
|
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.
|
|
|
|
```plaintext
|
|
GET /sidekiq/job_stats
|
|
```
|
|
|
|
```shell
|
|
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/job_stats"
|
|
```
|
|
|
|
Example response:
|
|
|
|
```json
|
|
{
|
|
"jobs": {
|
|
"processed": 2,
|
|
"failed": 0,
|
|
"enqueued": 0,
|
|
"dead": 0
|
|
}
|
|
}
|
|
```
|
|
|
|
## Get a compound response of all the previously mentioned metrics
|
|
|
|
List all the currently available information about Sidekiq.
|
|
|
|
```plaintext
|
|
GET /sidekiq/compound_metrics
|
|
```
|
|
|
|
```shell
|
|
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/sidekiq/compound_metrics"
|
|
```
|
|
|
|
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,
|
|
"enqueued": 0,
|
|
"dead": 0
|
|
}
|
|
}
|
|
```
|