Dépanner l'ingestion Jira

info

Bêta

Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Cette page décrit les problèmes courants avec le connecteur Jira dans Databricks Lakeflow Connect et comment les résoudre.

Pour obtenir des conseils de dépannage généraux qui s'appliquent à tous les pipelines d'ingestion gérés, consultez Dépannage des pipelines d'ingestion gérés.

Échecs de connexion on-premise

Si votre connexion on-premise échoue ou que l'ingestion de données échoue avec une erreur d'inaccessibilité, assurez-vous que les adresses IP de Databricks sont autorisées par votre pare-feu.

Codes d'erreur courants

403 Non autorisé

Résolution :

Vérifiez à nouveau les champs d'application de votre application OAuth. Assurez-vous que votre application OAuth inclut toutes les portées requises pour les tables que vous tentez d'ingérer. Consultez les tables sources prises en charge pour obtenir une liste complète des portées requises.

401 Non authentifié

Résolution :

Réauthentifiez votre connexion Unity Catalog. Vos informations d’identification OAuth ont peut-être expiré ou ont été révoquées.

Après vous être authentifié auprès de Jira, un écran « Réessayer de vous connecter » s'affiche.

Après vous être authentifié avec Jira, vous voyez un écran « “Try Logging In Again” », qui se connecte avec succès à Jira mais ne vous redirige jamais vers Databricks.

Résolution :

1. Vérifiez que l'URI de redirection configuré dans l'application Jira OAuth correspond au chemin de redirection exact du workspace : https://<databricks_workspace_URL>/login/oauth/lakehousefederation.html
2. Ne cliquez pas sur Réessayer de se connecter . Ceci vous connecte à l'interface utilisateur Jira au lieu de vous rediriger vers Databricks. Au lieu de cela, fermez la fenêtre et redémarrez le flux OAuth depuis l'interface utilisateur de Databricks après avoir corrigé l'URI de redirection.
3. Si le problème persiste, confirmez que l'application Jira dispose des portées requises : read:jira-work, read:jira-user, plus les portées de lecture granulaires listées dans Configurer Jira pour l'ingestion.

Erreurs d'autorisation

Erreur :

Access denied to Jira project or issue.

Résolution :

1. Confirmez que le compte utilisateur dispose de l'autorisation Parcourir les projets pour les projets que vous essayez d'ingérer.
2. Vérifiez les permissions du projet dans Jira en naviguant vers Paramètres du projet > Permissions .
3. Si vous utilisez un compte de service, vérifiez qu’il a obtenu les autorisations appropriées.
4. Certains problèmes pourraient avoir des restrictions de sécurité. Vérifiez les autorisations d’un problème individuel dans l’interface Jira.

Erreurs de limite de débit.

Erreur :

Jira API rate limit exceeded.

Résolution :

Lorsque des limites de débit sont atteintes, le connecteur Jira réessaie automatiquement avec une interruption exponentielle. Si les erreurs de limite de débit persistent, veuillez tenir compte des éléments suivants :

• Planifiez les exécutions de pipeline pendant les heures creuses.
• Pour les grandes instances Jira, augmentez le temps entre les exécutions de pipeline.
• Divisez les entités à volume élevé (par exemple, issues, issue_comments, issue_worklogs) entre des exécutions de pipeline distinctes.
• Contactez le support Atlassian pour augmenter vos limites de débit d'API.

Problèmes manquants ou données incomplètes

Problème :

Certains problèmes n'apparaissent pas dans les données ingérées, ou les données semblent incomplètes.

Résolution :

1. Vérifiez que les problèmes existent dans le projet Jira source et qu'ils ne sont pas archivés.
2. Confirmez que le compte utilisateur a accès à tous les problèmes du projet.
3. Vérifiez que les champs personnalisés sont correctement configurés dans votre instance Jira.
4. Vérifiez les Logs d'événements du pipeline pour détecter tout avertissement ou erreur lié à des problèmes spécifiques.

Erreurs de projet introuvable

Erreur :

Jira project not found: <PROJECT_KEY>

Résolution :

1. Vérifiez que la clé du projet est correcte. Les clés de projet sont sensibles à la casse.
2. Vérifiez que le projet existe et est actif (non archivé) dans votre instance Jira.
3. Confirmez que le compte utilisateur a accès au projet.
4. Essayez d'accéder directement au projet dans votre navigateur : https://your-domain.atlassian.net/browse/<PROJECT_KEY>

Performances d’Ingestion lentes

Problème :

Les exécutions de pipeline prennent plus de temps que prévu.

Résolution :

1. Les exécutions initiales de pipeline (instantanés complets) prennent généralement plus de temps que les exécutions incrémentielles.
2. Les projets avec un historique de workflow étendu ou de nombreux champs personnalisés pourraient ralentir l'ingestion.
3. Vérifiez si vous atteignez les limites de débit de l'API Jira en examinant les logs du pipeline.
4. Envisagez d'ingérer des projets spécifiques au lieu de tous les projets afin de réduire le volume de données.
5. Si les problèmes de performance persistent, veuillez créer un ticket d'assistance.

Erreurs d’authentification OAuth

Problème :

Le pipeline fonctionnait, mais a soudainement commencé à échouer avec des erreurs d'authentification.

Résolution :

1. Le connecteur automatiquement refresh les jetons OAuth lorsqu'ils approchent de l'expiration. Si les erreurs d'authentification persistent, le problème pourrait être lié à la configuration ou à la révocation de l'application OAuth.
2. Vérifiez que votre application OAuth est toujours active et n'a pas été révoquée dans la console de développement Atlassian.
3. Si nécessaire, réauthentifiez la connexion Unity Catalog en repassant par le flux OAuth.
4. Réessayez le pipeline.

Besoin d'aide ?

Si vous rencontrez un problème qui n'est pas couvert dans ce guide de dépannage, créez un ticket d'assistance.