Aller au contenu principal

Résoudre les problèmes liés au connecteur Okta System Logs

info

Bêta

Cette fonctionnalité est en Bêta. Pour l’utiliser, un administrateur du workspace doit activer Lakeflow Connect for Okta System Logs depuis la page Previews . Consultez Gérer les aperçus Databricks.

Résolvez les erreurs courantes du connecteur Okta System Logs, notamment les informations d’identification non valides, les autorisations insuffisantes, les limites de taux de l’API Okta et les erreurs de service temporaires.

Pour obtenir des conseils généraux de dépannage applicables à tous les pipelines d'ingestion gérés, consultez la page Résoudre les problèmes liés aux pipelines d'ingestion gérés.

Échec de l'authentification du pipeline​

Cause : Le domaine ou le jeton d’API SSWS dans la connexion Unity Catalog n’est pas valide, le jeton a été révoqué, le compte qui a créé le jeton est inactif ou le propriétaire du jeton ne peut pas lire le System Log.

Solutions :

  1. Confirmez que Domain contient le domaine de votre organisation Okta, sous la forme d’un nom de domaine ou d’une URL HTTPS complète.
  2. Dans la console d’administration Okta, accédez à Security > API > Tokens .
  3. Confirmez que le jeton est actif et que son propriétaire est un administrateur actif capable de lire le System Log.
  4. Si nécessaire, créez un nouveau jeton et mettez à jour la valeur SSWS API token dans la connexion Unity Catalog.

Pour plus de détails sur la configuration, consultez Configurer l’authentification pour Okta et Créer une connexion Okta System Logs.

Limite de débit de l’API Okta dépassée​

Cause : Okta a renvoyé une réponse HTTP 429 car les requêtes associées au jeton d’API ont dépassé la capacité limite de débit disponible.

Solutions :

Le connecteur réessaie automatiquement les réponses HTTP 429. Si la limitation du débit persiste :

  1. Dans la console d’administration Okta, accédez à Security > API > Tokens .
  2. Sélectionnez le jeton d’API utilisé par la connexion Unity Catalog.
  3. Sous Token rate limits , cliquez sur Edit .
  4. Si la politique de votre organisation le permet, augmentez le pourcentage de chaque limite de débit de l'API alloué au jeton.
  5. Réduisez le nombre de pipelines simultanés qui utilisent le même jeton.

API Okta temporairement indisponible​

Cause : Okta a renvoyé une erreur serveur HTTP 5xx.

Solutions :

Le connecteur réessaie automatiquement en cas d'erreurs de serveur temporaires. Si le problème persiste une fois les tentatives terminées, patientez, puis réexécutez le pipeline.