You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- **[docker]** Auto-negotiate Docker API Version ([#12256](https://github.com/traefik/traefik/pull/12256) by [felixbuenemann](https://github.com/felixbuenemann))
12
+
- **[server]** Fix multi-layer routing with models ([#12258](https://github.com/traefik/traefik/pull/12258) by [juliens](https://github.com/juliens))
13
+
- **[udp]** Revert "Avoid allocations in readLoop by using sync.Pool" ([#12267](https://github.com/traefik/traefik/pull/12267) by [kevinpollet](https://github.com/kevinpollet))
14
+
- **[webui]** Fix blocked navigation on Safari ([#12231](https://github.com/traefik/traefik/pull/12231) by [gndz07](https://github.com/gndz07))
15
+
- **[webui]** Restore remote Upgrade to Hub button web component ([#12219](https://github.com/traefik/traefik/pull/12219) by [gndz07](https://github.com/gndz07))
16
+
17
+
**Documentation:**
18
+
- **[k8s]** Fix Nginx provider documentation ([#12266](https://github.com/traefik/traefik/pull/12266) by [nmengin](https://github.com/nmengin))
19
+
- **[k8s]** Fix Gateway API version and the list of features supported ([#12254](https://github.com/traefik/traefik/pull/12254) by [nmengin](https://github.com/nmengin))
- **[docker,docker/swarm]** Auto-negotiate Docker API version ([#12262](https://github.com/traefik/traefik/pull/12262) by [kevinpollet](https://github.com/kevinpollet))
Copy file name to clipboardExpand all lines: docs/content/contributing/data-collection.md
+64-23Lines changed: 64 additions & 23 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,17 +1,72 @@
1
1
---
2
2
title: "Traefik Data Collection Documentation"
3
-
description: "To learn more about how Traefik is being used and improve it, we collect anonymous usage statistics from running instances. Read the technical documentation."
3
+
description: "Learn what data Traefik shares, how it is used, and how you can control it. This documentation explains both version check and anonymous usage statistics data. Read the technical documentation."
4
4
---
5
5
6
6
# Data Collection
7
7
8
-
Understanding How Traefik is Being Used
8
+
Understanding the data Traefik shares and how it is used
9
9
{: .subtitle }
10
10
11
-
## Configuration Example
11
+
## Introduction
12
12
13
-
Understanding how you use Traefik is very important to us: it helps us improve the solution in many different ways.
14
-
For this very reason, the sendAnonymousUsage option is mandatory: we want you to take time to consider whether or not you wish to share anonymous data with us, so we can benefit from your experience and use cases.
13
+
Protecting user privacy is essential to Traefik Labs, and we design every data-sharing mechanism with transparency and minimalism in mind.
14
+
This page describes the two types of data exchanged by Traefik and how to configure them.
15
+
16
+
For more details on how your data is handled, please refer to our [Privacy and Cookie Policy](https://traefik.io/legal/privacy-and-cookie-policy).
17
+
18
+
## Configuration Overview
19
+
20
+
Traefik provides two independent mechanisms:
21
+
22
+
-`checkNewVersion`, enabled by default. You may disable it at any time.
23
+
-`sendAnonymousUsage`, which requires explicit opt‑in.
24
+
25
+
Examples below show how to activate or deactivate both of them.
26
+
27
+
```yaml tab="YAML"
28
+
global:
29
+
checkNewVersion: true # set to false to disable
30
+
sendAnonymousUsage: false # set to true to enable
31
+
```
32
+
33
+
```toml tab="TOML"
34
+
[global]
35
+
checkNewVersion = true # set to false to disable
36
+
sendAnonymousUsage = false # set to true to enable
37
+
```
38
+
39
+
```bash tab="CLI"
40
+
--global.checkNewVersion=true # set to false to disable
41
+
--global.sendAnonymousUsage=false # set to true to enable
42
+
```
43
+
44
+
A log message at startup clearly indicates whether each of those options are enabled or disabled.
45
+
46
+
## Version Check (`checkNewVersion`) – Opt-out
47
+
48
+
Traefik periodically contacts `update.traefik.io` to determine whether a newer version is available.
49
+
When this request is made, Traefik shares the **running version** and the **public IP** of the instance.
50
+
The IP is used to build global usage statistics and does not influence the version comparison.
51
+
52
+
This mechanism helps you stay informed about updates and provides TraefikLabs with a broad view of which versions are deployed in the wild.
53
+
54
+
The collected IP addresses are also used for marketing purposes, specifically to detect companies running Traefik and offer them adapted support contracts, enterprise features, and tailored services.
55
+
56
+
If you want to explore the implementation, you can read the version check source code: [version.go](https://github.com/traefik/traefik/blob/master/pkg/version/version.go)
57
+
58
+
## Anonymous Usage Data (`sendAnonymousUsage`) – Opt‑in
59
+
60
+
Traefik can also collect anonymous usage statistics once per day, starting 10 minutes after it starts running.
61
+
These statistics include:
62
+
63
+
- the Traefik version,
64
+
- a hash of the configuration,
65
+
- an anonymized version of the static configuration (all sensitive fields removed: tokens, passwords, URLs, IP addresses, domains, emails, etc.).
66
+
67
+
This feature comes from this [public proposal](https://github.com/traefik/traefik/issues/2369).
68
+
69
+
This information helps TraefikLabs understand how Traefik is used in general and prioritize features and provider support accordingly. Dynamic configuration (routers and services) is never collected.
15
70
16
71
!!! example "Enabling Data Collection"
17
72
@@ -32,21 +87,6 @@ For this very reason, the sendAnonymousUsage option is mandatory: we want you to
32
87
--global.sendAnonymousUsage
33
88
```
34
89
35
-
## Collected Data
36
-
37
-
This feature comes from this [public proposal](https://github.com/traefik/traefik/issues/2369).
38
-
39
-
In order to help us learn more about how Traefik is being used and improve it, we collect anonymous usage statistics from running instances.
40
-
Those data help us prioritize our developments and focus on what's important for our users (for example, which provider is popular, and which is not).
41
-
42
-
### What's collected / when ?
43
-
44
-
Once a day (the first call begins 10 minutes after the start of Traefik), we collect:
45
-
46
-
- the Traefik version number
47
-
- a hash of the configuration
48
-
- an **anonymized version** of the static configuration (token, username, password, URL, IP, domain, email, etc., are removed).
49
-
50
90
!!! info
51
91
52
92
- We do not collect the dynamic configuration information (routers & services).
@@ -93,8 +133,9 @@ providers:
93
133
insecureSkipVerify: true
94
134
```
95
135
96
-
## The Code for Data Collection
136
+
### The Code for Anonymous Usage Collection
97
137
98
-
If you want to dig into more details, here is the source code of the collecting system: [collector.go](https://github.com/traefik/traefik/blob/master/pkg/collector/collector.go)
138
+
If you want to explore the implementation, you can read the collector source code:
The KubernetesIngressNGINX Provider is no longer experimental in v3.6.2 and can be enabled without the `experimental.kubernetesIngressNGINX` option.
534
+
535
+
**Deprecated Configuration:**
536
+
537
+
??? example "Experimental kubernetesIngressNGINX option (deprecated)"
538
+
539
+
```yaml tab="File (YAML)"
540
+
experimental:
541
+
kubernetesIngressNGINX: true
542
+
```
543
+
544
+
```toml tab="File (TOML)"
545
+
[experimental]
546
+
kubernetesIngressNGINX=true
547
+
```
548
+
549
+
```bash tab="CLI"
550
+
--experimental.kubernetesIngressNGINX=true
551
+
```
552
+
553
+
**Migration Steps:**
554
+
555
+
1. Remove the `kubernetesIngressNGINX` option from the experimental section
556
+
2. Configure the provider using the [kubernetesIngressNGINX Provider documentation](../reference/install-configuration/providers/kubernetes/kubernetes-ingress-nginx.md)
0 commit comments