# Solución de errores de sesión
<a name="notebooks-spark-troubleshooting-sessions"></a>

Utilice la información de esta sesión para solucionar problemas de sesión.

Cuando se produce un error de configuración personalizada durante el inicio de una sesión, la consola de Athena para Spark muestra un mensaje de error. Para solucionar los errores de inicio de sesión, puede comprobar los cambios de estado de la sesión o la información de registro.

## Visualización de la información sobre los cambios de estado de la sesión
<a name="notebooks-spark-troubleshooting-sessions-viewing-session-state-change"></a>

Puede obtener detalles sobre un cambio de estado de sesión en el editor de cuadernos de Athena o en la API de Athena.

**Para visualizar la información del estado de la sesión en la consola de Athena**

1. En el editor de cuadernos de Athena, en el menú **Sesión** de la esquina superior derecha, elija **Ver detalles**.

1. Vea la pestaña **Sesión actual**. En la sección **Información de la sesión**, se muestra información como el identificador de la sesión, el grupo de trabajo, el estado y el motivo del cambio de estado.

   En la siguiente de captura de pantalla de ejemplo, se muestra información en la sección **Motivo del cambio de estado** del cuadro de diálogo **Información de la sesión** sobre un error de sesión de Spark en Athena.  
![\[Visualización de información de cambio de estado de la sesión en la consola de Athena para Spark.\]](http://docs.aws.amazon.com/es_es/athena/latest/ug/images/notebooks-spark-custom-jar-cfg-1.jpeg)

**Para visualizar la información del estado de la sesión con la API de Athena**
+ En la API de Athena, puede encontrar información sobre el cambio de estado de la sesión en el campo `StateChangeReason` del objeto [SessionStatus](https://docs.aws.amazon.com/athena/latest/APIReference/API_SessionStatus.html).

**nota**  
Tras detener manualmente una sesión, o si la sesión se detiene tras un tiempo de espera de inactividad (el valor predeterminado es de 20 minutos), el valor de **StateChangeReason** cambia a Se cerró la sesión por solicitud.

## Uso del registro para solucionar los errores de inicio de sesión
<a name="notebooks-spark-troubleshooting-sessions-using-logging"></a>

[Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) registra los errores de configuración personalizados que se producen durante el inicio de una sesión. En sus registros de CloudWatch, busque los mensajes de error de `AthenaSparkSessionErrorLogger` para solucionar un error de inicio de sesión.

Para obtener más información sobre el registro de Spark, consulte [Registro de eventos de aplicaciones de Spark en Athena](notebooks-spark-logging.md).

Para obtener más información sobre cómo solucionar problemas con las sesiones en Athena para Spark, consulte [Solución de errores de sesión](#notebooks-spark-troubleshooting-sessions).

## Problemas específicos de sesión
<a name="notebooks-spark-troubleshooting-sessions-specific-error-messages"></a>

Utilice la información de esta sección para resolver algunos problemas específicos de sesión.

### Sesión en estado incorrecto
<a name="notebooks-spark-troubleshooting-sessions-unhealthy"></a>

Si recibe el mensaje de error Session in unhealthy state. Please create a new session (Sesión en estado incorrecto. Cree una nueva sesión), finalice la sesión existente y cree una nueva.

### No se pudo establecer una conexión con el servidor de cuadernos
<a name="notebooks-spark-troubleshooting-sessions-wss-blocked"></a>

Al abrir un cuaderno, puede aparecer el siguiente mensaje de error:

```
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>

Cuando Athena abre un cuaderno, Athena crea una sesión y se conecta al cuaderno a través de una URL de cuaderno previamente firmada. La conexión al cuaderno utiliza el protocolo WSS ([WebSocket Secure](https://en.wikipedia.org/wiki/WebSocket)).

Este error puede producirse por las siguientes razones:
+ Un firewall local (por ejemplo, un firewall para toda la empresa) bloquea el tráfico de WSS.
+ El software antivirus o el proxy de su equipo local bloquea la conexión WSS.

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

Supongamos que tiene una conexión WSS en la región `us-east-1` como la siguiente:

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

Para resolver el error, utilice una de las siguientes estrategias.
+ Utilice la sintaxis del patrón comodín para permitir listar el tráfico de WSS en el puerto `443` a través de las Regiones de AWS y las Cuentas de AWS.

  ```
  wss://*amazonaws.com
  ```
+ Utilice la sintaxis del patrón comodín para permitir listar el tráfico de WSS en el puerto `443` de una Región de AWS y a través de las Cuentas de AWS de la Región de AWS que especifique. El siguiente ejemplo utiliza `us-east-1`.

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