Documentation sur Oracle Cloud Infrastructure

Résolution des problèmes de connexion

Utilisez les informations de dépannage pour identifier et résoudre les problèmes courants qui peuvent survenir lors de l'utilisation du centre de connecteurs.

Voir aussi Problèmes connus pour le centre de connecteurs.

Aucune donnée à déplacer

Résoudre les problèmes liés au déplacement des données au moyen de connecteurs.

Le connecteur ne déplace pas les données. Par exemple, connecteurs, voir Scénarios d'utilisation du centre de connecteurs.

Cause : Les données n'existent pas

La source ne contient pas de données correspondant à l'interrogation dans la configuration source du connecteur.

Pour savoir si des données existent à la source, procédez de l'une des façons suivantes :

Mesure corrective : Mettre à jour le connecteur

Modifiez la configuration du service source pour spécifier les données existantes. Voir Mise à jour d'un connecteur.

Cause : Erreur de niveau de service

Une erreur au niveau du service source, du service cible ou du centre de connecteurs empêche le déplacement des données.

Pour savoir si une erreur de niveau de service existe, effectuez l'une des opérations suivantes :

  • Obtenez les journaux de service pour le connecteur. (Si nécessaire, activez d'abord les journaux.) Voici un exemple de message de journal indiquant une erreur de niveau de service :
    Connector run failed due to <type> error, Error Code : XXX <exception>
  • Consultez les graphiques de mesure suivants pour le connecteur :
    • Erreurs au niveau de la source
    • Erreurs au niveau de la cible
    • Erreurs du centre de connecteurs

Mesure corrective : Mettre à jour le connecteur

Modifiez la configuration du service source ou du service cible. Voir Mise à jour d'un connecteur.

Mesure corrective : Communiquez avec le soutien technique

Si vous voyez 5xx ou -1 dans les erreurs du centre de connecteurs, communiquez avec le soutien. Voir Obtention d'aide et communication avec le soutien technique.

Cause : Autorisation manquante

Vous n'êtes pas autorisé à écrire dans le service cible.

Pour savoir si l'autorisation est manquante, obtenez les journaux de service pour le connecteur. (Si nécessaire, activez d'abord les journaux.) Voici un exemple de message de journal indiquant une autorisation manquante :

Connector run failed due to <type> error, Error Code : 404 NotAuthorizedOrNotFound

Mesure corrective : Obtenir l'autorisation

Assurez-vous d'être autorisé, par la politique par défaut offerte lors de la création ou de la mise à jour du connecteur ou par une politique basée sur un groupe. Voir Authentification et autorisation.
Note

La propagation des politiques par défaut acceptées peut prendre quelques minutes vers des régions autres que votre région principale. Le connecteur ne déplace pas les données tant que les politiques ne sont pas propagées.

Cause : Les données utiles ne correspondent pas à la configuration de la fonction

Les données utiles retournées par la tâche de fonction ne correspondent pas à l'en-tête configuré dans la fonction utilisée par la tâche de fonction. Par exemple, des données utiles avec un JSON non valide sont retournées par une fonction avec la configuration d'en-tête suivante.

headers={"Content-Type": "application/json"}

Ce problème est indiqué par le message d'erreur Expected JSON response from function, but received a different type

Reconfigurer la fonction

Modifiez la configuration de l'en-tête ou mettez à jour la fonction pour retourner des données utiles JSON valides.

Désactivation pour les motifs inconnus

Dépannez un connecteur désactivé.

Le statut d'un connecteur est Deactivated et vous ne l'avez pas désactivé.

Quelqu'un a désactivé le connecteur

Le connecteur a été désactivé par une autre personne :

  • Un autre utilisateur de votre organisation
  • Oracle Cloud Infrastructure

    Pour certaines conditions de défaillance, un connecteur en panne continue est désactivé automatiquement par l'équipe de service d'Oracle Cloud Infrastructure. Une telle défaillance continue à long terme peut indiquer une configuration non valide de la source ou de la cible du connecteur.

