Telemetry Overview

Telemetry Guide

Introduction

Devtron collects anonymous telemetry data that helps the Devtron team in understanding how the product is being used and in deciding what to focus on next.
The data collected is minimal, non PII, statistical in nature and cannot be used to uniquely identify an user.
Please see the next section to see what data is collected and sent. Access to collected data is strictly limited to the Devtron team.
As a growing community, it is very valuable in helping us make the Devtron a better product for everyone!

What data is collected

Here is a sample event JSON which is collected and sent:
1
{
2
"id": "017ah6af-8h60-0000-abfc-a0a25hd823d6",
3
"timestamp": "2021-06-29T07:33:02.001000+00:00",
4
"event": "Heartbeat",
5
"distinct_id": "qadgrtuxogziz8ak",
6
"properties": {
7
"$geoip_city_name": "Columbus",
8
"$geoip_continent_code": "NA",
9
"$geoip_continent_name": "North America",
10
"$geoip_country_code": "US",
11
"$geoip_country_name": "United States",
12
"$geoip_latitude": 39.9625,
13
"$geoip_longitude": -83.0061,
14
"$geoip_postal_code": "43215",
15
"$geoip_subdivision_1_code": "OH",
16
"$geoip_subdivision_1_name": "Ohio",
17
"$geoip_time_zone": "America/New_York",
18
"$ip": "18.117.165.2",
19
"$lib": "posthog-go",
20
"$lib_version": "1.0.2",
21
"devtronVersion": "v1",
22
"eventType": 0,
23
"serverVersion": "v1.17.17",
24
"timestamp": "2021-06-29T07:33:02.001372393Z",
25
"ucid": "qadgrtuxogziz8ak"
26
}
27
}
Copied!
Key
Description
event
Name of the event
distinct_id
Unique user id or client id
devtronVersion
devtron version
serverVersion
kubernetes cluster version
eventType
event type
ucid
Unique client id

Inception (operator)

Inception sends the installation and upgradation events of the Devtron tool to measure the churn rate.
Events which are sent by Inception :
    InstallationStart
    InstallationInProgress
    InstallationSuccess
    UpgradeStart
    UpgradeInProgress
    UpgradeSuccess
Event is same as sample json with event name mentioned above.

Devtron (orchestrator)

Orchestrator sends the summary events of the Devtron tool to measure the daily usage.
Events which are sent by Orchestrator :
    Heartbeat
    Summary
Orchestrator sends the Summary event once in 24 hours with the daily operation done by user.
Here is a sample summary JSON which is available under properties:
1
{
2
"summary": {
3
"cdCountPerDay": 1,
4
"ciCountPerDay": 1,
5
"clusterCount": 1,
6
"environmentCount": 1,
7
"nonProdAppCount": 1,
8
"userCount": 2
9
}
10
}
Copied!
Key
Description
cdCountPerDay
cd pipeline created in last 24 hour
ciCountPerDay
ci pipeline created in last 24 hour
clusterCount
total cluster in the system
environmentCount
total environment in the system
nonProdAppCount
total non prod apps created
userCount
total user created in the system

Dashboard

Dashboard sends the events to measure dashboard visit of the Devtron tool.
Events which are sent by Orchestrator :
    identify
Dashboard sends the identify event when user visits the Dashboard for the first time.

Where data is sent

The data is sent to Posthog server.
Last modified 3mo ago