> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/piattaforma/telemetry.md).

# Telemetria

PowerShell Universal raccoglie dati di telemetria in modalità opt-in. Durante un'installazione MSI, l'interfaccia utente chiederà se raccogliere i dati di telemetria. È inoltre possibile configurare i dati di telemetria su altri sistemi per aiutarci a conoscere meglio come viene utilizzato PSU.

## Come si configura la telemetria?

La telemetria si configura tramite il sistema di configurazione `appsettings.json`. Se ha abilitato la telemetria e desidera disabilitarla, può farlo modificando il file in `%ProgramData%\PowerShellUniversal\appsettings.json`. Può anche essere abilitata e disabilitata impostando la variabile di ambiente `PSUTelemetry`. Imposti il valore su `true` per inviare la telemetria.

## Perché raccogliamo la telemetria?

La telemetria fornisce informazioni su come viene utilizzato il prodotto. Ci aiuta a prendere decisioni su quali funzionalità concentrarci e fornisce riscontri sui tassi di errore nelle nuove versioni del prodotto.

## Cosa raccogliamo?

Di seguito sono riportati gli elementi di dati che raccogliamo e il motivo per cui li raccogliamo.

### ID sessione

L'ID sessione è un GUID generato all'avvio del processo PowerShell Universal. Non è basato su alcuna informazione relativa al sistema ed è utilizzato solo per correlare i dati di telemetria aggiuntivi inviati dal processo.

### Versione

Si tratta della versione di PowerShell Universal in esecuzione. Ci consente di vedere quali versioni del prodotto stanno utilizzando i nostri utenti.

### Sistema operativo

Utilizziamo il sistema operativo per aiutarci a determinare su quali sistemi operativi viene eseguito il nostro prodotto, in modo da garantire che ci concentriamo sulla qualità e sulle funzionalità per quella piattaforma.

### Timestamp e uptime

Il timestamp indica quando sono stati inviati i dati di telemetria. Il valore di uptime indica da quanto tempo il server PSU è in esecuzione. Il timestamp è utile per la correlazione dei dati e l'uptime è utile per vedere da quanto tempo sono in esecuzione i server PSU, in modo da garantire che la piattaforma sia il più stabile possibile per il tempo di esecuzione medio.

### Conteggi di identità, computer e ruoli

Inviamo il numero di identità, computer e ruoli presenti in un sistema per vedere quanto sono grandi le installazioni di PSU. Questo ci aiuta a concentrare i nostri sforzi di sviluppo per garantire la soddisfazione del maggior numero possibile di installazioni.

### Conteggi delle risorse

Invieremo diversi conteggi delle risorse per vedere con quale frequenza e in quale misura vengono utilizzate determinate risorse. Questi includono:

* Endpoint
* App
* Script
* Pianificazioni
* Pagine del portale

Le risorse molto utilizzate riceveranno maggiore sviluppo.

### Stato della licenza

Le informazioni sullo stato della licenza sono utili a fini di marketing e per determinare quali funzionalità portano a istanze concesse in licenza. I clienti paganti ci consentono di sostenere le nostre iniziative di sviluppo e di supporto per la piattaforma.

### Errori nell'ultima ora

Utilizziamo le notifiche di errore come metrica per determinare lo stato di salute degli ambienti PSU di una particolare versione. Questo può aiutare a fornire dati sullo stato di salute di una release prima che troppi clienti ne subiscano l'impatto.

### Metodo di hosting

Questo restituirà IIS oppure Kestrel. Aiuta a determinare i metodi di hosting più utilizzati.

## Come raccogliamo i dati?

Non utilizziamo sistemi di terze parti per raccogliere o archiviare i dati. Le istanze PSU con la telemetria abilitata invieranno una richiesta di telemetria direttamente a Ironman Software, una volta all'avvio e una volta all'ora. La telemetria non avrà alcun impatto sulle prestazioni, ma richiede l'accesso a internet per il nodo con la funzionalità abilitata.

Se è in uso un firewall, sarà necessario fornire l'accesso a `ironmansoftware.com`.

Utilizziamo la classe standard HttpClient di .NET per inviare questi dati e non forniamo alcuna intestazione personalizzata alla richiesta. Utilizzeremo un proxy se è stato configurato in PSU.

## Verranno raccolti altri dati?

Potremmo aggiungere altri punti dati nelle versioni future del prodotto. Documenteremo qui e nel changelog eventuali modifiche. Raccoglieremo esclusivamente informazioni anonime.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/it/piattaforma/telemetry.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
