Solucionar erros de sessão

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

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.

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

   

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.

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

Os erros de configuração personalizada que ocorrem durante o início da sessão são registrados em log pelo Amazon CloudWatch. 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.

Para obter mais informações sobre sessões de solução de problemas no Athena para Spark, consulte Solucionar erros de sessão.

Problemas específicos da sessão

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

Sessão em estado não íntegro

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

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

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

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

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