---
schema: rendered-html/v1
title: "Operations with Specific Telemetry data | Developer Portal for YouTrack and Hub Documentation"
source_url: https://www.jetbrains.com/help/youtrack/devportal/operations-api-admin-telemetry.html
generated_at: 2026-06-11T15:05:17.332704+00:00
---

Feedback

Thanks for your feedback!

Was this page helpful?

YesNo

Developer Portal for YouTrack and Hub

- Developer Portal
- Apps
- MCP Tools
- YouTrack Workflows
- YouTrack Import Scripts
- YouTrack Form API
- YouTrack REST API
- Get Started with REST API
- REST API Reference
- Entities
- Resources
- Activity Items
- Issue Activities Page
- Build Bundles
- Enum Bundles
- Owned Bundles
- State Bundles
- User Bundles
- Version Bundles
- Custom Fields
- Field Types
- Backup Files
- Database Backup Settings
- Global Settings
- Organizations
- Projects
- Telemetry data
- [Operations with Specific Telemetry data](operations-api-admin-telemetry.html)
- Global Time Tracking Settings
- Agiles
- Articles
- Assigned Roles
- Commands
- Command Suggestions
- User Groups
- Issue Link Types
- Issue Tag
- Issues
- Issue Count
- Permissions
- Roles
- Saved Queries
- Search Suggestions
- Tags
- Users
- My User Profile
- Issue Work Items
- REST API Use Cases
- REST API Troubleshooting
- Color Indices List
- Hub REST API

1. YouTrack REST API
2. REST API Reference
3. Resources
4. Telemetry data
5. [Operations with Specific Telemetry data](#0)

# Operations with Specific Telemetry data﻿

Last modified: 24 March 2026

This resource lets you get telemetry data of your YouTrack service.

| Resource | ``` /api/admin/telemetry ``` |
| --- | --- |
| Returned entity | Telemetry. For the description of the entity attributes, see [Supported Fields](/help/youtrack/devportal/operations-api-admin-telemetry.html#Telemetry-supported-fields) section. |
| Supported methods | - `GET`: [Telemetry data](/help/youtrack/devportal/operations-api-admin-telemetry.html#get-Telemetry-method). |

## Telemetry attributes﻿

Telemetry data of the YouTrack installation.

### Related Resources﻿

Below you can find the list of resources that let you work with this entity.

- Telemetry Data

### Attributes﻿

This table describes attributes of the `Telemetry` entity.

- To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.
- To update an attribute, provide it in the body of a POST request.

| Field | Type | Description |
| --- | --- | --- |
| id | String | The ID of the Telemetry. `Read-only`. |
| installationFolder | String | Installation folder of YouTrack. `Read-only`. `Can be null`. |
| databaseLocation | String | Location of the YouTrack database. `Read-only`. `Can be null`. |
| logsLocation | String | Location of the logs. `Read-only`. `Can be null`. |
| availableProcessors | Int | Number of available processors. `Read-only`. `Can be null`. |
| availableMemory | String | Available memory. `Read-only`. `Can be null`. |
| allocatedMemory | String | Allocated memory. `Read-only`. `Can be null`. |
| usedMemory | String | Used memory. `Read-only`. `Can be null`. |
| uptime | String | Uptime of the YouTrack application. `Read-only`. |
| startedTime | Long | The timestamp in milliseconds indicating the moment when YouTrack was started. Stored as a unix timestamp at UTC. `Read-only`. |
| databaseBackgroundThreads | Int | Number of database background threads. `Read-only`. |
| pendingAsyncJobs | Int | Number of pending asynchronous jobs. `Read-only`. |
| cachedResultsCountInDBQueriesCache | Int | Size of the database queries cache. `Read-only`. |
| databaseQueriesCacheHitRate | String | Queries cache hit rate. `Read-only`. |
| blobStringsCacheHitRate | String | Blobs cache hit rate. `Read-only`. |
| totalTransactions | Long | Number of transactions. `Read-only`. |
| transactionsPerSecond | String | Number of transactions per second. `Read-only`. |
| requestsPerSecond | String | Number of requests per second. `Read-only`. |
| databaseSize | String | Size of the database (without blobs). `Read-only`. |
| fullDatabaseSize | String | Full size of the database. `Read-only`. |
| textIndexSize | String | Size of the text index. `Read-only`. |
| onlineUsers | OnlineUsers | Online users. `Read-only`. |
| reportCalculatorThreads | Int | Number of report calculator threads. `Read-only`. |
| notificationAnalyzerThreads | Int | Number of notification analyzer threads. `Read-only`. |

## Get Telemetry Data﻿

Read available telemetry data of the YouTrack service. Please note that the list of returned attributes depends on whether you use on-premise or InCloud edition. For attributes that are unsupported, YouTrack returns `null`.

### Required permissions﻿

Requires permissions: Low-level Admin Read

### Request syntax﻿

GET /api/admin/telemetry?{fields}

| null | The database ID of Telemetry |
| --- | --- |

### Request parameters﻿

| Parameter | Type | Description |
| --- | --- | --- |
| fields | String | A list of Telemetry attributes that should be returned in the response. If no field is specified, only the `entityID` is returned. |

### Sample﻿

#### Sample request﻿

https://example.youtrack.cloud/api/admin/telemetry?fields=databaseSize,uptime,startedTime,textIndexSize

#### Sample response body﻿

{
  "startedTime": 1610613083628,
  "databaseSize": "5.0 MB",
  "textIndexSize": "0.1 MB",
  "uptime": "644 hours, 19 minutes, 10 seconds and 121 milliseconds",
  "$type": "Telemetry"
}

- [Operations with Specific Telemetry data](/help/youtrack/devportal/operations-api-admin-telemetry.html)
- [Telemetry attributes](/help/youtrack/devportal/operations-api-admin-telemetry.html#Telemetry-supported-fields)
- [Get Telemetry Data](/help/youtrack/devportal/operations-api-admin-telemetry.html#get-Telemetry-method)

Telemetry dataGlobal Time Tracking Settings

- Privacy & Security
- Terms Of Use
- Trademarks
- Legal

Copyright © 2000–2026 JetBrains s.r.o.

![](https://bat.bing.com/action/0?ti=5220035&tm=gtm002&Ver=2&mid=baf35af9-a708-4e42-8499-ddccc7050e7a&bo=4&sid=452929b065a111f19a7fe7356f74a419&vid=aa3122f0648711f1a10d6d095e10fd87&vids=0&msclkid=N&pi=918639831&lg=en-US&sw=1920&sh=1080&sc=24&tl=Operations%20with%20Specific%20Telemetry%20data%20%7C%20Developer%20Portal%20for%20YouTrack%20and%20Hub%20Documentation&p=https%3A%2F%2Fwww.jetbrains.com%2Fhelp%2Fyoutrack%2Fdevportal%2Foperations-api-admin-telemetry.html&r=&lt=572&pt=1781190314740,50,50,,,1,1,1,1,1,,2,27,27,55,225,225,225,571,572,572&pn=0,0&evt=pageLoad&sv=2&asc=G&cdb=AQAS&rn=756656)

![](https://crawler.prototype.prolicht.digital/l/B6otwd)![](https://crawler.prototype.prolicht.digital/l/rE1AUr)
