> 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/sviluppo/profiling.md).

# Profilazione

Attivi il profiler delle prestazioni di PowerShell Universal per diagnosticare dashboard, API e job lenti utilizzando Measure-PSUBlock e la dashboard dei risultati del profiler.

{% hint style="info" %}
La profilazione funziona solo per l'ambiente integrato.
{% endhint %}

PowerShell Universal offre un profiler delle prestazioni per il debug dei problemi in cui la piattaforma può presentare risposte lente. Questo è utile principalmente durante la creazione di Dashboard.

## Abilitare la profilazione

La profilazione aumenta l'utilizzo della memoria poiché i dati di profilazione vengono archiviati in memoria. È possibile abilitare la profilazione configurando la proprietà `Profiling` di appsettings.json. Per impostazione predefinita è `false`. Sarà necessario riavviare PowerShell Universal dopo aver abilitato o disabilitato la profilazione.

```json
"Profiling": true
```

## Accedere ai dati di profilazione

È possibile accedere ai dati di profilazione navigando su `/profiler/results-index` . Sarà necessario aver effettuato l'accesso come amministratore prima di poter accedere a questo URL.

Vedrà un elenco di richieste e le relative tempistiche.

Facendo clic sulla richiesta verrà visualizzata una suddivisione delle tempistiche.

## Profilare un endpoint API

È possibile profilare un endpoint API utilizzando `Measure-PSUBlock`. L'API sarà elencata per URL nell'indice dei risultati.

Ad esempio, si supponga di avere un'API chiamata `/process`.

```powershell
New-PSUEndpoint -Url "/process" -Endpoint {
    Measure-PSUBlock -Name 'Api' -ScriptBlock {
        Get-Process | Select-Object name
    }
} -Authentication -Timeout 0 
```

Il risultato della profilazione di questa API sarebbe elencato per URL.

Visualizzando il profilo di questa API verrebbe elencato il blocco che abbiamo misurato.

## Profilare un'app

{% hint style="info" %}
`Measure-UDBlock` è un alias di `Measure-PSUBlock`
{% endhint %}

È possibile utilizzare il profiler integrato con le App. Per impostazione predefinita, vengono registrate determinate tempistiche di azioni interne. È inoltre possibile utilizzare il cmdlet `Measure-PSUBlock` per misurare blocchi specifici all'interno della dashboard.

Ad esempio, questa app utilizza `Measure-PSUBlock` per misurare le prestazioni del cmdlet `Start-Sleep`. Il risultato è che il blocco richiederà un secondo per l'esecuzione.

```powershell
New-UDApp -Title 'App' -Content {
    New-UDDynamic -Id 'MyElement' -Content {
        Measure-PSUBlock -Name 'WithinDashboard' -ScriptBlock {
            Start-Sleep 1
        }
    }
}
```

Quando esamina le richieste all'interno del profiler, dovrà cercare `UDComponent\ElementPost` e `UDComponent\Element`. Queste sono richieste per elementi all'interno delle App.

Di seguito è riportato l'output di esempio dell'app mostrata sopra. Noti che l'URL include l'ID dell'elemento `MyElement`. Noterà anche che il blocco `WithinDashboard` richiede circa 1 secondo.

Non tutte le tempistiche vengono visualizzate per impostazione predefinita. È possibile fare clic su `show trivial` per espandere tutte le tempistiche.

## Profilare un job

È possibile profilare i job utilizzando `Measure-PSUBlock` all'interno dello script.

Ad esempio, si supponga di avere uno script che chiama `Get-Service`.

```powershell
Measure-PSUBlock -ScriptBlock {
    Get-Service
} -Name 'Get-Service'
```

L'esecuzione di un profilo su questo script elencherà il job come `JobProfiler/{id}`. L'id corrisponderà all'ID del job mostrato nella console di amministrazione.

Il profilo includerà il blocco che è stato misurato.


---

# 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/sviluppo/profiling.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.