Activating and deactivating telemetry

Activate the telemetry module to help Ceph developers understand how Ceph is used and what problems users might be experiencing, helping to improve the dashboard experience. Activating the telemetry module sends anonymous data about the cluster back to the Ceph developers.

About this task

View the telemetry data that is sent to the Ceph developers on the public telemetry dashboard. The public dashboard allows the community to easily see summary statistics on how many clusters are reporting, their total capacity and OSD count, and version distribution trends.

The telemetry report is broken down into several channels, each with a different type of information. After telemetry is enabled, you can turn on and off the individual channels. If telemetry is off, the per-channel setting has no effect.

Basic
Provides basic information about the cluster.
Crash
Provides information about daemon crashes.
Device
Provides information about device metrics.
Ident
Provides user-provided identifying information about the cluster.
Perf
Provides various performance metrics of the cluster.
The data reports contain information that help the developers gain a better understanding of the way Ceph is used. The data includes counters and statistics on how the cluster has been deployed, the version of Ceph, the distribution of the hosts, and other parameters.
Important: The data reports do not contain any sensitive data like pool names, object names, object contents, hostnames, or device serial numbers.
Note: Telemetry can also be managed by using an API. For more information, see Telemetry.

Procedure

  1. Activate the telemetry module by going to Settings > Telemetry configuration.
  2. Select each channel that telemetry should be enabled on.
    Note: For detailed information about each channel type, click More Info next to the channels.
  3. Complete the Contact Information for the cluster.
    Enter the contact, Ceph cluster description, and organization.
  4. Optional: Complete the Advanced Settings field options.
    Interval
    Set the interval by hour. The module compiles and sends a new report per this hour interval.

    The default interval is 24 hours.

    Proxy
    Use to configure an HTTP or HTTPs proxy server if the cluster cannot directly connect to the configured telemetry endpoint. Add the server in one of the following formats:

    https://10.0.0.1:8080 or https://ceph:telemetry@10.0.01:8080

    The default endpoint is 
    telemetry.ceph.com
  5. Click Next.
    This displays the Telemetry report preview before enabling telemetry.
  6. Review the Report preview.
    Note: The report can be downloaded and saved locally or copied to the clipboard.
  7. Select I agree to my telemetry data being submitted under the Community Data License Agreement.
  8. Enable the telemetry module by clicking Update.
    The following message is displayed, confirming the telemetry activation:

    The Telemetry module has been configured and activated successfully

Deactivating telemetry

Procedure

To deactivate the telemetry module, go to Settings > Telemetry configuration and click Deactivate.