Collector

Collector

Il Collector è il componente che raccoglie dati dalla tua infrastruttura Citrix e Nutanix e li trasmette al cloud Corellix.

Funzionalità

• ✅ Raccolta dati da Citrix Virtual Apps & Desktops
• ✅ Raccolta dati da Nutanix AHV/Prism Central
• ✅ Ricezione dati dagli User Agent
• ✅ Buffer locale con retry automatico in caso di disconnessione
• ✅ Supporto multi-site per infrastrutture distribuite
• ✅ Comunicazione sicura via HTTPS/TLS

Installazione

Passo 1: Download

Scarica il pacchetto CorellixCollector dalla sezione Downloads del Customer Portal.

Passo 2: Installazione

1. Estrai il pacchetto su C:\Program Files\Corellix\Collector
2. Esegui Setup-Wizard.bat come Amministratore
3. Segui il wizard di configurazione

Passo 3: Configurazione

Il wizard ti chiederà:

Parametro	Descrizione
Tenant ID	Il tuo identificativo tenant (dal Customer Portal)
API Key	Chiave di autenticazione (generala da Impostazioni → API Keys)
Citrix DDC	Hostname del Delivery Controller (es. ddc.tuodominio.com)
Nutanix Prism	Hostname di Prism Central (opzionale)
Polling Interval	Frequenza di raccolta dati (default: 60 secondi)

Configurazione Avanzata

File di Configurazione

Il file appsettings.json contiene tutte le impostazioni:

{
  "CollectorSettings": {
    "ListenPort": 5050,
    "PollingIntervalSeconds": 60
  },
  "CitrixSettings": {
    "Enabled": true,
    "DeliveryController": "ddc.tuodominio.com"
  },
  "NutanixSettings": {
    "Enabled": false,
    "PrismCentralUrl": "https://prism.tuodominio.com:9440"
  }
}

Intervallo di Polling

Puoi modificare la frequenza di raccolta dati:

• 30 secondi: per ambienti con molti cambiamenti
• 60 secondi: bilanciamento ottimale (default)
• 120 secondi: per ridurre il carico sul DDC

Multi-Site

Per infrastrutture con più siti, installa un Collector per ogni sito. Ogni Collector può monitorare:

• Un Delivery Controller Citrix
• Un Prism Central Nutanix
• Oppure entrambi

Gestione del Servizio

Windows Service

Il Collector viene installato come servizio Windows:

Nome servizio: CorellixCollector
Tipo avvio: Automatico
Account: LocalSystem (o account di servizio dedicato)

Comandi Utili

# Verifica stato
Get-Service CorellixCollector

# Riavvia il servizio
Restart-Service CorellixCollector

# Visualizza log recenti
Get-Content "C:\Program Files\Corellix\Collector\logs\collector.log" -Tail 50

Troubleshooting

Il Collector non si avvia

1. Verifica che la porta 5050 non sia già in uso
2. Controlla i permessi dell’account di servizio
3. Verifica la connettività verso api.corellix.io

Nessun dato nel Portal

1. Verifica che il servizio sia in esecuzione
2. Controlla i log per errori di autenticazione
3. Verifica che il Tenant ID e API Key siano corretti

Errori di connessione Citrix

1. Verifica che l’account di servizio abbia i permessi corretti
2. Testa la connessione al DDC con PowerShell:

   Add-PSSnapin Citrix.*
   Get-BrokerSession -AdminAddress "ddc.tuodominio.com"

Aggiornamenti

Gli aggiornamenti del Collector vengono rilasciati periodicamente. Per aggiornare:

1. Scarica la nuova versione dal Customer Portal
2. Ferma il servizio: Stop-Service CorellixCollector
3. Estrai i nuovi file (il file di configurazione viene preservato)
4. Riavvia il servizio: Start-Service CorellixCollector