Dépanner l'ingestion Confluence

Cette page décrit les problèmes courants avec le connecteur Confluence 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.

Erreurs d'authentification

Erreur :

The user does not have access to the specified site 'https://your-domain.atlassian.net' with the given token, or the URL is incorrect. Please verify the URL and the OAuth token's permissions.

Résolution :

1. Vérifiez les champs d’application OAuth accordés dans l’application OAuth.
2. Vérifiez que l’URL de votre instance Confluence est correcte et inclut le nom de domaine complet (par exemple, https://your-domain.atlassian.net).

Erreurs de limite de débit.

Erreur :

Confluence API rate limit exceeded.

Résolution :

1. Le connecteur Confluence effectue des nouvelles tentatives automatiques avec une interruption exponentielle lorsque des limites de débit sont rencontrées.
2. Si les erreurs de limite de débit persistent, envisagez de planifier les exécutions de pipelines pendant les heures creuses.
3. Pour les grandes instances Confluence, vous pourriez avoir besoin d'augmenter le temps entre les exécutions de pipeline.
4. Contactez le support Atlassian si vous avez besoin d'augmenter vos limites de débit API.## Erreurs d'espace introuvable

Pages manquantes ou données incomplètes

Problème : Certaines pages n'apparaissent pas dans les données ingérées, ou les données semblent incomplètes.

Résolution :

1. Vérifiez que les pages existent dans l'espace Confluence source et qu'elles ne sont pas archivées. Les pages archivées ne sont pas prises en charge.
2. Vérifiez que les pages ne sont pas à l'état de brouillon. Seules les pages publiées sont ingérées.
3. Confirmez que le compte utilisateur a un accès en lecture à toutes les pages de l’espace.
4. Vérifiez les logs d'événements du pipeline pour toute alerte ou erreur liée à des pages spécifiques.

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 pages volumineuses contenant beaucoup de contenu ou de nombreuses pièces jointes pourraient ralentir l’ingestion.
3. Vérifiez si vous atteignez les limites de débit de l'API Confluence en consultant les logs du pipeline.
4. Si les problèmes de performance persistent, veuillez créer un ticket d'assistance.

Expiration du jeton refresh

Problème :

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

Résolution :

1. Vérifiez les champs d’application OAuth accordés dans l’application OAuth.
2. Mettre à jour la connexion.
3. 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.