Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 15 additions & 7 deletions docs/administrator-manual/installation/system_requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,22 +140,30 @@ A NethServer 8 (NS8) node requires outbound network connectivity to a number of

<p class="table-caption">Endpoints used by cluster leader node with an active Subscription</p>

NS8 core components include Loki, used for [logs persistence](../configuration/log_server.md#logs-persistence-section), and Grafana, used for [Grafana dashboards](../configuration/metrics.md#grafana_access-section). Both are developed by Grafana Labs and send anonymous usage statistics. NS8 deliberately leaves this telemetry enabled. The update checks of Grafana and the telemetry of the log collector are disabled.
Notes

- All listed connections are initiated by the NS8 node.
- Blocking access to these services can prevent updates, application installation, backups, cluster formation, or subscription validation.
- Additional outbound connections may be required by specific features, such as email notifications and HTTP routes, and by installed applications, depending on their configuration and upstream services.

## Third-party telemetry endpoints {#third-party-telemetry}

Some NS8 components are developed by third parties and contact their vendor's servers, to send anonymous usage statistics or to check for new releases. These connections are not required for NS8 to work. NS8 deliberately leaves some of them enabled, as set by the upstream defaults, and disables the others:

- Loki, used for [logs persistence](../configuration/log_server.md#logs-persistence-section), and Grafana, used for [Grafana dashboards](../configuration/metrics.md#grafana_access-section), are developed by Grafana Labs and send anonymous usage statistics. The update checks of Grafana and the telemetry of the log collector are disabled.
- Traefik, the proxy that handles [HTTP routes](../configuration/proxy.md), is developed by Traefik Labs and checks once a day for new releases: when a new release exists, Traefik writes a warning in its log. Its anonymous usage statistics are disabled. Some applications, such as Loki and NethSecurity controller, run their own internal copy of Traefik: in those copies the check is disabled.

| Purpose | Host name | Port | Protocol | Notes |
|----|----|----|----|----|
| Loki usage statistics | stats.grafana.org | 443 | HTTPS | Sent by every Loki instance |
| Grafana usage statistics | stats.grafana.org | 443 | HTTPS | Sent only if Grafana dashboards are enabled |
| Traefik new version check | update.traefik.io | 443 | HTTPS | Sent once a day by the Traefik instance of every node |

<p class="table-caption">Telemetry endpoints of Grafana Labs components</p>
<p class="table-caption">Third-party telemetry endpoints of NS8 components</p>

If a DNS filter, such as Pi-hole, blocks `stats.grafana.org`, the failed requests can generate a high number of DNS queries. To disable the telemetry, follow the instructions of the [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) and [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry) modules.

Notes

- All listed connections are initiated by the NS8 node.
- Blocking access to these services can prevent updates, application installation, backups, cluster formation, or subscription validation.
- Additional outbound connections may be required by specific features, such as email notifications and HTTP routes, and by installed applications, depending on their configuration and upstream services.
If `update.traefik.io` is not reachable, Traefik only writes a warning in its log once a day. To disable the check, follow the instructions of the [Traefik](https://github.com/NethServer/ns8-traefik#disable-telemetry) module.

## Web browser requirements

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -133,22 +133,30 @@ Un nodo NethServer 8 (NS8) richiede connettività di rete in uscita verso una se

<p class="table-caption">Endpoint utilizzati dal nodo leader del cluster con una subscription attiva</p>

I componenti del core di NS8 includono Loki, usato per la [persistenza dei log](../configuration/log_server.md#logs-persistence-section), e Grafana, usato per le [dashboard Grafana](../configuration/metrics.md#grafana_access-section). Entrambi sono sviluppati da Grafana Labs e inviano statistiche di utilizzo anonime. NS8 lascia deliberatamente attiva questa telemetria. I controlli degli aggiornamenti di Grafana e la telemetria del raccoglitore dei log sono disattivati.
Note

- Tutte le connessioni elencate sono avviate dal nodo NS8.
- Bloccare l'accesso a questi servizi può impedire aggiornamenti, installazione di applicazioni, backup, formazione del cluster o validazione delle subscription.
- Potrebbero essere necessarie connessioni in uscita aggiuntive per funzionalità specifiche, come le notifiche email e i percorsi HTTP, e per le applicazioni installate, a seconda della loro configurazione e dei servizi upstream.

## Endpoint di telemetria di terze parti {#third-party-telemetry}

Alcuni componenti di NS8 sono sviluppati da terze parti e contattano i server del loro produttore, per inviare statistiche di utilizzo anonime o per controllare se esistono nuove versioni. Queste connessioni non sono necessarie al funzionamento di NS8. NS8 ne lascia deliberatamente attive alcune, come previsto dalle impostazioni predefinite dei produttori, e disattiva le altre:

- Loki, usato per la [persistenza dei log](../configuration/log_server.md#logs-persistence-section), e Grafana, usato per le [dashboard Grafana](../configuration/metrics.md#grafana_access-section), sono sviluppati da Grafana Labs e inviano statistiche di utilizzo anonime. I controlli degli aggiornamenti di Grafana e la telemetria del raccoglitore dei log sono disattivati.
- Traefik, il proxy che gestisce le [route HTTP](../configuration/proxy.md), è sviluppato da Traefik Labs e controlla una volta al giorno se esistono nuove versioni: quando esiste una nuova versione, Traefik scrive un avviso nel suo log. Le sue statistiche di utilizzo anonime sono disattivate. Alcune applicazioni, come Loki e NethSecurity controller, eseguono una propria copia interna di Traefik: in queste copie il controllo è disattivato.

| Scopo | Nome host | Porta | Protocollo | Note |
|----|----|----|----|----|
| Statistiche di utilizzo di Loki | stats.grafana.org | 443 | HTTPS | Inviate da ogni istanza di Loki |
| Statistiche di utilizzo di Grafana | stats.grafana.org | 443 | HTTPS | Inviate solo se le dashboard Grafana sono attive |
| Controllo nuove versioni di Traefik | update.traefik.io | 443 | HTTPS | Inviato una volta al giorno dall'istanza di Traefik di ogni nodo |

<p class="table-caption">Endpoint di telemetria dei componenti di Grafana Labs</p>
<p class="table-caption">Endpoint di telemetria di terze parti dei componenti di NS8</p>

Se un filtro DNS, come Pi-hole, blocca `stats.grafana.org`, le richieste fallite possono generare un numero elevato di query DNS. Per disattivare la telemetria, segui le istruzioni dei moduli [Loki](https://github.com/NethServer/ns8-loki#disable-telemetry) e [Metrics](https://github.com/NethServer/ns8-metrics#disable-telemetry).

Note

- Tutte le connessioni elencate sono avviate dal nodo NS8.
- Bloccare l'accesso a questi servizi può impedire aggiornamenti, installazione di applicazioni, backup, formazione del cluster o validazione delle subscription.
- Potrebbero essere necessarie connessioni in uscita aggiuntive per funzionalità specifiche, come le notifiche email e i percorsi HTTP, e per le applicazioni installate, a seconda della loro configurazione e dei servizi upstream.
Se `update.traefik.io` non è raggiungibile, Traefik scrive solo un avviso nel suo log una volta al giorno. Per disattivare il controllo, segui le istruzioni del modulo [Traefik](https://github.com/NethServer/ns8-traefik#disable-telemetry).

## Requisiti del browser web

Expand Down
Loading