Monitoraggio

PowerShell Universal si integra automaticamente con Microsoft Application Insights per fornire monitoraggio e avvisi per il suo sistema. Fornisce inoltre contatori delle prestazioni per varie funzionalità nell'ambiente.

Application Insights

Configurazione di Application Insights

Nel portale di Azure, dovrà creare una nuova risorsa Application Insights. Una volta creata, dovrà copiare la stringa di connessione.

Application Insights Information

Successivamente, incolli la stringa di connessione nel file Impostazioni di PowerShell Universal. Infine, riavvii il server PowerShell Universal. Il monitoraggio dell'applicazione sarà ora abilitato.

  "ApplicationInsights": {
    "ConnectionString": "InstrumentationKey=73b84b67-6fc9-4c37-9f54-000000000000"
  },

Se esegue PowerShell Universal in Azure, può anche creare una nuova impostazione dell'applicazione. All'interno della sua app web, clicchi su Configurazione e poi su Nuova impostazione dell'applicazione.

Il nome deve essere:

APPLICATIONINSIGHTS__CONNECTIONSTRING

Il valore deve essere la stringa di connessione. Riavvii la sua app web per iniziare a raccogliere le metriche.

Visualizzazione dei dati di monitoraggio

Nel portale di Azure, può visualizzare la risorsa Application Insights per consultare le informazioni sul suo server PowerShell Universal. Sono inclusi dati come le risposte non riuscite, il tempo di risposta del server, le richieste al server e la disponibilità. Potrà inoltre configurare avvisi per monitorare condizioni particolari del server PowerShell Universal.

Contatori delle prestazioni

I contatori delle prestazioni sono supportati solo su Windows.

I contatori delle prestazioni vengono installati eseguendo l'installer MSI. Una volta fatto, i dati sulle prestazioni verranno generati automaticamente dai seguenti contatori.

• PowerShell Universal \ Active API Endpoints \ _Total
• PowerShell Universal \ Active API Endpoints \ Endpoint
• PowerShell Universal \ API Endpoint Calls per Second \ _Total
• PowerShell Universal \ API Endpoint Calls per Second \ Endpoint
• PowerShell Universal \ API Execution Time \ _Total
• PowerShell Universal \ API Execution Time \ Endpoint
• PowerShell Universal \ Active Dashboard Connections \ _Total
• PowerShell Universal \ Active Dashboard Connections \ Dashboard

Installazione

Per impostazione predefinita, l'MSI installerà i contatori delle prestazioni. Se esegue PowerShell Universal al di fuori dell'MSI, dovrà installarli manualmente. Può farlo con lo script seguente. Dovrà eseguirlo da un prompt con privilegi elevati.

$categoryName = "PowerShell Universal"
$categoryType = [System.Diagnostics.PerformanceCounterCategoryType]::MultiInstance
$categoryExists = [System.Diagnostics.PerformanceCounterCategory]::Exists($categoryName)

If (-Not $categoryExists)
{
$objCCDC = New-Object System.Diagnostics.CounterCreationDataCollection
$objCCD1 = New-Object System.Diagnostics.CounterCreationData
$objCCD1.CounterName = "Active Endpoints"
$objCCD1.CounterType = "NumberOfItems32"
$objCCD1.CounterHelp = "Active number of executing endpoints."
$objCCDC.Add($objCCD1) | Out-Null

$objCCD1 = New-Object System.Diagnostics.CounterCreationData
$objCCD1.CounterName = "Execution Time"
$objCCD1.CounterType = "averageTimer32"
$objCCD1.CounterHelp = "Average execution time."
$objCCDC.Add($objCCD1) | Out-Null

$objCCD1 = New-Object System.Diagnostics.CounterCreationData
$objCCD1.CounterName = "Execution Time Base"
$objCCD1.CounterType = "averageBase"
$objCCD1.CounterHelp = "Average execution time base."
$objCCDC.Add($objCCD1) | Out-Null

$objCCD1 = New-Object System.Diagnostics.CounterCreationData
$objCCD1.CounterName = "Calls per second"
$objCCD1.CounterType = "rateOfCountsPerSecond64"
$objCCD1.CounterHelp = "Number of executions per second."
$objCCDC.Add($objCCD1) | Out-Null

$objCCD1 = New-Object System.Diagnostics.CounterCreationData
$objCCD1.CounterName = "Active Connections"
$objCCD1.CounterType = "numberOfItems64"
$objCCD1.CounterHelp = "Number of active connections to dashboards"
$objCCDC.Add($objCCD1) | Out-Null

[System.Diagnostics.PerformanceCounterCategory]::Create($categoryName, $categoryHelp, $categoryType, $objCCDC)|Out-Null
}

Processi

I processi avviati direttamente da PowerShell Universal verranno visualizzati nella pagina dei processi. Può accedere a questa pagina cliccando su Home e poi sulla scheda Processi.

Le informazioni includono l'ID del processo, lo scopo, il nome del file e l'utilizzo della memoria. Può anche visualizzare lo stato dei runspace all'interno del processo.

Si noti che i processi avviati dai suoi script non verranno elencati qui.

Sessioni utente

Può visualizzare le sessioni utente per le dashboard e la console di amministrazione cliccando sulla scheda Sessioni utente nella pagina Home. Le informazioni sulla sessione includono l'ora di connessione, l'origine, il nome utente, la stringa dello user agent e l'indirizzo IP remoto.