mirror of
https://github.com/qdrant/qdrant.git
synced 2026-07-31 23:20:52 -05:00
112df0ae18
* Refactor: Convert app and cluster info metrics from counters to gauges - Change app_info, app_status_recovery_mode, and cluster_enabled metrics from COUNTER to GAUGE - Update metric values to use boolean as f64 for consistency and clarity - Improve metric type accuracy for better representation of state information * fix: Update docs regarding metrics type * openapi: Update app_info metric type * metrics: Update test to check for the right metric type
179 lines
5.0 KiB
YAML
179 lines
5.0 KiB
YAML
#@ load("openapi.lib.yml", "response", "reference", "type", "array")
|
|
|
|
paths:
|
|
/:
|
|
get:
|
|
summary: Returns information about the running Qdrant instance
|
|
description: Returns information about the running Qdrant instance like version and commit id
|
|
operationId: root
|
|
tags:
|
|
- service
|
|
responses:
|
|
"200":
|
|
description: Qdrant server version information
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: "#/components/schemas/VersionInfo"
|
|
"4XX":
|
|
description: error
|
|
|
|
/telemetry:
|
|
get:
|
|
summary: Collect telemetry data
|
|
description: Collect telemetry data including app info, system info, collections info, cluster info, configs and statistics
|
|
operationId: telemetry
|
|
tags:
|
|
- service
|
|
parameters:
|
|
- name: anonymize
|
|
in: query
|
|
description: "If true, anonymize result"
|
|
required: false
|
|
schema:
|
|
type: boolean
|
|
responses: #@ response(reference("TelemetryData"))
|
|
|
|
/metrics:
|
|
get:
|
|
summary: Collect Prometheus metrics data
|
|
description: Collect metrics data including app info, collections info, cluster info and statistics
|
|
operationId: metrics
|
|
tags:
|
|
- service
|
|
parameters:
|
|
- name: anonymize
|
|
in: query
|
|
description: "If true, anonymize result"
|
|
required: false
|
|
schema:
|
|
type: boolean
|
|
responses:
|
|
"200":
|
|
description: Metrics data in Prometheus format
|
|
content:
|
|
text/plain:
|
|
schema:
|
|
type: string
|
|
example: |
|
|
# HELP app_info information about qdrant server
|
|
# TYPE app_info gauge
|
|
app_info{name="qdrant",version="0.11.1"} 1
|
|
# HELP cluster_enabled is cluster support enabled
|
|
# TYPE cluster_enabled gauge
|
|
cluster_enabled 0
|
|
# HELP collections_total number of collections
|
|
# TYPE collections_total gauge
|
|
collections_total 1
|
|
"4XX":
|
|
description: error
|
|
|
|
/locks:
|
|
post:
|
|
summary: Set lock options
|
|
description: Set lock options. If write is locked, all write operations and collection creation are forbidden. Returns previous lock options
|
|
operationId: post_locks
|
|
tags:
|
|
- service
|
|
requestBody:
|
|
description: Lock options and optional error message
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: "#/components/schemas/LocksOption"
|
|
responses: #@ response(reference("LocksOption"))
|
|
|
|
get:
|
|
summary: Get lock options
|
|
description: Get lock options. If write is locked, all write operations and collection creation are forbidden
|
|
operationId: get_locks
|
|
tags:
|
|
- service
|
|
responses: #@ response(reference("LocksOption"))
|
|
|
|
/healthz:
|
|
get:
|
|
summary: Kubernetes healthz endpoint
|
|
description: An endpoint for health checking used in Kubernetes.
|
|
operationId: healthz
|
|
tags:
|
|
- service
|
|
responses:
|
|
"200":
|
|
description: Healthz response
|
|
content:
|
|
text/plain:
|
|
schema:
|
|
type: string
|
|
example: healthz check passed
|
|
"4XX":
|
|
description: error
|
|
|
|
/livez:
|
|
get:
|
|
summary: Kubernetes livez endpoint
|
|
description: An endpoint for health checking used in Kubernetes.
|
|
operationId: livez
|
|
tags:
|
|
- service
|
|
responses:
|
|
"200":
|
|
description: Healthz response
|
|
content:
|
|
text/plain:
|
|
schema:
|
|
type: string
|
|
example: healthz check passed
|
|
"4XX":
|
|
description: error
|
|
|
|
/readyz:
|
|
get:
|
|
summary: Kubernetes readyz endpoint
|
|
description: An endpoint for health checking used in Kubernetes.
|
|
operationId: readyz
|
|
tags:
|
|
- service
|
|
responses:
|
|
"200":
|
|
description: Healthz response
|
|
content:
|
|
text/plain:
|
|
schema:
|
|
type: string
|
|
example: healthz check passed
|
|
"4XX":
|
|
description: error
|
|
|
|
/issues:
|
|
get:
|
|
summary: Get issues
|
|
description: Get a report of performance issues and configuration suggestions
|
|
operationId: get_issues
|
|
tags:
|
|
- beta
|
|
responses:
|
|
"200":
|
|
description: Successful response
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: object
|
|
"4XX":
|
|
description: error
|
|
delete:
|
|
summary: Clear issues
|
|
description: Removes all issues reported so far
|
|
operationId: clear_issues
|
|
tags:
|
|
- beta
|
|
responses:
|
|
"200":
|
|
description: Successful response
|
|
content:
|
|
application/json:
|
|
schema:
|
|
type: boolean
|
|
"4XX":
|
|
description: error
|