Collector

Il Collector è il componente che raccoglie dati dalle infrastrutture Citrix e Nutanix e li inoltra all’API Gateway.

Versione Attuale

v1.5.0 - 19 Dicembre 2025

Funzionalità

✅ Raccolta dati da Citrix CVAD (XenDesktop/XenApp)
✅ Raccolta dati da Nutanix AHV/Prism
✅ Ricezione dati dagli User Agent
✅ Buffering locale con retry automatico
✅ Supporto multi-site
✅ Crittografia TLS

Architettura

┌─────────────────────────────────────────────────────────────────┐
│                      Corellix Collector                         │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │                    HTTP Listener (:5050)                  │  │
│  │               Riceve dati dagli User Agent                │  │
│  └───────────────────────────────────────────────────────────┘  │
│                                                                 │
│  ┌─────────────────────┐     ┌─────────────────────┐           │
│  │  Citrix Collector   │     │  Nutanix Collector  │           │
│  │  - Sessions         │     │  - VMs              │           │
│  │  - Machines         │     │  - Hosts            │           │
│  │  - Delivery Groups  │     │  - Clusters         │           │
│  └──────────┬──────────┘     └──────────┬──────────┘           │
│             └──────────────┬────────────┘                       │
│                            ▼                                    │
│  ┌───────────────────────────────────────────────────────────┐  │
│  │                    Buffer Locale                          │  │
│  │              (SQLite per retry automatico)                │  │
│  └───────────────────────────────────────────────────────────┘  │
│                            │                                    │
└────────────────────────────┼────────────────────────────────────┘
                             │ HTTPS
                             ▼
                    ┌─────────────────┐
                    │   API Gateway   │
                    └─────────────────┘

Installazione

Windows Service

# Scarica ed estrai il pacchetto
Expand-Archive CorellixCollector-1.5.0.zip -DestinationPath "C:\Program Files\Corellix\Collector"

# Configura il servizio
cd "C:\Program Files\Corellix\Collector"
.\install-service.bat

Docker

docker run -d \
  --name corellix-collector \
  -p 5050:5050 \
  -e API_GATEWAY_URL="https://api.corellix.io" \
  -e TENANT_ID="your-tenant-id" \
  -e API_KEY="your-api-key" \
  corellix/collector:1.5.0

Configurazione

appsettings.json

{
  "CollectorSettings": {
    "ListenPort": 5050,
    "ApiGatewayUrl": "https://api.corellix.io",
    "TenantId": "your-tenant-id",
    "ApiKey": "your-api-key",
    "PollingIntervalSeconds": 60,
    "BufferPath": "./buffer",
    "EnableTls": true
  },
  "CitrixSettings": {
    "Enabled": true,
    "DeliveryController": "ddc.domain.com",
    "UseServiceAccount": true
  },
  "NutanixSettings": {
    "Enabled": false,
    "PrismCentralUrl": "https://prism.domain.com:9440",
    "Username": "admin",
    "PasswordEnvVar": "NUTANIX_PASSWORD"
  }
}

Parametri

Parametro	Descrizione	Default
`ListenPort`	Porta HTTP per User Agent	5050
`ApiGatewayUrl`	URL dell’API Gateway	-
`TenantId`	ID del tenant	-
`ApiKey`	Chiave API	-
`PollingIntervalSeconds`	Intervallo polling Citrix/Nutanix	60
`EnableTls`	Abilita HTTPS	true

Dati Raccolti

Da Citrix

Sessioni attive (utente, macchina, stato)
Macchine (nome, catalogo, stato)
Delivery Groups
Applicazioni pubblicate
Metriche di performance

Da Nutanix

Virtual Machines
Host
Cluster
Storage
Metriche di utilizzo

Da User Agent

Applicazioni in uso per sessione
Connessioni TCP stabilite
Informazioni sulla workstation

Monitoraggio

Health Endpoint

GET http://collector:5050/health

{
  "status": "Healthy",
  "version": "1.5.0",
  "uptime": "2d 14h 32m",
  "lastSync": "2025-12-19T10:30:00Z",
  "buffer": {
    "pending": 0,
    "failed": 0
  }
}

Metriche Prometheus

GET http://collector:5050/metrics

Troubleshooting

Il Collector non si connette a Citrix

Verifica le credenziali del service account
Controlla che il Delivery Controller sia raggiungibile
Verifica i permessi Citrix (Read-Only Administrator)

Dati non arrivano all’API Gateway

Verifica la connettività HTTPS verso l’API Gateway
Controlla che TenantId e ApiKey siano corretti
Verifica il buffer locale per messaggi in coda

User Agent non si connette

Verifica che la porta 5050 sia aperta nel firewall
Controlla che il Collector sia in ascolto: netstat -an | findstr 5050