Réactiver le connecteur

  1. Mettez à jour le connecteur pour garantir une configuration valide de sa source et de sa cible.
  2. (Facultatif) Pour obtenir des détails sur le flux de données de la source d'un connecteur à sa cible, activez les journaux pour le connecteur.
  3. Réactivez le connecteur.
  4. Vérifiez que le connecteur déplace les données avec succès en vérifiant les résultats attendus au niveau du service cible.

Annonce : Connecteur désactivé

Une annonce de la console indique "Connecteur désactivé".

Cause : Pour certaines conditions de défaillance, un connecteur qui échoue continuellement est désactivé automatiquement par l'équipe de service d'Oracle Cloud Infrastructure. Une telle défaillance continue à long terme peut indiquer une configuration non valide de la source ou de la cible du connecteur.

Réactiver le connecteur

  1. Mettez à jour le connecteur pour garantir une configuration valide de sa source et de sa cible.
  2. (Facultatif) Pour obtenir des détails sur le flux de données de la source d'un connecteur à sa cible, activez les journaux pour le connecteur.
  3. Réactivez le connecteur.
  4. Vérifiez que le connecteur déplace les données avec succès en vérifiant les résultats attendus au niveau du service cible.

Impossible de voir l'interrogation en mode de base

Dépannez les problèmes lors de l'affichage de l'interrogation en mode de base dans la console.

La console n'autorise pas la sélection du mode de base après avoir modifié l'interrogation en mode avancé.

Cause : L'interrogation est trop complexe

