Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Monitoraggio con metriche di telemetria del server
Amazon GameLift Serverspuò essere configurato per raccogliere e pubblicare metriche di telemetria per i server di gioco in esecuzione su flotte gestite di Amazon EC2 e Container. Queste metriche diventano disponibili dopo aver implementato il raccoglitore di telemetria con la build del server. Il sistema di metriche supporta tutti SDKs (C\$1\$1, C\$1, Go), tutti i plugin (Unreal, Unity) e il Game Server Wrapper. Amazon GameLift Servers I dati delle metriche vengono trasferiti ad [Amazon Managed Service for [Monitora Amazon GameLift Servers con Amazon CloudWatch](monitoring-cloudwatch.md) Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html) e alle dashboard di [Amazon Managed](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) Grafana (consigliate per la visualizzazione).
![\[metriche di telemetria\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/images/telemetry_metrics.png)
## Vantaggi delle metriche di telemetria
Il sistema di metriche di telemetria offre cinque vantaggi chiave:
+ **Metriche specifiche del motore di gioco**: i plug-in del motore di gioco (Unreal, Unity) forniscono un'integrazione nativa con metriche prestazionali specifiche del motore, come il tick time del server, il frame rate e l'utilizzo delle risorse a livello di motore, fondamentali per l'ottimizzazione delle prestazioni di gioco.
+ **Supporto per metriche personalizzate**: definisci e monitora le tue metriche specifiche del gioco utilizzando le chiamate alle funzioni SDK del server per monitorare eventi di gioco personalizzati, prestazioni di business logic e punti dati specifici dell'applicazione importanti per il tuo gioco.
+ **Raccolta automatizzata**: le metriche fluiscono automaticamente dopo l'implementazione del raccoglitore di telemetria senza bisogno di strumentazione aggiuntiva e integrazione diretta con Amazon Managed [Service](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html) per Prometheus e Amazon. CloudWatch
+ **Monitoraggio a più livelli: metriche a livello** di flotta per capacità e scalabilità, metriche a livello di istanza per l'utilizzo delle risorse e metriche delle sessioni di gioco per il monitoraggio delle prestazioni.
+ **Compatibilità universale:** funziona con tutti gli ambienti di sviluppo Amazon GameLift Servers supportati, è integrato con tutti i server e supporta nativamente i plugin dei motori di gioco. SDKs
**Nota**
Le metriche di telemetria sono disponibili per le flotte gestite di Amazon GameLift Servers Amazon EC2 o container che eseguono Amazon Linux 2023 o Windows.
## Prima di iniziare
### Risorse richieste AWS
+ AWS account configurato perAmazon GameLift Servers.
+ Flotta gestita in esecuzione su:
+ Amazon EC2 con sistemi operativi supportati, OPPURE
+ Contenitori con Amazon Linux 2023
+ Autorizzazioni IAM appropriate
### Requisiti IAM
Le seguenti autorizzazioni IAM sono richieste solo se prevedi di utilizzare il servizio corrispondente:
+ **[Amazon Managed Service for Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html)** (richiesto solo se si pubblicano metriche su Prometheus)
+ Autorizzazione `aps:RemoteWrite`
+ Accesso al tuo spazio di lavoro Prometheus
+ **Amazon CloudWatch** (richiesto solo se si pubblicano metriche su Amazon CloudWatch)
+ Autorizzazione `cloudwatch:PutMetricData`
+ Accesso ai namespace delle metriche
+ **[Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html)** (richiesto solo se si utilizzano le dashboard Grafana)
+ Autorizzazione `grafana:Read`
+ Configurazione SSO per l'accesso alla dashboard
# Implementazione
Seleziona il percorso di implementazione in base al tuo ambiente di sviluppo:
## Implementazione SDK
| Tipo SDK | Configurazione SDK | Parametri personalizzati | Documentazione di riferimento delle API |
| --- | --- | --- | --- |
| Vai a SDK | [Guida completa alla configurazione](https://github.com/amazon-gamelift/amazon-gamelift-servers-go-server-sdk/blob/main/telemetry-metrics/METRICS.md) | [API Go Metrics](https://github.com/amazon-gamelift/amazon-gamelift-servers-go-server-sdk/blob/main/telemetry-metrics/CUSTOM_METRICS.md) | [Azioni e tipi di dati Go](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-server-sdk-go-actions.html) |
| SDK C\$1 | [Guida completa alla configurazione](https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk/blob/main/telemetry-metrics/METRICS.md) | [API C\$1 Metrics](https://github.com/amazon-gamelift/amazon-gamelift-servers-csharp-server-sdk/blob/main/telemetry-metrics/CUSTOM_METRICS.md) | [Azioni e tipi di dati C\$1](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-server-sdk5-csharp-actions.html) |
| SDK C\$1\$1 | [Guida completa alla configurazione](https://github.com/amazon-gamelift/amazon-gamelift-servers-cpp-server-sdk/blob/main/telemetry-metrics/METRICS.md) | [API C\$1\$1 Metrics](https://github.com/amazon-gamelift/amazon-gamelift-servers-cpp-server-sdk/blob/main/telemetry-metrics/CUSTOM_METRICS.md) | [Azioni e tipi di dati C\$1\$1](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-server-sdk5-cpp-actions.html) |
## implementazione del plugin
| Plug-in | Configurazione del plugin | Parametri personalizzati | Documentazione di riferimento delle API |
| --- | --- | --- | --- |
| Irreale | [Guida completa alla configurazione](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unreal/blob/main/TelemetryMetrics/METRICS.md) | [API Unreal Metrics](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unreal/blob/main/TelemetryMetrics/CUSTOM_METRICS.md) | [Azioni e tipi di dati irreali](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-server-sdk5-unreal-actions.html) |
| Unità | [Guida alla configurazione completa](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unity/blob/main/TelemetryMetrics/METRICS.md) | [API Unity Metrics](https://github.com/amazon-gamelift/amazon-gamelift-plugin-unity/blob/main/TelemetryMetrics/CUSTOM_METRICS.md) | [Azioni e tipi di dati C\$1](https://docs.aws.amazon.com/gamelift/latest/developerguide/integration-server-sdk5-csharp-actions.html) |
## Workflow di implementazione
Ogni implementazione segue un processo in due fasi:
1. **Guida completa all'installazione (Metrics.md)**: implementazione dell'infrastruttura, configurazione dell' AWS infrastruttura, configurazione della flotta e configurazione del dashboard Grafana.
1. **Guida all'implementazione dell'API (Custom\$1metrics.md)**: utilizzo dell'SDK specifico per lingua, tipi di metriche, creazione di metriche personalizzate e configurazione avanzata.
### Verifica
1. Convalida il flusso dei parametri controllando l'[area di lavoro di Amazon Managed Service for Prometheus](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html) o la console Amazon per verificare la presenza di dati di telemetria in entrata. CloudWatch
1. Verifica la visibilità del pannello di controllo in [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) utilizzando i dashboard predefiniti.
1. Testa le metriche personalizzate verificando che compaiano nelle dashboard di monitoraggio.
**Nota**
Dopo aver completato l'implementazione, torna a questa pagina e vai alla pagina Metriche [disponibili](gamelift-servers-metrics-types.md).
# Metriche disponibili
Le metriche si dividono in tre categorie:
+ Metriche raccolte automaticamente
+ Metriche fornite da SDK
+ parametri personalizzati
## Raccolta automatica di metriche
Non sono necessarie modifiche al codice per queste metriche:
### Parametri dell'istanza
| Tipo di metrica | Description | Caso d'uso |
| --- | --- | --- |
| CPU | Percentuale di utilizzo per istanza | Monitoraggio delle risorse |
| Memoria | Utilizzo e percentuale della memoria fisica | Pianificazione della capacità |
| I/O di rete | Byte e pacchetti inviati/ricevuti | Stato della connessione |
| I/O del disco | Operazioni e velocità effettiva di lettura/scrittura | Prestazioni di archiviazione |
### Metriche della flotta
| Tipo di metrica | Description | Caso d'uso |
| --- | --- | --- |
| Istanze attive | Conteggio delle istanze in esecuzione | Scalabilità del parco veicoli |
| Sessioni di gioco | Sessioni attive e disponibili | Gestione della capacità |
| Sessioni di gioco interrotte | Sessioni di gioco che si sono bloccate | Monitoraggio degli errori |
## Metriche fornite dall'SDK
Richiede chiamate alle funzioni SDK nel codice:
### Metriche di temporizzazione del server
| Metrica | Description | Implementazione |
| --- | --- | --- |
| Delta Time del server | Differenza di tempo tra il segno di spunta corrente del server e il segno di spunta del server precedente. Misura la coerenza del tick rate del server | Chiama GetDeltaTime () |
| Tick Rate del server | Mostra il numero di volte al secondo in cui il server elabora gli aggiornamenti | Calcolato automaticamente |
| Orario di selezione del server | Il tempo impiegato dal server per elaborare un singolo segno di spunta o aggiornamento | Chiama GetTickTime () |
| Server World Tick Time | Il tempo impiegato dal server per aggiornare il mondo di gioco con ogni segno di spunta | Chiama GetWorldUpdateTime () |
**Implementazione:** per chi è indipendente dal motore SDKs (C\$1\$1, C\$1, Go), implementa queste metriche richiamando le funzioni SDK dal loop di gioco con valori di temporizzazione calcolati. Per i plugin del motore (Unreal, Unity), queste metriche vengono acquisite automaticamente tramite l'integrazione del motore.
### Metriche di rete
| Metrica | Description | Implementazione |
| --- | --- | --- |
| Connessioni | Il numero totale di connessioni di rete stabilite dal server | Automatico dopo InitMetrics () |
| Rete I/O (byte) | Il numero totale di byte inviati e ricevuti dal server sulla rete | Automatico dopo InitMetrics () |
| Rete I/O (pacchetti) | Il numero totale di pacchetti di rete inviati e ricevuti dal server | Automatico dopo InitMetrics () |
| Perdita di pacchetti | La percentuale di pacchetti di rete che vengono persi durante la trasmissione | Automatico dopo InitMetrics () |
**Implementazione:** integra le chiamate alle funzioni SDK con la tua libreria di rete. L'SDK fornisce indicazioni per diverse implementazioni di rete.
### Parametri di elaborazione
| Metrica | Description | Implementazione |
| --- | --- | --- |
| Utilizzo della CPU (%) | La percentuale di risorse della CPU utilizzate dal processo del server di gioco | Automatico dopo InitMetrics () |
| Utilizzo della memoria (unità) | La quantità totale di memoria consumata dai processi del server | Automatico dopo InitMetrics () |
| Utilizzo della memoria fisica (%) | La percentuale della memoria fisica totale del server attualmente utilizzata | Automatico dopo InitMetrics () |
| Stato del server | Stato di integrità del server di gioco | Automatico dopo InitMetrics () |
**Implementazione:** queste metriche vengono raccolte automaticamente dall'SDK per ogni processo di sessione di gioco.
#### Organizzazione del pannello di controllo per processo
Le metriche per processo sono disponibili in due dashboard specializzati:
+ **Dashboard delle prestazioni** del server: contiene gli orari del server (delta time, tick rate, tick time, world tick time), le metriche di rete (connessioni, I/O byte/pacchetti, perdita di pacchetti), l'utilizzo della memoria e l'utilizzo della CPU per le singole sessioni di gioco.
+ **Dashboard delle prestazioni dell'istanza**: include le tabelle «Le migliori N sessioni di gioco che consumano la memoria» e le «N sessioni di gioco che consumano più CPU» che aiutano a identificare i processi che contribuiscono maggiormente al consumo di risorse dell'istanza. Facendo clic sui collegamenti alle sessioni di gioco è possibile eseguire un'analisi più approfondita delle metriche dettagliate.
#### Casi d'uso delle metriche per processo
Le per-game-session metriche per processo/ supportano i seguenti scenari di monitoraggio:
+ **Analisi approfondita delle prestazioni**: quando le prestazioni di a sono peggiorate a causa di processi o sessioni di gioco specifici, le metriche per processo aiutano a identificare quale processo host/instance ha causato il problema nelle tabelle delle sessioni di gioco che consumano più CPU e memoria.
+ **Indagine sugli arresti anomali di un server** di gioco: quando una sessione di gioco si blocca, queste metriche aiutano a determinare se l'arresto è dovuto a esaurimento della memoria, sovraccarico della CPU o problemi di larghezza di banda della rete.
+ **Analizza i problemi segnalati dai giocatori**: quando i giocatori segnalano ritardi o interruzioni durante il gioco, le metriche basate sui singoli processi aiutano a identificare i punti deboli nella CPU, nella memoria, nella rete, nel tempo di tick o nel tempo di aggiornamento globale.
+ **Identifica le variazioni delle prestazioni nelle diverse build: le** metriche relative al tempo di tick, alla frequenza di tick e al tempo di aggiornamento mondiale consentono agli sviluppatori di misurare come cambiano le prestazioni di gioco su diverse build di server.
+ **Rileva ritardi e rallentamenti nel gameplay: le** metriche relative al tempo di tick, alla frequenza di tick e al tempo di aggiornamento mondiale riflettono la velocità con cui il server aggiorna il gioco, con un impatto diretto sull'esperienza del cliente.
+ **Analisi comparativa**: identifica in che modo i diversi scenari di gioco influiscono sulle prestazioni del server in base a fattori come il numero di giocatori, la modalità di gioco e altre variabili.
## Organizzazione del pannello di controllo
Le metriche sono organizzate in dashboard specializzate in [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) per diversi scenari di monitoraggio. Le dashboard disponibili dipendono dal tipo di flotta:
### EC2 Dashboard della flotta
+ **EC2 Dashboard panoramica della flotta**: capacità della flotta di alto livello, informazioni sulla scalabilità, giocatori simultanei (CCU), istanze, capacità dei giocatori e sessioni di gioco interrotte.
+ **Dashboard di panoramica delle istanze**: metriche aggregate a livello di host per tutte le istanze, tra cui l'utilizzo medio di CPU, memoria, rete e disco.
+ **Dashboard delle prestazioni delle istanze**: metriche dettagliate per le singole istanze con le tabelle «Le migliori N sessioni di gioco che consumano memoria» e «Le N sessioni di gioco che consumano più CPU» per identificare i processi che richiedono molte risorse.
+ **Dashboard delle prestazioni del server (EC2)**: tempistica dei loop di gioco, prestazioni di rete, memoria e parametri della CPU per le singole sessioni di gioco su istanze. EC2
### Dashboard Container Fleet
+ **Dashboard di panoramica sulla flotta di container**: panoramica di alto livello sull'utilizzo delle risorse della flotta di container, inclusa la prenotazione della CPU, l'utilizzo della memoria e lo stato del gruppo di container.
+ **Dashboard delle prestazioni dei container**: metriche dettagliate per i singoli contenitori nell'ambito di attività ECS specifiche, tra cui utilizzo della CPU, utilizzo della memoria, I/O di rete e prestazioni di archiviazione.
+ **Dashboard delle prestazioni del server (Container)**: tempistica dei loop di gioco, prestazioni di rete, memoria e parametri della CPU per le singole sessioni di gioco in contenitori.
Per informazioni dettagliate sulla dashboard e istruzioni per l'uso, consulta. [Organizzazione e utilizzo del pannello di controllo](gamelift-servers-metrics-dashboards.md)
# Come funziona
Il sistema di metriche di telemetria segue un semplice flusso di dati in quattro fasi dai server di gioco ai dashboard di visualizzazione.
**Raccolta:** il tuo server di gioco, integrato con l'SDK o il plug-in GameLift Server, invia automaticamente le metriche a un raccoglitore di telemetria locale in esecuzione sulla stessa istanza. L'SDK acquisisce sia metriche automatiche (ciclo di vita del server, utilizzo delle risorse) sia metriche personalizzate definite nel codice.
**Elaborazione:** il raccoglitore di telemetria aggrega le metriche del server di gioco e le combina con i dati sulle prestazioni a livello di istanza (CPU, memoria, rete, utilizzo del disco). Ciò fornisce un quadro completo delle prestazioni del gioco e dell'infrastruttura sottostante.
**Archiviazione:** le metriche elaborate vengono esportate nel magazzino di metriche di tua scelta: [Amazon Managed Service for Prometheus per lo storage di serie temporali ad alte prestazioni, Amazon per l'](https://docs.aws.amazon.com/prometheus/latest/userguide/what-is-Amazon-Managed-Service-Prometheus.html)integrazione dei servizi o entrambi. CloudWatch AWS Tutte le trasmissioni di dati sono autenticate e crittografate.
**Visualizzazione:** [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html) si collega al tuo magazzino di metriche per visualizzare dashboard predefinite. GameLift Queste dashboard forniscono panoramiche della flotta, dettagli sulle prestazioni dei server e visualizzazioni di monitoraggio dei container che ti aiutano a monitorare e risolvere i problemi della tua infrastruttura di hosting dei giochi.
**Nota**
Tutte le trasmissioni metriche tra il server di gioco e il raccoglitore di telemetria avvengono localmente sull'istanza per motivi di sicurezza. Solo il raccoglitore comunica con i servizi utilizzando l'autenticazione corretta. AWS
# Organizzazione e utilizzo del pannello di controllo
Visualizza le tue metriche su dashboard complete in [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html). Le dashboard disponibili dipendono dal tipo di flotta:
## Disponibilità del pannello di controllo per tipo di flotta
La tabella seguente mostra quali dashboard sono disponibili per ogni tipo di flotta:
| Pannello di controllo | Tipo di parco istanze | Description |
| --- | --- | --- |
| EC2 Panoramica della flotta | EC2 Flotta | Visualizza informazioni sui giocatori simultanei (CCU), sulle istanze e sulla capacità dei giocatori |
| Panoramica delle istanze | EC2 Flotta | Visualizza l'utilizzo medio di CPU, memoria e rete in tutte le istanze del parco istanze |
| Prestazioni dell'istanza | EC2 Flotta | Visualizza metriche dettagliate (CPU, memoria, disco, rete) per una singola istanza |
| Panoramica della flotta di container | Flotta di container | Visualizza l'utilizzo medio delle risorse di tutti i container in una flotta di container gestita |
| Prestazioni dei container | Flotta di container | Visualizza metriche dettagliate dei singoli contenitori all'interno di un'attività ECS specifica |
| Prestazioni del server | Entrambi | Visualizza le prestazioni di rete, memoria e runtime di uno specifico processo del server di gioco (versioni separate per flotte di container EC2 e flotte) |
** EC2 Flotte gestite:**
+ EC2 La panoramica della flotta fornisce informazioni di alto livello sulla capacità della flotta e sulla scalabilità.
+ Utilizza le dashboard Instances Overview e Instance Performance per il monitoraggio a livello di host.
+ Metriche raccolte tramite il ricevitore hostmetrics per la visibilità a livello di sistema.
+ Concentrati sull'utilizzo e sulle prestazioni delle risorse dell' EC2 istanza.
+ Server Performance (EC2) monitora le metriche delle applicazioni dei server di gioco indipendentemente dall'infrastruttura sottostante.
**Flotte di container gestite:**
+ Utilizza i dashboard Container Fleet Overview e Container Performance per il monitoraggio delle attività ECS e a livello di container.
+ Metriche raccolte tramite ECS Container Receiver per la visibilità dei carichi di lavoro containerizzati.
+ Concentrati sull'aggregazione a livello di attività e sull'isolamento delle risorse dei container.
+ Server Performance (Container) monitora le metriche delle applicazioni dei server di gioco indipendentemente dall'infrastruttura sottostante.
## EC2 Dashboard di panoramica della flotta
Questa dashboard offre una panoramica di alto livello dell'utilizzo e della capacità della flotta a livello globale e per località. Presenta grafici che mostrano il conteggio degli arresti, degli avvii e degli arresti anomali dei server di gioco, nonché la percentuale di server di gioco sani. Puoi filtrare per FleetID e Location.
### Metriche di panoramica della flotta
La tabella seguente mostra le metriche disponibili nella dashboard Fleet Overview:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/gamelift-servers-metrics-dashboards.html)
**Nota**
Le metriche CCU richiedono l'implementazione nel codice del server di gioco. Queste metriche non vengono raccolte automaticamente e devono essere implementate e riportate dall'applicazione.
## Panoramica delle istanze (dashboard)
Questa dashboard fornisce metriche aggregate a livello di host per tutte le istanze del parco istanze. Le medie attuali mostrano lo stato generale delle istanze. Quando le prestazioni peggiorano, controlla l'utilizzo della CPU, il consumo di memoria, la rete e il consumo del disco per individuare eventuali colli di bottiglia. Puoi filtrare per FleetID e Location.
### Panoramica delle istanze (metriche)
La tabella seguente mostra le metriche disponibili nella dashboard di panoramica delle istanze:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/gamelift-servers-metrics-dashboards.html)
**Nota**
Le metriche a livello di istanza vengono raccolte tramite il ricevitore hostmetrics e forniscono visibilità a livello di sistema sulle prestazioni dell'infrastruttura del parco macchine. Utilizza questa dashboard per identificare le tendenze generali sullo stato della flotta e analizzare i singoli casi in cui vengono rilevati problemi di prestazioni.
## Dashboard delle prestazioni delle ist
Questa dashboard fornisce metriche dettagliate sulle prestazioni per le singole istanze. Le medie attuali mostrano lo stato generale dell'istanza. Quando le prestazioni peggiorano, controlla l'utilizzo della CPU, della memoria e del file system per individuare eventuali colli di bottiglia. Presenta le tabelle «Top N Memory Consuming Game Sessions» e «Top N CPU Consuming Game Sessions» che aiutano a identificare i processi che contribuiscono maggiormente al consumo di risorse delle istanze. Facendo clic sui collegamenti alle sessioni di gioco è possibile eseguire un'analisi più approfondita delle metriche dettagliate. Puoi filtrare in base a un ID di istanza specifico.
### Metriche delle prestazioni dell'istanza
La tabella seguente mostra le metriche disponibili nella dashboard delle prestazioni delle istanze:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/gamelift-servers-metrics-dashboards.html)
**Nota**
Le tabelle Top N Memory and CPU Game Sessions sono essenziali per identificare i punti deboli in termini di prestazioni e i processi che richiedono molte risorse e che possono influire sulle prestazioni complessive dell'istanza. Queste classiifiche consentono di identificare rapidamente le sessioni di gioco problematiche per ulteriori indagini.
## Dashboard di panoramica sulla flotta di container
Questa dashboard offre una panoramica di alto livello dell'utilizzo delle risorse e della capacità della flotta di container. Visualizza l'utilizzo medio delle risorse di tutti i container in una flotta di container gestita, inclusa la prenotazione della CPU, l'utilizzo della memoria e lo stato del gruppo di container. Puoi filtrare per FleetID e Location.
### Metriche di panoramica sulla flotta di container
La tabella seguente mostra le metriche disponibili nella dashboard di Container Fleet Overview:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/gamelift-servers-metrics-dashboards.html)
**Nota**
Le metriche della flotta di container vengono raccolte tramite ECS Container Receiver e forniscono una visibilità del carico di lavoro containerizzata con particolare attenzione all'aggregazione a livello di attività e all'isolamento delle risorse dei container.
## Dashboard delle prestazioni dei container
Questa dashboard fornisce metriche dettagliate sulle prestazioni per i singoli contenitori all'interno di attività ECS specifiche. Visualizza metriche dettagliate dei singoli contenitori, tra cui l'utilizzo della CPU, l'utilizzo della memoria, l'I/O di rete e le prestazioni di archiviazione. È possibile filtrare per ID contenitore o attività ECS specifici.
### Metriche relative alle prestazioni dei container
La tabella seguente mostra le metriche disponibili nella dashboard Container Performance:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/gamelift-servers-metrics-dashboards.html)
**Nota**
Le metriche delle prestazioni dei container forniscono una visibilità dettagliata sul consumo di risorse dei singoli container e sulle caratteristiche prestazionali all'interno delle attività ECS.
## Dashboard delle prestazioni del server
La dashboard Server Performance mostra le metriche relative ai tempi del server, all'attività di rete, alla memoria e all'utilizzo della CPU per le singole sessioni di gioco. Puoi filtrare in base all'ID della sessione di gioco ed esportare le metriche direttamente su Amazon CloudWatch o [Amazon Managed Grafana](https://docs.aws.amazon.com/grafana/latest/userguide/what-is-Amazon-Managed-Service-Grafana.html).
### Metriche sulle prestazioni del server
La tabella seguente mostra le metriche disponibili nel pannello di controllo delle prestazioni del server:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/gameliftservers/latest/developerguide/gamelift-servers-metrics-dashboards.html)
# Scenari di monitoraggio comuni
## Approfondisci le indagini sulle prestazioni
**Scenario:** A host/instance presenta prestazioni ridotte a causa di processi o sessioni di gioco specifici
**Fasi dell'indagine:**
+ Accedi alla dashboard delle prestazioni delle istanze.
+ Consulta la tabella «Le migliori N sessioni di gioco che consumano memoria» per identificare quali processi contribuiscono maggiormente al consumo di memoria delle istanze.
+ Consulta la tabella «Le N principali sessioni di gioco che consumano CPU» per identificare quali processi contribuiscono maggiormente all'utilizzo della CPU dell'istanza.
+ Fai clic sui link delle sessioni di gioco per consentire un'analisi più approfondita delle metriche dettagliate.
+ Analizza gli orari dei server (Server Delta Time, Server Tick Rate, Server Tick Time, Server World Tick Time) per identificare i punti deboli nelle prestazioni.
## Indagine sugli incidenti dei server di gioco
**Scenario:** una sessione di gioco si è bloccata ed è necessario determinarne la causa principale
**Fasi dell'indagine:**
+ Accedi alla dashboard delle prestazioni del server per la sessione di gioco interrotta.
+ Controlla l'utilizzo della memoria (unità) e l'utilizzo della memoria fisica (%) per determinare se l'arresto anomalo è dovuto all'esaurimento della memoria.
+ Controlla l'utilizzo della CPU (%) per identificare se il crash è stato causato dal sovraccarico della CPU.
+ Analizza la rete I/O (byte) e la rete I/O (pacchetti) per determinare se i problemi di larghezza di banda della rete hanno contribuito al crash.
+ Esamina la percentuale di perdita di pacchetti per identificare i problemi relativi alla rete.
## Esamina i problemi segnalati dai giocatori
**Scenario:** i giocatori segnalano ritardi o interruzioni durante il gioco
**Fasi dell'indagine:**
+ Accedi alla dashboard delle prestazioni del server per la sessione di gioco interessata.
+ Consulta Server Tick Time e Server World Tick Time per identificare i ritardi negli aggiornamenti del gioco.
+ Controlla Server Tick Rate per garantire una frequenza di aggiornamento costante del server.
+ Analizza l'utilizzo della CPU (%) per identificare i colli di bottiglia nell'elaborazione.
+ Rivedi le metriche di utilizzo della memoria per identificare i problemi di prestazioni relativi alla memoria.
+ Controlla le I/O metriche di rete e la perdita di pacchetti per identificare i punti deboli della rete.
## Identifica le variazioni delle prestazioni nelle diverse build di server di gioco
**Scenario:** vuoi misurare come cambiano le prestazioni di gioco tra diverse build di server
**Fasi dell'indagine:**
+ Confronta le metriche di Server Tick Time tra diverse build per misurare le variazioni dell'efficienza di elaborazione.
+ Analizza la coerenza del Server Tick Rate tra le build per identificare le regressioni delle prestazioni.
+ Consulta Server World Tick Time per misurare i cambiamenti nelle prestazioni degli aggiornamenti del mondo di gioco.
+ Confronta i modelli di utilizzo della memoria tra le build per identificare miglioramenti o regressioni dell'ottimizzazione della memoria.
+ Monitora le tendenze di utilizzo della CPU per valutare le variazioni dell'efficienza computazionale.
## Rileva ritardi e rallentamenti nel gameplay
**Scenario:** devi monitorare la reattività del server e la velocità di aggiornamento del gioco
**Fasi dell'indagine:**
+ Monitora il Tick Time del server per misurare la velocità con cui il server elabora ogni ciclo di aggiornamento.
+ Tieni traccia della frequenza di selezione del server per garantire aggiornamenti costanti allo stato del gioco al secondo.
+ Analizza Server World Tick Time per misurare la velocità di aggiornamento del mondo di gioco, che influisce direttamente sull'esperienza del cliente.
+ Imposta avvisi per le variazioni del Delta Time del server per rilevare prestazioni incoerenti del server.
## Analisi comparativa di diversi scenari di gioco
**Scenario:** vuoi identificare in che modo i diversi scenari di gioco influiscono sulle prestazioni del server
**Fasi dell'indagine:**
+ Confronta le metriche delle prestazioni del server in base al numero di giocatori diversi per comprendere l'impatto della scalabilità.
+ Analizza le differenze di prestazioni tra le modalità di gioco utilizzando le metriche Server Tick Time e CPU Usage.
+ Monitora i modelli di utilizzo della memoria in diversi scenari di gioco per identificare le funzionalità che richiedono molte risorse.
+ Tieni traccia delle I/O metriche di rete per comprendere i requisiti di larghezza di banda per diversi scenari di gioco.
+ Usa la dashboard Instance Performance per identificare quali scenari di gioco producono le sessioni di gioco che consumano più risorse.
## Risposta a un elevato utilizzo delle risorse
**Scenario:** picchi di risorse insoliti (CPU > 85%, memoria > 90%)
**Fasi dell'indagine:**
### Identifica le risorse interessate
+ Usa l' DescribeGameSessionDetails API.
+ Filtra per stato, se necessario.
+ Documenta le istanze interessate.
### Analizza l'utilizzo delle risorse
+ Consulta la dashboard di panoramica delle istanze.
+ Confronta l'utilizzo in tutta la flotta.
+ Controlla i modelli storici.
### Monitora l'impatto sui server di gioco
+ Controlla le metriche delle prestazioni del server.
+ Controlla i tempi di verifica e la perdita di pacchetti.
+ Monitora le perdite di memoria.
### Passaggi di risoluzione
+ Scarica i registri delle sessioni.
+ Risolvi i problemi di compilazione.
+ Monitora i miglioramenti.
## Analisi dei crash del server di gioco
**Scenario:** più sessioni di gioco con stato di errore in tutta la flotta
**Fasi dell'indagine:**
### Valutazione iniziale
+ Accedi alla dashboard di panoramica della flotta.
+ Rivedi la tabella delle sessioni bloccate.
+ Annota gli schemi in termini di tempistica/luogo.
### Analisi delle prestazioni
+ Controlla le metriche di temporizzazione del server.
+ Esamina l'utilizzo delle risorse.
+ Monitora le prestazioni della rete.
### Revisione dell'infrastruttura
+ Verifica la capacità della flotta.
+ Controlla lo stato dell'istanza.
+ Rivedi le politiche di scalabilità.
### Percorso di risoluzione
+ Analizza i log del server.
+ Ottimizzazione del codice di revisione.
+ Implementa correzioni.
## Ottimizzazione della capacità della flotta
**Scenario:** lancio del gioco o studio di benchmark
**Fasi dell'analisi:**
### Utilizzo delle risorse
+ Filtra per località.
+ Esamina le metriche P50/P95/P99.
+ Analizza i modelli di utilizzo.
### Analisi del tipo di istanza
+ Confronta le prestazioni per tipo.
+ Identifica candidati scalabili.
+ Modelli di utilizzo dei documenti.
### Azioni di ottimizzazione
+ Modifica le politiche di scalabilità.
+ Modifica i tipi di istanza.
+ Aggiorna la configurazione del parco veicoli.
# Guida alla risoluzione dei problemi
## Problemi comuni e passaggi di risoluzione
### Metriche mancanti o incomplete
#### Caratteristiche
+ Nessuna metrica visualizzata nei dashboard.
+ Raccolta metrica parziale.
+ Aggiornamenti delle metriche ritardati.
#### Passaggi di risoluzione
##### A. Verifica lo stato del raccoglitore
Controlla il servizio systemd:
```
sudo systemctl status gamelift-telemetry-collector
```
Rivedi i log di Collector:
```
sudo journalctl -u gamelift-telemetry-collector
```
+ Conferma la configurazione del raccoglitore.
##### B. Verifica dell'autorizzazione IAM
+ Controlla le autorizzazioni del ruolo dell'istanza.
+ Verifica le politiche richieste:
+ `aps:RemoteWrite`
+ `cloudwatch:PutMetricData`
+ Convalida le relazioni di fiducia tra i ruoli.
##### C. Connettività di rete
+ Verificare l'accesso agli endpoint.
+ Controlla le regole del gruppo di sicurezza.
+ Rivedi la rete ACLs.
### Errori di autenticazione
#### Caratteristiche
+ Errori di autenticazione SigV4.
+ Accesso negato ai messaggi.
+ Problemi di aggiornamento delle credenziali.
#### Passaggi di risoluzione
##### A. Autenticazione SigV4
+ Verifica le credenziali temporanee.
+ Controlla la rotazione delle credenziali.
+ Convalida il profilo dell'istanza.
##### B. Accesso AMP
+ Rivedi la configurazione dell'area di lavoro.
+ Verifica l'URL di scrittura remota.
+ Controlla le associazioni di ruolo IAM.
### Problemi con la dashboard
#### Caratteristiche
+ Dashboard vuoti.
+ Punti dati mancanti.
+ Errori di autenticazione.
#### Passaggi di risoluzione
##### A. Configurazione della fonte di dati
+ Verifica la connessione con Prometheus.
+ Verifica CloudWatch l'integrazione con Amazon.
+ Verifica le autorizzazioni delle fonti di dati.
##### B. Accesso a Grafana
+ Conferma la configurazione SSO.
+ Se necessario, verifica la configurazione 2FA.
+ Controlla le autorizzazioni degli utenti.
### Problemi specifici di Windows
#### Caratteristiche
+ Errori di avvio del servizio.
+ Lacune di raccolta metriche.
+ Errori di autorizzazione.
#### Passaggi di risoluzione
+ Verifica lo stato del servizio Windows.
+ Controlla i registri degli eventi di Windows.
+ Controlla la configurazione del raccoglitore.
+ Convalida i percorsi specifici di Windows.