---
title: "Collect telemetry data"
method: GET
path: "/telemetry"
tags: ["Service"]
---

# Collect telemetry data

`GET /telemetry`

Collect telemetry data including app info, system info, collections info, cluster info, configs and statistics

## Query parameters

- `anonymize` boolean
- `details_level` integer
- `per_collection` boolean
- `timeout` integer

## Response `200`

successful operation

- object
  - `usage` union
    - Usage — Usage of the hardware resources, spent to process the request
      - `hardware` union
        - HardwareUsage — Usage of the hardware resources, spent to process the request
          - `cpu` integer, required
          - `payload_io_read` integer, required
          - `payload_io_write` integer, required
          - `payload_index_io_read` integer, required
          - `payload_index_io_write` integer, required
          - `vector_io_read` integer, required
          - `vector_io_write` integer, required
        - unknown
      - `inference` union
        - InferenceUsage
          - `models` object, required
        - unknown
    - unknown
  - `time` number, float — Time spent to process this request
  - `status` string
  - `result` TelemetryData
    - `id` string, required
    - `app` union
      - AppBuildTelemetry
        - `name` string, required
        - `version` string, required
        - `features` union
          - AppFeaturesTelemetry
            - `debug` boolean, required
            - `service_debug_feature` boolean, required
            - `recovery_mode` boolean, required
            - `gpu` boolean, required
            - `rocksdb` boolean, required
            - `staging` boolean, required
          - unknown
        - `runtime_features` union
          - FeatureFlags
            - `all` boolean — Magic feature flag that enables all features. Note that this will only be applied to all flags when passed into [`init_feature_flags`].
            - `incremental_hnsw_building` boolean — Use incremental HNSW building. Enabled by default in Qdrant 1.14.1.
            - `appendable_quantization` boolean — Use appendable quantization in appendable plain segments. Enabled by default in Qdrant 1.16.0.
            - `single_file_mmap_vector_storage` boolean — Use single-file mmap in-ram vector storage (InRamMmap) Enabled by default in Qdrant 1.17.1+
          - unknown
        - `low_memory_mode` union
          - union — Controls how segments are loaded on startup to reduce memory pressure. Configured via `storage.low_memory_mode` in the configuration file. This setting only affects *loading* — it never modifies the persisted configuration of any segment. The same data directory will behave differently depending on how this mode is set at startup, which makes it safe to toggle for recovery from out-of-memory crash loops.
            - 'disabled' — No special handling. Every component loads as persisted.
            - 'no_resident' — Load RAM-friendly components as their on-disk variants where possible: * Quantization is loaded as if `always_ram = false`. * Payload field indexes are loaded as if `on_disk = true`. * Payload storage is loaded as the mmap variant (lazy populate).
            - 'no_populate' — Same as [`LowMemoryMode::NoResident`], plus mmap page population is skipped on load (for original vectors, HNSW graph and payload storage).
          - unknown
        - `hnsw_global_config` union
          - HnswGlobalConfig
            - `healing_threshold` number, double — Enable HNSW healing if the ratio of missing points is no more than this value. To disable healing completely, set this value to `0.0`.
          - unknown
        - `system` union
          - RunningEnvironmentTelemetry
            - `distribution` string, nullable
            - `distribution_version` string, nullable
            - `is_docker` boolean, required
            - `cores` integer, nullable
            - `cpu_cores_used` number, float, nullable — Average number of CPU cores used by this process over roughly the last two seconds. `None` on unsupported platforms, before two samples are collected, or on transient failures reading process CPU time.
            - `ram_size` integer, nullable
            - `disk_size` integer, nullable
            - `cpu_flags` string, required
            - `cpu_endian` union
              - …
            - `gpu_devices` GpuDeviceTelemetry[], nullable
              - …
          - unknown
        - `jwt_rbac` boolean, nullable
        - `hide_jwt_dashboard` boolean, nullable
        - `audit` union
          - AuditTelemetry
            - `dir` string, required
            - `rotation` string, required
            - `max_log_files` integer, required
            - `trust_forwarded_headers` boolean, required
            - `log_api` boolean, required
            - `dir_size_bytes` integer, nullable
          - unknown
        - `startup` string, date-time, required
      - unknown
    - `collections` CollectionsTelemetry, required
      - `number_of_collections` integer, required
      - `max_collections` integer, nullable
      - `collections` CollectionTelemetryEnum[], nullable
        - union
          - CollectionTelemetry
            - `id` string, required
            - `init_time_ms` integer, nullable
            - `config` union
              - …
            - `shards` ReplicaSetTelemetry[], nullable
              - …
            - `transfers` ShardTransferInfo[], nullable
              - …
            - `resharding` ReshardingInfo[], nullable
              - …
            - `shard_clean_tasks` object, nullable
          - CollectionsAggregatedTelemetry
            - `vectors` integer, required
            - `optimizers_status` union, required — Current state of the collection
              - …
            - `params` CollectionParams, required
              - …
      - `snapshots` CollectionSnapshotTelemetry[], nullable
        - `id` string, required
        - `running_snapshots` integer, nullable
        - `running_snapshot_recovery` integer, nullable
        - `total_snapshot_creations` integer, nullable
    - `cluster` union
      - ClusterTelemetry
        - `enabled` boolean, required
        - `status` union
          - ClusterStatusTelemetry
            - `number_of_peers` integer, required
            - `term` integer, required
            - `commit` integer, required
            - `pending_operations` integer, required
            - `role` union
              - …
            - `is_voter` boolean, required
            - `peer_id` integer, nullable
            - `consensus_thread_status` union, required — Information about current consensus thread status
              - …
          - unknown
        - `config` union
          - ClusterConfigTelemetry
            - `grpc_timeout_ms` integer, required
            - `p2p` P2pConfigTelemetry, required
              - …
            - `consensus` ConsensusConfigTelemetry, required
              - …
          - unknown
        - `peers` object, nullable
        - `peer_metadata` object, nullable
        - `metadata` object, nullable
        - `resharding_enabled` boolean, nullable
      - unknown
    - `requests` union
      - RequestsTelemetry
        - `rest` WebApiTelemetry, required
          - `responses` object, required
          - `per_collection_responses` object
        - `grpc` GrpcTelemetry, required
          - `responses` object, required
          - `per_collection_responses` object
      - unknown
    - `memory` union
      - MemoryTelemetry
        - `active_bytes` integer, required — Total number of bytes in active pages allocated by the application
        - `allocated_bytes` integer, required — Total number of bytes allocated by the application
        - `metadata_bytes` integer, required — Total number of bytes dedicated to metadata
        - `resident_bytes` integer, required — Maximum number of bytes in physically resident data pages mapped
        - `retained_bytes` integer, required — Total number of bytes in virtual memory mappings
      - unknown
    - `hardware` union
      - HardwareTelemetry
        - `collection_data` object, required
      - unknown
    - `search_pool` union
      - SearchThreadPoolTelemetry — Live snapshot of the adaptive search routing. `mode` is the runtime currently selected by [`SearchMode`]; `high_cpu_threads` and `high_io_threads` are the blocking-thread budgets of the two underlying runtimes that the adaptive handle routes between.
        - `mode` string, required — Currently active mode (`high_cpu` or `high_io`).
        - `high_cpu_threads` integer, required — Blocking-thread count of the high-CPU runtime.
        - `high_io_threads` integer, required — Blocking-thread count of the high-IO runtime.
      - unknown