L'interrogation inclut un ou plusieurs des éléments suivants non pris en charge en mode de base :

  • Opérateur OR (à l'exception des filtres basés sur le type lorsque vous utilisez uniquement des journaux de vérification)
  • Fonctions (par exemple : isNull())
  • select
  • summarize

Mesure corrective : Mettre à jour l'interrogation

Mettez à jour l'interrogation de façon à inclure uniquement les éléments pris en charge en mode de base :

Erreur : Réponse JSON attendue de la fonction, mais type différent reçu

Ce message d'erreur se produit pendant l'exécution d'un connecteur.

Cause : Les données utiles ne correspondent pas à la configuration de la fonction

Les données utiles retournées par la tâche de fonction ne correspondent pas à l'en-tête configuré dans la fonction utilisée par la tâche de fonction. Par exemple, des données utiles avec un JSON non valide sont retournées par une fonction avec la configuration d'en-tête suivante.

headers={"Content-Type": "application/json"}

Ce problème est indiqué par le message d'erreur Expected JSON response from function, but received a different type

Reconfigurer la fonction

Modifiez la configuration de l'en-tête ou mettez à jour la fonction pour retourner des données utiles JSON valides.

Comment savoir quand un problème est survenu?

Identifier les problèmes de connecteurs.

Recherchez les indicateurs de problèmes suivants avec les connecteurs.

  • Actualité des données pour un seul connecteur : Recherchez des délais inattendus dans le déplacement de données.
    1. Ouvrez le menu de navigation et sélectionnez Analyse et intelligence artificielle. Sous Messagerie, sélectionnez Centre de connecteurs.
    2. Sélectionnez un compartiment.
    3. Sélectionnez le nom du connecteur que vous voulez.
    4. Sous Ressources, sélectionnez Mesures.
    5. Vérifiez le graphique de mesure Actualité des données.
  • Actualité des données sur les connecteurs : Recherchez des délais inattendus dans le déplacement de données.
    1. Ouvrez le menu de navigation et sélectionnez Observabilité et gestion. Sous Surveillance, sélectionnez Mesures de service.
    2. Sélectionnez le compartiment qui contient les connecteurs pour lesquels vous voulez voir l'actualité des données.

    3. Pour Espace de noms de mesure, sélectionnez oci_service_connector_hub.

    4. Vérifiez les graphiques de mesure suivants : 
      • Actualité des données

  • Source de journalisation : Si le connecteur extrait des données d'un journal, il se peut qu'il tente d'extraire plus que la quantité maximale horaire d'extraction de données par connecteur (1 Go). Les données de journal ne sont pas livrées à la cible si ce problème persiste plus de 24 heures (durée maximale de capture des données manquantes dans les transmissions précédentes par le connecteur). Pour déterminer si ce problème se produit, créez des alarmes pour surveiller les indicateurs suivants.

    Note

    Pour les étapes de modification des interrogations d'alarme dans MQL, voir Modification de l'expression MQL lors de la mise à jour d'une alarme.
    Indicateur (Mesure) Interrogation d'alarme dans MQL, avec commentaires
    Données datant de plus de 12 heures (Actualité des données) 
    DataFreshness[1h].mean() > 43200000

    Commentaires :

    • La valeur 43200000 est le nombre de millisecondes dans 12 heures.
    • Ignorer les échecs occasionnels. Nous recommandons de régler le délai de déclenchement d'alarme à 30 minutes ou plus. Avec cette configuration, l'alarme ne vous avertit que lorsque plusieurs défaillances consécutives surviennent pendant la période spécifiée.
    Erreur à la source (n'importe quelle erreur) (erreurs à la source) 
    ErrorsAtSource[15m].groupby(errorCode,connectorId).min() > 0

    Commentaires :

    • Ignorer les échecs occasionnels. Nous recommandons de régler le délai de déclenchement d'alarme à 30 minutes ou plus. Avec cette configuration, l'alarme ne vous avertit que lorsque plusieurs défaillances consécutives surviennent pendant la période spécifiée.
    • Les résultats sont regroupés par code d'erreur et connecteur.
    Erreur interne à la source qui ne peut pas être résolue après 15 minutes (5xx) (Erreurs à la source) 
    ErrorsAtSource[15m]{errorCode =~ "5*"}.groupby(connectorId).sum() > 0 && 
ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Commentaires :

    • Les erreurs internes peuvent indiquer un problème à la source, ce qui peut retarder la livraison des données.
    • Pour déclencher l'alarme à des intervalles plus courts, modifiez l'intervalle ([15m]).
    • Ignorer les échecs occasionnels. Nous recommandons de régler le délai de déclenchement d'alarme à 30 minutes ou plus. Avec cette configuration, l'alarme ne vous avertit que lorsque plusieurs défaillances consécutives surviennent pendant la période spécifiée.
    Erreur de limitation à la source (429) (Erreurs à la source) 
    ErrorsAtSource[15m]{errorCode = "429"}.groupby(connectorId).sum() >0 && 
ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Commentaires :

    • Pour plus d'informations sur les erreurs de limitation, voir les limites documentées pour le service concerné.
    • Par exemple, pour les erreurs de limitation liées au service de diffusion en continu comme source, voir Limites pour les ressources de diffusion en continu. La limitation à la source de diffusion en continu se produit lorsqu'un connecteur tente de lire un flux à partir d'une partition, d'autres appels vers la même partition se produisent, et le nombre d'appels dépasse les limites du service.
    • Ignorer les échecs occasionnels. Nous recommandons de régler le délai de déclenchement d'alarme à 30 minutes ou plus. Avec cette configuration, l'alarme ne vous avertit que lorsque plusieurs défaillances consécutives surviennent pendant la période spécifiée.
    Erreur de communication de service à la source (-1) (erreurs à la source) 
    ErrorsAtSource[15m]{errorCode = "-1"}.groupby(connectorId).sum() >0 && 
ErrorsAtSource[15m].groupby(connectorId).min() > 0
    Erreur 404 à la source (erreurs à la source) 
    ErrorsAtSource[15m]{errorCode = "404"}.groupby(connectorId).sum() >0

    Commentaires :
    Aucun (0) octets lus (si des données sont attendues) (octets lus à partir de la source) 
    BytesReadFromSource[15m].groupby(connectorId).sum() == 0

    Commentaires :

    • Si les erreurs ne se produisent pas au niveau de la source, de la cible ou de la tâche, le journal n'existe peut-être pas. Vérifiez que le journal indiqué existe en le recherchant dans le service de journalisation .
    • Ignorer les échecs occasionnels. Nous recommandons de régler le délai de déclenchement d'alarme à 30 minutes ou plus. Avec cette configuration, l'alarme ne vous avertit que lorsque plusieurs défaillances consécutives surviennent pendant la période spécifiée.