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à.

# Risolvere gli errori delle sessioni
<a name="notebooks-spark-troubleshooting-sessions"></a>

Utilizzare le informazioni in questa sezione per risolvere i problemi relativi alle sessioni.

Quando si verifica un errore di configurazione personalizzato durante l'avvio di una sessione, la console Athena for Spark mostra un banner con un messaggio di errore. Per risolvere gli errori di avvio della sessione, puoi controllare la modifica dello stato della sessione o le informazioni di registrazione.

## Visualizzare informazioni sulla modifica dello stato della sessione
<a name="notebooks-spark-troubleshooting-sessions-viewing-session-state-change"></a>

Puoi ottenere dettagli sulla modifica dello stato della sessione dall'editor di notebook Athena o dall'API Athena.

**Per visualizzare le informazioni sullo stato della sessione nella console Athena**

1. Nell'editor notebook di Athena, nel menu **Sessione** in alto a destra, scegli **Vedi dettagli**.

1. Visualizza la scheda **Sessione corrente**. La sezione **Informazioni sessione** mostra informazioni come l'ID della sessione, il gruppo di lavoro, lo stato e il motivo del cambio di stato.

   La seguente schermata d'esempio mostra le informazioni nella sezione **Motivo modifica stato** della finestra di dialogo **Informazioni sessione** per un errore di sessione Spark in Athena.  
![\[Visualizzazione delle informazioni sulla modifica dello stato della sessione nella console Athena for Spark.\]](http://docs.aws.amazon.com/it_it/athena/latest/ug/images/notebooks-spark-custom-jar-cfg-1.jpeg)

**Per visualizzare le informazioni sullo stato della sessione utilizzando l'API Athena**
+ Nell'API Athena, puoi trovare le informazioni sulla modifica dello stato della sessione nel `StateChangeReason` campo dell'[SessionStatus](https://docs.aws.amazon.com/athena/latest/APIReference/API_SessionStatus.html)oggetto.

**Nota**  
Dopo aver interrotto manualmente una sessione o se la sessione si interrompe dopo un timeout di inattività (l'impostazione predefinita è 20 minuti), il valore delle **StateChangeReason**modifiche alla sessione è stato terminato per richiesta.

## Utilizzare la registrazione per risolvere gli errori di avvio della sessione
<a name="notebooks-spark-troubleshooting-sessions-using-logging"></a>

Gli errori di configurazione personalizzati che si verificano durante l'avvio di una sessione vengono registrati da [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html). Nei tuoi CloudWatch log, cerca i messaggi di errore da cui `AthenaSparkSessionErrorLogger` risolvere un avvio non riuscito della sessione.

Per ulteriori informazioni sull’accesso a Spark, consultare [Registrare eventi dell’applicazione Spark in Athena](notebooks-spark-logging.md).

Per ulteriori informazioni sulla risoluzione dei problemi delle sessioni in Athena per Spark, consulta [Risolvere gli errori delle sessioni](#notebooks-spark-troubleshooting-sessions).

## Problemi specifici alla sessione
<a name="notebooks-spark-troubleshooting-sessions-specific-error-messages"></a>

Utilizzare le informazioni in questa sezione per risolvere i problemi relativi a specifiche sessioni.

### Sessione in stato non integro
<a name="notebooks-spark-troubleshooting-sessions-unhealthy"></a>

Se ricevi il messaggio di errore Session in unhealthy state. Please create a new session (Sessione in stato non integro. Crea una nuova sessione), termina la sessione esistente e creane una nuova.

### Impossibile stabilire una connessione al server del notebook
<a name="notebooks-spark-troubleshooting-sessions-wss-blocked"></a>

Quando apri un notebook, potresti ricevere il seguente messaggio di errore:

```
A connection to the notebook server could not be established.  
The notebook will continue trying to reconnect.  
Check your network connection or notebook server configuration.
```

#### Causa
<a name="notebooks-spark-troubleshooting-sessions-wss-blocked-cause"></a>

Quando apre un notebook, Athena crea una sessione e si connette al notebook utilizzando un URL del notebook prefirmato. [La connessione al notebook utilizza il protocollo WSS (WebSocketSecure).](https://en.wikipedia.org/wiki/WebSocket)

Questo errore può verificarsi per i seguenti motivi:
+ Un firewall locale (ad esempio un firewall a livello aziendale) sta bloccando il traffico WSS.
+ Il software proxy o antivirus sul computer locale sta bloccando la connessione WSS.

#### Soluzione
<a name="notebooks-spark-troubleshooting-sessions-wss-blocked-solution"></a>

Supponiamo di avere una connessione WSS nella Regione `us-east-1` come la seguente:

```
wss://94c2bcdf-66f9-4d17-9da6-7e7338060183.analytics-gateway.us-east-1.amazonaws.com/
api/kernels/33c78c82-b8d2-4631-bd22-1565dc6ec152/channels?session_id=
7f96a3a048ab4917b6376895ea8d7535
```

Per risolvere l'errore, utilizza una delle seguenti strategie.
+ Utilizza la sintassi del pattern wild card per consentire l'elenco del traffico WSS sulla porta `443` attraverso e. Regioni AWS Account AWS

  ```
  wss://*amazonaws.com
  ```
+ Utilizza la sintassi del pattern wild card per consentire l'elenco del traffico WSS sulla porta `443` in una sola porta Regione AWS e tra quelle Account AWS specificate Regione AWS . Nell'esempio seguente viene utilizzato `us-east-1`.

  ```
  wss://*analytics-gateway.us-east-1.amazonaws.com
  ```