## Other responses

- `default` — error
- `4XX` — error

## Changes

- **2026-05-20** `945e62a0043c` — 5 breaking, 8 warning, 23 info
  - the response property `result/collections/collections/items/anyOf[#/components/schemas/CollectionTelemetry]/config/anyOf[#/components/schemas/CollectionConfigTelemetry]/optimizer_config/deleted_threshold` became optional for the status `200`
  - the response property `result/collections/collections/items/anyOf[#/components/schemas/CollectionTelemetry]/config/anyOf[#/components/schemas/CollectionConfigTelemetry]/optimizer_config/vacuum_min_vector_number` became optional for the status `200`
  - the `result/collections/collections/items/anyOf[#/components/schemas/CollectionTelemetry]/config/anyOf[#/components/schemas/CollectionConfigTelemetry]/strict_mode_config/anyOf[#/components/schemas/StrictModeConfigOutput]/max_query_limit` response property's min was decreased from `1.00` to `0.00` for the response status `200`
  - the `result/collections/collections/items/anyOf[#/components/schemas/CollectionTelemetry]/config/anyOf[#/components/schemas/CollectionConfigTelemetry]/strict_mode_config/anyOf[#/components/schemas/StrictModeConfigOutput]/max_timeout` response property's min was decreased from `1.00` to `0.00` for the response status `200`
  - …32 more
- …earlier changes not shown

[Full history](https://skmtc.dev/qdrant/apis/qdrant-api/changes/telemetry/get.md)

---

[API](https://skmtc.dev/qdrant/apis/qdrant-api.md) · [All operations](https://skmtc.dev/qdrant/apis/qdrant-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qdrant/qdrant-api/revisions/eaea4a3ae8ab/schema)
