Telemetry
Directus collects usage data from each installation. This helps the team understand how often Directus is installed, which versions are in use, and the general size and shape of projects so development can be prioritized accordingly.
Most of the report is aggregate counts and true/false flags. Two fields identify your instance: your public URL (url, taken from PUBLIC_URL) and a generated project identifier (project_id). Beyond those, the report never includes your content, schema names, user details, or secrets. This page documents every value that is collected so you can see precisely what leaves your instance.
What Directus Collects
Each report contains the following fields, and nothing else.
Instance and Environment
| Field | What it is |
|---|---|
url | Your project's public URL (the value of PUBLIC_URL). On licensed instances, this is the same URL used for license activation and project binding. |
version | The Directus version in use. |
database | The database vendor in use (for example pg or mysql), not its contents or connection details. |
project_id | A random identifier generated for your project. It is not derived from any personal or project data. |
database_size | Total size of the database in bytes. |
files_size_total | Combined size of stored files in bytes. |
websockets_enabled | Whether WebSockets are enabled. |
Content and Schema Counts
| Field | What it is |
|---|---|
collections | Number of user-created collections. |
items | Total number of items across all non-system collections. |
fields_total | Total number of fields across all collections. |
fields_max | The largest number of fields in any single collection. |
files | Number of files in the system. |
Users and Access
| Field | What it is |
|---|---|
admin_users | Number of users with admin access. |
app_users | Number of users who can access the app but are not admins. |
api_users | Number of users who can only access the API. |
roles | Number of roles. |
shares | Number of shares. |
Features in Use
| Field | What it is |
|---|---|
flows | Number of active flows. |
dashboards | Number of dashboards. |
extensions | Number of installed extensions. |
visual_editor_urls | Number of configured Visual Editor URLs. |
collaborative_editing_enabled | Whether collaborative editing is enabled. |
mcp_enabled | Whether the MCP server is enabled. |
mcp_allow_deletes | Whether MCP is permitted to perform deletes. |
mcp_system_prompt_enabled | Whether a custom MCP system prompt is enabled. |
ai_openai_api_key | Whether an OpenAI API key is configured (true/false only, never the key itself). |
ai_anthropic_api_key | Whether an Anthropic API key is configured (true/false only, never the key itself). |
ai_system_prompt | Whether a custom AI system prompt is set (true/false only, never the prompt itself). |
API Request Volume
The report includes API request counts for the current reporting window, broken down by HTTP method (GET, POST, PATCH, and so on) along with the number of requests served from cache. These are aggregate counts only, with no information about the requests themselves, and are reset to zero after each report is sent.
What Directus Does Not Collect
The report is intentionally limited to the fields listed above. It does not include:
- Item or content data of any kind.
- Collection names, field names, or field values.
- File contents or file names.
- User names, email addresses, passwords, or any other personal data.
- API keys, tokens, secrets, or system prompts. Where a key or prompt is referenced above, only a
true/falsevalue indicating whether it is configured is sent. - The values of your environment variables.
When and Where Reports Are Sent
Directus generates a report shortly after startup, following a random delay of up to 30 minutes, and then sends one every 6 hours.
Reports are sent to the URL defined by the TELEMETRY_URL variable, which defaults to https://telemetry.directus.io.
Disabling Telemetry
To opt out, set the TELEMETRY environment variable to false and restart Directus.
TELEMETRY setting is ignored. To check whether yours allows it, review your entitlements under Settings → License in the Studio.Get once-a-month release notes & real‑world code tips...no fluff. 🐰