Vous pouvez diagnostiquer et résoudre les problèmes de connectivité entrants et sortants courants pour votre instance Looker (Google Cloud Core) dans des configurations réseau publiques, privées et hybrides. Le dépannage de vos domaines personnalisés, de Private Service Connect, de l'accès aux services privés et de la sortie contrôlée vous aide à restaurer l'accès des utilisateurs à votre instance et à maintenir les connexions aux fournisseurs d'identité, aux services externes et aux backends de base de données.
Échec de la validation du domaine personnalisé avec l'erreur de code 9
Lorsque vous configurez un domaine personnalisé pour une instance Looker (Google Cloud Core) qui utilise des connexions publiques, la validation du domaine peut échouer avec une erreur code: 9.
Symptômes
Lorsque vous cliquez sur VALIDER LE DOMAINE dans l'onglet DOMAINE PERSONNALISÉ de votre instance Looker (Google Cloud Core), la validation échoue et un message d'erreur semblable à celui-ci s'affiche :
DNS record is not created or not the same as public IP address (code: 9)
L'état du domaine personnalisé reste également Non validé ou s'affiche comme Indisponible.
Cause
Bien que le message d'erreur indique que l'enregistrement DNS A est manquant ou incorrect, cette erreur se produit généralement pour l'une des raisons suivantes :
- Enregistrements CAA restrictifs : la configuration DNS de votre domaine inclut des enregistrements CAA (Certification Authority Authorization) qui n'autorisent pas les autorités de certification (CA) de Google à émettre des certificats SSL/TLS. Étant donné que Looker (Google Cloud Core) utilise des certificats gérés par Google pour les instances publiques, le provisionnement des certificats échoue.
- CDN ou proxy tiers : les instances Looker (Google Cloud Core) avec des connexions publiques utilisent exclusivement l'autorisation de l'équilibreur de charge pour les certificats gérés par Google. L'autorisation LB nécessite que l'enregistrement DNS A de votre domaine personnalisé soit résolu directement en adresse IP publique d'entrée Looker (Google Cloud Core). Si vous acheminez le trafic via un réseau de diffusion de contenu (CDN) tiers, un pare-feu d'application Web (WAF) ou un proxy inverse (tel qu'Akamai ou Cloudflare), l'autorisation LB automatisée échoue.
Solution
Selon la cause de l'échec, utilisez les méthodes suivantes pour résoudre le problème :
Autoriser les autorités de certification Google dans les enregistrements CAA
Si votre domaine utilise des enregistrements CAA, vérifiez et mettez à jour vos enregistrements DNS pour autoriser les fournisseurs de certificats de Google :
Vérifiez les enregistrements CAA existants de votre domaine à l'aide d'un outil de résolution DNS tel que
dig:dig CAA DOMAIN_NAME +shortRemplacez
DOMAIN_NAMEpar votre nom de domaine personnalisé (par exemple,example.comoulooker.example.com).Ajoutez des enregistrements CAA pour autoriser
pki.googetletsencrypt.org:DOMAIN_NAME. IN CAA 0 issue "pki.goog" DOMAIN_NAME. IN CAA 0 issue "letsencrypt.org"Autoriser les deux autorités de certification garantit un provisionnement et un renouvellement automatisés fiables.
Après avoir mis à jour vos enregistrements CAA, attendez la propagation DNS, puis cliquez à nouveau sur VALIDER LE DOMAINE dans la console Google Cloud .
Utiliser Private Service Connect pour les CDN et les proxys tiers
Les CDN et les proxys inverses tiers ne peuvent pas être placés directement devant une instance Looker (Google Cloud Core) publique, car l'autorisation d'équilibreur de charge automatisée nécessite une résolution DNS directe vers l'adresse IP publique de l'instance.
Pour acheminer le trafic entrant via un CDN ou un WAF tiers, déployez Looker (Google Cloud Core) à l'aide d'une architecture Private Service Connect au lieu de connexions publiques :
- Déployez une instance Looker (Google Cloud Core) avec Private Service Connect activé.
- Configurez un équilibreur de charge d'application externe avec un backend Private Service Connect dans votre réseau VPC.
- Provisionnez et associez votre propre certificat SSL autogéré ou géré par Google à l'équilibreur de charge d'application externe. Cette architecture vous permet de contrôler la terminaison TLS et d'acheminer le trafic via votre CDN ou votre WAF.
Échec de l'authentification OpenID Connect avec sortie contrôlée
Lorsque vous configurez l'authentification OpenID Connect sur une instance Looker (Google Cloud Core) configurée avec Private Service Connect et la sortie contrôlée activée, l'authentification peut échouer.
Symptômes
Si l'authentification a échoué, vous pouvez rencontrer l'un des symptômes suivants :
- Le point de terminaison Looker
/openidconnectse bloque pendant environ 60 secondes dans le navigateur avant d'afficher une erreur ou d'expirer avec une erreur504 Upstream Request Timeoutou504 Gateway Timeout. Votre fournisseur d'identité affiche un message d'erreur indiquant que l'URI de redirection ne correspond pas, par exemple :
AADSTS50011: The redirect URI specified in the request does not match the redirect URIs configured for the applicationCe message d'erreur est trompeur, car l'URI de redirection que vous avez configuré dans votre fournisseur d'identité peut être correct. L'échec se produit lorsque Looker (Google Cloud Core) ne parvient pas à contacter le point de terminaison du jeton du fournisseur d'identité lors de l'échange de backend.
Cause
Le workflow de provisionnement automatisé pour la sortie contrôlée ne parvient parfois pas à créer la route réseau Secure Web Proxy nécessaire (looker-swp-route) dans le projet locataire Looker (Google Cloud core).
Lorsque cette route est manquante, les requêtes de backend de Looker (Google Cloud Core) vers le point de terminaison du jeton du fournisseur d'identité expirent, car l'instance ne peut pas acheminer le trafic sortant vers l'Internet public via le Secure Web Proxy.
Solution
Pour résoudre ce problème, suivez ces étapes pour réinitialiser la configuration de sortie contrôlée afin de forcer le système à recréer la route réseau manquante :
Dans la console Google Cloud , accédez à la page Looker :
Cliquez sur le nom de l'instance que vous souhaitez mettre à jour.
Cliquez sur Modifier.
Développez la section Connexions, puis accédez à la section Configurer les connexions sortantes.
Enregistrez tous les noms de domaine complets (FQDN) existants répertoriés dans la section FQDN global (par exemple, les points de terminaison de votre fournisseur d'identité).
Supprimez tous les noms de domaine complets listés dans la section Nom de domaine complet global.
Décochez la case Autoriser Looker à se connecter à des services externes pour désactiver la sortie contrôlée.
Cliquez sur Enregistrer.
Attendez que la mise à jour de l'instance se termine et que les modifications de configuration soient effacées.
Cliquez à nouveau sur Modifier.
Développez la section Connexions, puis cochez la case Autoriser Looker à se connecter à des services externes.
Dans la section Nom de domaine complet global, ajoutez à nouveau les noms de domaine complets requis pour votre fournisseur d'identité et tout autre service externe.
Cliquez sur Enregistrer.
La réinitialisation de la sortie contrôlée déclenche le processus de provisionnement automatisé pour recréer la route réseau looker-swp-route manquante. Une fois la route créée, les requêtes de backend sortantes vers le fournisseur d'identité peuvent être effectuées.
Erreur 504 Expiration du délai de la requête en amont
Lorsque vous effectuez des appels d'API, exécutez des requêtes de longue durée ou vous authentifiez auprès d'un service externe sur une instance Looker (Google Cloud Core), la requête peut échouer avec une erreur de délai avant expiration HTTP 504.
Symptômes
Vous pouvez recevoir une erreur 504 Upstream Request Timeout ou 504 Gateway Timeout dans l'un des scénarios suivants :
- Appels ou requêtes d'API entrants : les appels d'API vers les points de terminaison Looker, tels que
/result_format, ou les requêtes de longue durée dans l'interface utilisateur de Looker échouent avec une erreur504après environ 30 secondes sur une instance précédée d'un équilibreur de charge. - Authentification sortante ou connexions à un service externe : vous recevez une erreur
504dans votre navigateur après avoir quitté la page de connexion d'un fournisseur d'identité ou lors de la connexion à un service externe sur une instance pour laquelle la sortie contrôlée est activée.
Cause
Une erreur de délai avant expiration 504 se produit généralement pour l'une des raisons suivantes :
- Délai avant expiration du service de backend de l'équilibreur de charge pour les requêtes entrantes : lorsque vous accédez à votre instance Looker (Google Cloud core) via un équilibreur de charge Cloud Load Balancing, le service de backend de l'équilibreur de charge a un délai avant expiration du service de backend par défaut de 30 secondes. Si le temps d'exécution combiné de la requête de base de données et le délai d'affichage de la charge utile Looker dépassent cette limite, l'équilibreur de charge ferme la connexion et renvoie une erreur HTTP
504. - Domaine sortant bloqué avec sortie contrôlée : l'instance Looker (Google Cloud Core) ne peut pas atteindre un domaine externe via une sortie contrôlée. Contrairement aux erreurs de route manquante, une erreur
504lors des requêtes sortantes signifie généralement que le chemin réseau existe, mais qu'un domaine requis est manquant dans la liste d'autorisation FQDN global et est bloqué, ou que la requête expire au niveau de la passerelle.
Solution
Selon la cause de l'erreur, suivez les étapes décrites dans les sections suivantes pour résoudre le problème.
Résoudre les délais avant expiration de l'équilibreur de charge lors d'appels d'API ou de requêtes
Pour résoudre les erreurs 504 causées par le délai avant expiration du service de backend de l'équilibreur de charge, utilisez l'une des méthodes suivantes ou les deux :
Augmentez le délai avant expiration du service de backend de l'équilibreur de charge :
Dans la console Google Cloud , accédez à la page Équilibrage de charge :
Cliquez sur Backends, puis sur le nom du service de backend associé à votre instance Looker (Google Cloud Core).
Cliquez sur Modifier.
Dans le champ Délai avant expiration, augmentez la valeur du délai avant expiration (par exemple, de 30 secondes à 300 secondes) pour tenir compte de vos requêtes et requêtes API les plus longues.
Cliquez sur Enregistrer.
Utilisez un workflow d'API asynchrone : si vous appelez l'API Looker pour récupérer des données de requête et que vous ne pouvez pas modifier le délai avant expiration de l'équilibreur de charge, utilisez des points de terminaison asynchrones au lieu de requêtes synchrones. Appelez
create_query_taskpour lancer la requête de manière asynchrone, puis interrogezquery_task_resultspour récupérer les résultats une fois la requête terminée.
Résoudre les délais avant expiration de la sortie contrôlée
Pour résoudre les erreurs 504 qui se produisent lorsque Looker (Google Cloud Core) ne parvient pas à se connecter à un service externe ou à un fournisseur d'identité avec la sortie contrôlée activée, procédez comme suit :
- Vérifiez les noms de domaine complets requis : dans la console Google Cloud , vérifiez que tous les domaines requis par votre service externe ou votre fournisseur d'identité sont ajoutés à la liste Noms de domaine complets globaux. Les flux d'authentification OIDC nécessitent souvent plusieurs points de terminaison (tels que les points de terminaison d'autorisation, de jeton et d'informations utilisateur) qui peuvent utiliser différents domaines.
- Capturer une trace réseau : si l'erreur persiste, capturez une trace réseau du navigateur (fichier HAR) tout en reproduisant le problème. Recherchez dans la trace les codes d'état
504ou les requêtes HTTP ayant échoué pour identifier les domaines qui ont été contactés pendant le flux, mais qui ne figurent pas dans votre liste de FQDN globaux. - Réinitialiser la configuration : si les noms de domaine complets requis sont présents, mais que les requêtes continuent d'expirer, suivez la procédure décrite dans la section Résolution pour les échecs d'authentification OpenID Connect afin de réinitialiser la configuration de sortie contrôlée.
HttpClient:ConnectTimeoutError execution expired
Lorsque vous testez une connexion OpenID Connect ou d'autres connexions réseau externes dans le panneau d'administration Looker, le test de connexion peut échouer avec une erreur de délai avant expiration.
Symptômes
Lorsque vous exécutez un test de connexion dans le panneau d'administration de Looker (par exemple, sur la page Authentification OpenID Connect), Looker renvoie l'erreur suivante :
HttpClient:ConnectTimeoutError execution expired
Cause
Cette erreur indique que l'instance Looker (Google Cloud Core) ne dispose pas du chemin réseau nécessaire pour communiquer avec le service ou le fournisseur d'identité externe. Ce problème se produit généralement lorsque l'une des conditions suivantes est remplie :
- Propagation de route manquante : Cloud Router utilise les paramètres par défaut et ne propage pas les routes du réseau VPC (comme les routes annoncées personnalisées) vers l'instance Looker (Google Cloud core).
- NEG Internet manquant : aucun groupe de points de terminaison du réseau (NEG) Internet n'est configuré dans votre réseau VPC pour acheminer le trafic vers le service externe.
Solution
Pour résoudre ce problème, procédez comme suit :
- Configurer la propagation des routes Cloud Router : vérifiez que Cloud Router est configuré pour propager les routes de réseau VPC nécessaires à votre instance Looker (Google Cloud core) en configurant des routes annoncées personnalisées.
- Configurer un NEG Internet : configurez un NEG Internet dans votre réseau VPC pour permettre à l'instance Looker (Google Cloud Core) d'acheminer le trafic de sortie vers le fournisseur d'identité externe ou le service.
- Vérifier l'accès aux services privés : pour les instances qui utilisent l'accès aux services privés, assurez-vous que votre réseau VPC est correctement appairé aux services Google. Pour en savoir plus, consultez Accéder à des services externes à l'aide de l'accès aux services privés.
Problèmes de connexion Private Service Connect Southbound
Pour les instances Looker (Google Cloud Core) qui utilisent Private Service Connect pour les connexions sortantes vers des backends de base de données ou des services publiés, vous pouvez rencontrer des erreurs de connexion même lorsque l'état du point de terminaison est Accepted.
Voici quelques problèmes courants :
- Erreurs de résolution de nom d'hôte : si Looker (Google Cloud Core) affiche une erreur
Unknown hostlors du test d'une connexion, vérifiez que le nom d'hôte configuré correspond à l'enregistrement DNS de votre réseau privé et que l'équilibreur de charge de backend est opérationnel. - Délais avant expiration de la connexion : si les connexions expirent, vérifiez vos règles de pare-feu VPC pour vous assurer que le trafic entrant est autorisé depuis le sous-réseau NAT Private Service Connect vers les backends de votre équilibreur de charge.
- État "En attente" ou "Fermé" : si l'état du rattachement de service est
PendingouClosed, vérifiez que le projet client figure dans la liste d'autorisation du rattachement de service et que les vérifications d'état TCP obligatoires sont configurées. - Échecs de mise à jour avec l'erreur interne 13 : lorsque vous mettez à jour des rattachements de service sortants à l'aide de Terraform ou de l'API, la mise à jour peut échouer avec une erreur
Internal error 13si votre configuration entrante est dans un état d'erreur. Pour en savoir plus, consultez Erreur interne 13 lors de la mise à jour des rattachements de service sortants.
Pour obtenir des workflows de diagnostic détaillés et un arbre de décision, consultez Résoudre les problèmes liés aux connexions Private Service Connect southbound.
Erreur interne 13 lors de la mise à jour des rattachements de service sortants
Lorsque vous utilisez Terraform ou l'API Looker (Google Cloud Core) pour ajouter, mettre à jour ou supprimer des rattachements de service Private Service Connect sortants (egress) sur une instance Looker (Google Cloud Core) existante, la mise à jour peut échouer avec une erreur interne.
Symptômes
Vous pouvez observer les symptômes suivants :
La mise à jour de Terraform ou de l'API échoue avec une erreur semblable à celle-ci :
Error: Error waiting for Updating Instance: Error code 13, message: an internal error has occurredL'instance Looker (Google Cloud Core) ne parvient pas à établir de connexions aux services cibles, même si le rattachement de service dans le réseau VPC producteur affiche l'état de connexion
Accepted.
Cause
Cette erreur se produit lorsque la configuration entrante Private Service Connect de l'instance (allowed_vpcs) passe à un état d'erreur dans le backend.
Lorsque vous utilisez Terraform ou un client API pour mettre à jour des rattachements de service sortants (psc_service_attachments), la charge utile de la requête inclut généralement l'intégralité du bloc psc_config, qui contient le paramètre allowed_vpcs.
L'API Looker (Google Cloud Core) tente de valider la configuration entrante lors de la mise à jour. Étant donné que allowed_vpcs est dans un état d'erreur, la validation échoue, ce qui entraîne l'échec de l'ensemble de la mise à jour de l'instance avec le code d'erreur 13 et empêche l'application des modifications du rattachement de service sortant.
Solution
Pour contourner l'erreur de validation de la configuration entrante et appliquer les mises à jour de votre rattachement de service sortant, procédez comme suit :
- Dans votre configuration Terraform ou votre charge utile d'API, mettez temporairement en commentaire ou supprimez le paramètre
allowed_vpcsdu blocpsc_config. Appliquez la configuration Terraform ou renvoyez la requête API pour mettre à jour vos rattachements de service sortants (
psc_service_attachments).Comme la charge utile de la requête omet
allowed_vpcs, l'API ignore la validation de la configuration entrante et applique les modifications du rattachement de service sortant.Une fois les rattachements de service sortants déployés et les connexions établies, restaurez le paramètre
allowed_vpcsdans votre configuration Terraform ou votre charge utile d'API.Réappliquez la configuration Terraform.
Problèmes de route et de connectivité liés à l'accès aux services privés
Pour les instances Looker (Google Cloud Core) qui utilisent l'accès aux services privés, la communication sortante vers des services externes nécessite une propagation des routes et une infrastructure réseau appropriées :
- Propagation des routes : vérifiez que Cloud Router est configuré pour propager les routes du réseau VPC vers l'instance Looker (Google Cloud core), telles que les routes annoncées personnalisées.
- Groupes de points de terminaison du réseau Internet : si votre instance doit atteindre des points de terminaison externes via l'accès aux services privés, assurez-vous qu'un groupe de points de terminaison du réseau Internet (NEG) est configuré dans votre réseau VPC.
Si ces routes ou groupes de points de terminaison sont manquants, les tests de connexion aux points de terminaison externes échouent avec une erreur HttpClient:ConnectTimeoutError execution expired.
Pour en savoir plus, consultez Accéder à des services externes à l'aide de l'accès aux services privés.
Outils de diagnostic et journaux
Utilisez les outils et les journaux suivants pour diagnostiquer les problèmes de mise en réseau :
- Cloud Logging : affichez les journaux au niveau de l'instance dans Cloud Logging pour identifier les échecs de connexion et les événements système. Pour en savoir plus, consultez Afficher les journaux d'instance.
- Activité du système Looker : si vous pouvez vous connecter en tant qu'administrateur, consultez le tableau de bord Activité des utilisateurs dans l'activité du système. Ce tableau de bord affiche les échecs de connexion récents, la méthode d'authentification utilisée et les messages d'erreur. Pour en savoir plus, consultez Tableau de bord de l'activité des utilisateurs.
- Journaux de flux VPC : consultez les journaux de flux VPC pour déterminer si le trafic réseau de Looker (Google Cloud core) atteint votre sous-réseau de destination ou s'il est bloqué par des règles de pare-feu.
- Cloud Customer Care : si vous avez suivi les étapes de dépannage et que le problème persiste, contactez Cloud Customer Care pour obtenir de l'aide.