# Solucionar erros de sessão
<a name="notebooks-spark-troubleshooting-sessions"></a>

Use as informações desta seção para solucionar problemas de sessão.

Quando ocorre um erro de configuração personalizada durante o início da sessão, o console do Athena para Spark mostra um banner de mensagem de erro. Para solucionar erros de início de sessão, verifique a alteração do estado da sessão ou as informações de registro.

## Visualizar informações sobre alterações de estado da sessão
<a name="notebooks-spark-troubleshooting-sessions-viewing-session-state-change"></a>

Você pode obter detalhes sobre uma alteração no estado da sessão no editor do caderno do Athena ou na API do Athena.

**Para visualizar as informações do estado da sessão no console do Athena**

1. No editor de cadernos do Athena, no menu **Sessão** no canto superior direito, escolha **Visualizar detalhes**.

1. Visualize a guia **Sessão atual**. A seção **Informações da sessão** exibe informações como ID da sessão, grupo de trabalho, status e motivo da mudança de estado.

   O exemplo de captura de tela a seguir mostra informações na seção **Motivo da mudança de estado** da caixa de diálogo **Informações da sessão** para um erro de sessão do Spark no Athena.  
![\[Visualizar as informações do estado da sessão no console do Athena para Spark.\]](http://docs.aws.amazon.com/pt_br/athena/latest/ug/images/notebooks-spark-custom-jar-cfg-1.jpeg)

**Para visualizar as informações do estado da sessão usando a API do Athena**
+ Na API do Athena, você pode encontrar informações sobre alteração do estado da sessão no campo `StateChangeReason` do objeto [SessionStatus](https://docs.aws.amazon.com/athena/latest/APIReference/API_SessionStatus.html).

**nota**  
Após interromper manualmente uma sessão ou se a sessão for interrompida após um tempo limite de inatividade (o padrão é 20 minutos), o valor de **StateChangeReason** é alterado para A sessão foi encerrada por solicitação.

## Usar registro em log para solucionar erros de início de sessão
<a name="notebooks-spark-troubleshooting-sessions-using-logging"></a>

Os erros de configuração personalizada que ocorrem durante o início da sessão são registrados em log pelo [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html). No CloudWatch Logs, pesquise mensagens de erro de `AthenaSparkSessionErrorLogger` para solucionar uma falha no início da sessão.

Para obter mais informações sobre registro em log, consulte [Registrar em log eventos de aplicação do Spark no Athena](notebooks-spark-logging.md).

Para obter mais informações sobre sessões de solução de problemas no Athena para Spark, consulte [Solucionar erros de sessão](#notebooks-spark-troubleshooting-sessions).

## Problemas específicos da sessão
<a name="notebooks-spark-troubleshooting-sessions-specific-error-messages"></a>

Use as informações desta seção para solucionar alguns problemas específicos da sessão.

### Sessão em estado não íntegro
<a name="notebooks-spark-troubleshooting-sessions-unhealthy"></a>

Se você receber a mensagem de erro: Session in unhealthy state. Please create a new session (Sessão em estado não íntegro. Crie uma nova sessão.), encerre a sessão existente e crie uma nova.

### Não foi possível estabelecer uma conexão com o servidor do caderno
<a name="notebooks-spark-troubleshooting-sessions-wss-blocked"></a>

Ao abrir um caderno, é possível visualizar a mensagem de erro a seguir:

```
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 o Athena abre um caderno, ele cria uma sessão e se conecta ao caderno usando um URL previamente conectado para o caderno. A conexão com o caderno usa o protocolo WSS ([WebSocket Secure](https://en.wikipedia.org/wiki/WebSocket)).

O erro pode ocorrer pelos seguintes motivos:
+ Um firewall local (por exemplo, um firewall que abrange toda a empresa) está bloqueando o tráfego WSS.
+ O software proxy ou antivírus em seu computador local está bloqueando a conexão WSS.

#### Solução
<a name="notebooks-spark-troubleshooting-sessions-wss-blocked-solution"></a>

Suponha que você tenha uma conexão WSS na região `us-east-1`, que é semelhante a seguir:

```
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 o erro, use uma das seguintes estratégias.
+ Use a sintaxe padrão de caráter universal para permitir a listagem do tráfego WSS na porta `443` entre as Regiões da AWS e as Contas da AWS.

  ```
  wss://*amazonaws.com
  ```
+ Use a sintaxe padrão de caráter universal para permitir a listagem do tráfego WSS na porta `443` em uma Região da AWS e entre as Contas da AWS na Região da AWS que você especificar. O exemplo a seguir usa `us-east-1`.

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