diff --git a/docs/apt.md b/docs/apt.md index 3289266de..e21a3fc06 100644 --- a/docs/apt.md +++ b/docs/apt.md @@ -4,7 +4,8 @@ This document describes how to install Percona Server for PostgreSQL from Percon ## Preconditions -Debian and other systems that use the apt package manager include the upstream PostgreSQL server package (`postgresql-12`) by default. The components of Percona Distribution for PostgreSQL 12 can only be installed together with the PostgreSQL server shipped by Percona (`percona-postgresql-12`). If you wish to use Percona Distribution for PostgreSQL, uninstall the `postgresql-12` and then install the chosen components from Percona Distribution for PostgreSQL. +1. Debian and other systems that use the apt package manager include the upstream PostgreSQL server package (`postgresql-12`) by default. The components of Percona Distribution for PostgreSQL 12 can only be installed together with the PostgreSQL server shipped by Percona (`percona-postgresql-12`). If you wish to use Percona Distribution for PostgreSQL, uninstall the `postgresql-12` and then install the chosen components from Percona Distribution for PostgreSQL. +2. Install `curl` for [Telemetry](telemetry.md). We use Telemetry to better understand the use of our products and improve them. ## Procedure diff --git a/docs/telemetry.md b/docs/telemetry.md new file mode 100644 index 000000000..771f504b6 --- /dev/null +++ b/docs/telemetry.md @@ -0,0 +1,53 @@ +# Telemetry on Percona Distribution for PostgreSQL + +Percona telemetry fills in the gaps in our understanding of how you use Percona Distribution for PostgreSQL to improve our products. Participation in this anonymous program is optional. You can opt-out if you prefer to not share this information. + +## What information is collected + +Currently, telemetry is added only to the Percona packages and Docker images. It collects only information about the installation environment. Future releases may add additional telemetry metrics. + +Be assured that access to this raw data is rigorously controlled. Percona does not collect personal data. All data is anonymous and cannot be traced to a specific user. To learn more about our privacy practices, read the [Percona Privacy statement]. + +The following is an example of the collected data: + +```json +[{"id" : "c416c3ee-48cd-471c-9733-37c2886f8231", +"product_family" : "PRODUCT_FAMILY_POSTGRESQL", +"instanceId" : "6aef422e-56a7-4530-af9d-94cc02198343", +"createTime" : "2023-11-01T10:46:23Z", +"metrics": +[{"key" : "deployment","value" : "PACKAGE"}, +{"key" : "pillar_version","value" : "12.17"}, +{"key" : "OS","value" : "Oracle Linux Server 8.8"}, +{"key" : "hardware_arch","value" : "x86_64 x86_64"}]}] +``` + +## Disable telemetry + +Starting with Percona Distribution for PostgreSQL 12.17, telemetry is enabled by default. If you decide not to send usage data to Percona, you can set the `PERCONA_TELEMETRY_DISABLE=1` environment variable for either the root user or in the operating system prior to the installation process. + +=== "Debian-derived distribution" + + Add the environment variable before the install process. + + ```{.bash data-prompt="$"} + $ sudo PERCONA_TELEMETRY_DISABLE=1 apt install percona-postgresql-{{pgversion}} + ``` + +=== "Red Hat-derived distribution" + + Add the environment variable before the install process. + + ```{.bash data-prompt="$"} + $ sudo PERCONA_TELEMETRY_DISABLE=1 yum install percona-postgresql{{pgversion}}-server + ``` + +=== "DOCKER" + + Add the environment variable when running a command in a new container. + + ```{.bash data-prompt="$"} + $ docker run --name container-name -e POSTGRES_PASSWORD=secret -e PERCONA_TELEMETRY_DISABLE=1 -d percona/percona-distribution-postgresql:tag + ``` + +[Percona Privacy statement]: https://www.percona.com/privacy-policy#h.e34c40q8sb1a \ No newline at end of file diff --git a/docs/yum.md b/docs/yum.md index ff3c7fd0f..f6e8c11c1 100644 --- a/docs/yum.md +++ b/docs/yum.md @@ -19,7 +19,15 @@ $ sudo yum repolist ## Procedure -Run all the commands in the following sections as root or using the `sudo` command: +Run all the commands in the following sections as root or using the `sudo` command. + +### Install dependencies + +Install `curl` for [Telemetry](telemetry.md). We use it to better understand the use of our products and improve them. + +```{.bash data-prompt="$"} +$ sudo yum -y install curl +``` ### Configure the repository diff --git a/mkdocs-base.yml b/mkdocs-base.yml index f94b83a1c..3e2998882 100644 --- a/mkdocs-base.yml +++ b/mkdocs-base.yml @@ -195,9 +195,8 @@ nav: - Upgrade spatial database: solutions/postgis-upgrade.md - LDAP authentication: - ldap.md - - Uninstall: - - uninstalling.md - - Licensing: - - licensing.md + - Telemetry: telemetry.md + - Uninstall: uninstalling.md + - Licensing: licensing.md - Trademark policy: - trademark-policy.md