Solucionar problemas do conector de logs do sistema Okta
Beta
Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Lakeflow Connect para Logs do Sistema do Okta na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.
Resolva erros comuns do conector do Okta System Logs, incluindo credenciais inválidas, permissões insuficientes, limites de taxa da API do Okta e erros temporários de serviço.
Para obter orientações gerais de solução de problemas aplicadas a todos os pipelines de ingestão gerenciados, consulte Solucionar problemas de pipelines de ingestão gerenciados.
Falha na autenticação do pipeline
Cause : O domínio ou o token da API SSWS na conexão do Unity Catalog é inválido, o token foi revogado, a account que criou o token está inativa ou o proprietário do token não pode ler o System Log.
Solução :
- Confirme se Domain contém o seu domínio organizacional do Okta, seja como um nome de domínio ou como uma URL HTTPS completa.
- In the Okta Admin Console, go to Security > API > Tokens .
- Confirme se o token está ativo e se o proprietário dele é um administrador ativo que pode ler o Log do Sistema.
- Se necessário, crie um novo token e atualize o valor do SSWS API token na conexão do Unity Catalog.
Para obter detalhes da configuração, consulte Configurar autenticação para Logs de Sistema Okta e Criar uma conexão de Logs de Sistema Okta.
Limite de taxa da API do Okta excedido
Cause : O Okta retornou uma resposta HTTP 429 porque as solicitações associadas ao token da API excederam a capacidade limite de taxa disponível.
Solução :
O conector repete as respostas HTTP 429 automaticamente. Se a limitação de taxa continuar:
- In the Okta Admin Console, go to Security > API > Tokens .
- Selecione o token de API usado pela conexão do Unity Catalog.
- Em Limites de taxa de tokens , clique em Editar .
- Se a política da sua organização permitir, aumente a porcentagem de cada limite de taxa de API alocada ao token.
- Reduza o número de pipelines concorrentes que usam o mesmo token.
API do Okta temporariamente indisponível
Causa : O Okta retornou um erro de servidor HTTP 5xx.
Solução :
O conector repete erros temporários de servidor automaticamente. Se o problema persistir após o término das tentativas, aguarde e execute o pipeline novamente.