1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
|
.. _telemetry:
Telemetry Module
================
The telemetry module sends anonymous data about the cluster back to the Ceph
developers to help understand how Ceph is used and what problems users may
be experiencing.
This data is visualized on `public dashboards <https://telemetry-public.ceph.com/>`_
that allow the community to quickly see summary statistics on how many clusters
are reporting, their total capacity and OSD count, and version distribution
trends.
Channels
--------
The telemetry report is broken down into several "channels", each with
a different type of information. Assuming telemetry has been enabled,
individual channels can be turned on and off. (If telemetry is off,
the per-channel setting has no effect.)
* **basic** (default: on): Basic information about the cluster
- capacity of the cluster
- number of monitors, managers, OSDs, MDSs, object gateways, or other daemons
- software version currently being used
- number and types of RADOS pools and CephFS file systems
- names of configuration options that have been changed from their
default (but *not* their values)
* **crash** (default: on): Information about daemon crashes, including
- type of daemon
- version of the daemon
- operating system (OS distribution, kernel version)
- stack trace identifying where in the Ceph code the crash occurred
* **device** (default: on): Information about device metrics, including
- anonymized SMART metrics
* **ident** (default: off): User-provided identifying information about
the cluster
- cluster description
- contact email address
The data being reported does *not* contain any sensitive
data like pool names, object names, object contents, hostnames, or device
serial numbers.
It contains counters and statistics on how the cluster has been
deployed, the version of Ceph, the distribution of the hosts and other
parameters which help the project to gain a better understanding of
the way Ceph is used.
Data is sent secured to *https://telemetry.ceph.com*.
Sample report
-------------
You can look at what data is reported at any time with the command::
ceph telemetry show
To protect your privacy, device reports are generated separately, and data such
as hostname and device serial number is anonymized. The device telemetry is
sent to a different endpoint and does not associate the device data with a
particular cluster. To see a preview of the device report use the command::
ceph telemetry show-device
Please note: In order to generate the device report we use Smartmontools
version 7.0 and up, which supports JSON output.
If you have any concerns about privacy with regard to the information included in
this report, please contact the Ceph developers.
Channels
--------
Individual channels can be enabled or disabled with::
ceph config set mgr mgr/telemetry/channel_ident false
ceph config set mgr mgr/telemetry/channel_basic false
ceph config set mgr mgr/telemetry/channel_crash false
ceph config set mgr mgr/telemetry/channel_device false
ceph telemetry show
ceph telemetry show-device
Enabling Telemetry
------------------
To allow the *telemetry* module to start sharing data::
ceph telemetry on
Please note: Telemetry data is licensed under the Community Data License
Agreement - Sharing - Version 1.0 (https://cdla.io/sharing-1-0/). Hence,
telemetry module can be enabled only after you add '--license sharing-1-0' to
the 'ceph telemetry on' command.
Telemetry can be disabled at any time with::
ceph telemetry off
Interval
--------
The module compiles and sends a new report every 24 hours by default.
You can adjust this interval with::
ceph config set mgr mgr/telemetry/interval 72 # report every three days
Status
--------
The see the current configuration::
ceph telemetry status
Manually sending telemetry
--------------------------
To ad hoc send telemetry data::
ceph telemetry send
In case telemetry is not enabled (with 'ceph telemetry on'), you need to add
'--license sharing-1-0' to 'ceph telemetry send' command.
Sending telemetry through a proxy
---------------------------------
If the cluster cannot directly connect to the configured telemetry
endpoint (default *telemetry.ceph.com*), you can configure a HTTP/HTTPS
proxy server with::
ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080
You can also include a *user:pass* if needed::
ceph config set mgr mgr/telemetry/proxy https://ceph:telemetry@10.0.0.1:8080
Contact and Description
-----------------------
A contact and description can be added to the report. This is
completely optional, and disabled by default.::
ceph config set mgr mgr/telemetry/contact 'John Doe <john.doe@example.com>'
ceph config set mgr mgr/telemetry/description 'My first Ceph cluster'
ceph config set mgr mgr/telemetry/channel_ident true
|
