Le rapport sur le flux contient des informations sur la dernière tentative d'ingestion de votre flux. Ces données incluent l'état général et l'état de disponibilité de chaque fichier du flux, ainsi que le nombre et l'état de toutes les entités identifiées dans le flux. Vous pouvez afficher l'historique de toutes les ingestions de ce flux au cours des 90 derniers jours. Chaque flux d'une propriété donnée est associé à un rapport distinct.
Si votre propriété ne comporte qu'un seul flux, le rapport sur le flux est simplement intitulé Flux. Si elle en comporte plusieurs, chaque flux possède son propre rapport, intitulé d'après son nom unique.
Questions fréquentes
Pour trouver les principales informations utiles concernant votre flux, procédez comme suit :
État de la dernière ingestion
Afficher l'historique des ingestions
Nombre d'entités pour un état donné
Historique de l'état d'un type d'entité donné
Nombre d'entités dans Google
- Cliquez sur Afficher l'historique sur la page de destination du rapport sur le flux, puis recherchez l'ingestion la plus récente dans l'historique. Notez la date et l'heure de cette opération.
- Revenez à la page d'accueil du rapport sur le flux et consultez le tableau Entités détectées.
- Cliquez sur chaque ligne du tableau, à l'exception de la ligne Autres entités.
- Au-dessus du graphique, sélectionnez Valide et Valide avec des avertissements et désélectionnez Non valide.
- Recherchez la date et l'heure que vous avez notées à l'étape 1.
- Additionnez les valeurs de chaque type d'élément dans le tableau Entités détectées.
- Dans le rapport sur le flux, accédez au tableau Entités détectées.
- Cliquez sur un type d'entité pour afficher un tableau des problèmes le concernant. Recherchez un problème spécifique dans ce tableau.
- Cliquez sur la ligne correspondante du tableau des problèmes pour afficher une liste non exhaustive des entités affectées par ce problème.
Problèmes d'entité dans la dernière ingestion
- Cliquez sur une ligne du tableau pour afficher l'historique des entités du même type.
- En haut du graphique, sélectionnez "Valide" ou "Valide avec des avertissements" pour afficher la liste des problèmes qui affectent votre flux.
- Cliquez sur une ligne dont la valeur de décompte Entités est supérieure à 0 pour afficher la liste des entités concernées par ce problème. Si le nombre de problèmes est nul, cela signifie que le problème a été résolu lors de la dernière ingestion. Cependant, en cas d'échec de la dernière ingestion, le problème était peut-être présent dans la dernière ingestion réussie.
- Cliquez sur une entité dans le tableau des exemples d'entités pour afficher le code contenant des erreurs. Notez que ce tableau peut ne pas afficher toutes les entités affectées par un problème.
État de l'ingestion
En haut du rapport sur le flux, vous pouvez consulter le résultat de la dernière tentative d'ingestion. Celui-ci dépend de nombreux facteurs, y compris la possibilité de demander et d'analyser les fichiers, ainsi que la validité des entités identifiées dans le flux. Si le flux présente un problème au niveau du fichier ou un nombre trop important d'entités dans le flux, l'ingestion échoue.
Quelques heures peuvent s'écouler avant qu'une ingestion apparaisse dans le rapport sur le flux. Bien que la plupart des ingestions soient programmées régulièrement, certaines peuvent être déclenchées automatiquement pour diverses raisons.
États du flux en direct
Voici les états disponibles pour le flux En direct :
- Données traitées et envoyées à Google
Le flux a été validé. Toutes les entités valides du flux ont pu être ajoutées dans le Knowledge Graph. Ce résultat indique qu'au moins une entité valide a été identifiée dans le flux. La présence d'une entité valide dans un flux validé ne garantit pas qu'elle sera ajoutée dans le Knowledge Graph. En outre, certaines entités non valides peuvent être ajoutées dans le Knowledge Graph en cas d'erreur mineure ou réparable. En savoir plus - Données traitées, mais impossible de les envoyer à Google
L'ingestion a été refusée soit en raison d'incohérences au niveau des entités, soit à cause d'un changement radical du nombre d'entités valides depuis la dernière ingestion, soit pour une autre raison. Veuillez contacter votre représentant Google pour en savoir plus et découvrir comment résoudre le problème. Les entités valides du dernier flux réussi restent actives dans le Knowledge Graph. - Échec du traitement des données : problèmes avec le fichier de flux
L'ingestion a été refusée en raison de problèmes au niveau du fichier. Aucune entité de ce flux n'est transmise au Knowledge Graph. Aucune entité de cette ingestion ne s'affiche dans la section "Entités détectées" du rapport sur le flux. Les entités visibles sont celles de la dernière ingestion avec l'état "Valide" ou "Données traitées, mais impossible de les envoyer à Google". - Échec du traitement des données : flux vide
Tous les fichiers de flux étaient vides ou ne contenaient aucune entité analysable. Si des entités existent, mais que toutes présentent des erreurs, il s'agit d'un cas de type Données traitées, mais impossible de les envoyer à Google.
États des flux non diffusés en direct
Voici les états disponibles pour les flux qui ne sont pas diffusés en direct :
- Données traitées
Google peut lire, analyser et effectuer une validation initiale de votre flux. Examinez et corrigez les erreurs ou les avertissements détectés dans le flux, comme indiqué dans le tableau des entités du rapport sur le flux. - Échec du traitement des données : flux vide
Tous les fichiers de flux étaient vides ou ne contenaient aucune entité analysable. - Échec du traitement des données : problèmes avec le fichier de flux
L'ingestion a été refusée en raison de problèmes au niveau du fichier. Aucune entité de cette ingestion ne s'affiche dans la section "Entités détectées" du rapport sur le flux.
Autres informations
- Badge "En direct"
- Un badge "En direct" apparaît dans un flux après au moins un envoi réussi à Google.
- Heure
- L'heure d'ingestion indiquée par le résultat correspond à l'heure locale de l'utilisateur à laquelle Google a récupéré le premier fichier du flux.
Fichiers de flux
La section Fichiers de flux indique si les fichiers de votre flux peuvent être lus. Si un fichier ne peut pas être lu, l'ingestion échoue.
Problèmes avec le fichier de flux
Voici les erreurs qui peuvent se produire au niveau du fichier :
- Introuvable (404) : le fichier de flux est introuvable sous l'URL fournie.
- Bloqué en raison d'une demande non autorisée (401) : assurez-vous d'inclure toutes les informations d'authentification requises dans votre configuration du flux pour permettre à Google d'accéder au fichier.
- Bloqué par le fichier robots.txt : une règle du fichier robots.txt bloque le flux. Recherchez et modifiez ou supprimez la règle.
- Erreur serveur (5xx) : une erreur de serveur s'est produite lors de la tentative de lecture de votre fichier de flux.
- Erreur liée à des redirections : le fichier de flux contient une erreur de redirection. Il peut s'agir par exemple d'une boucle de redirection ou d'une redirection vers une URL non valide (mais pas vers une URL valide qui ne répond pas). Le lecteur de fichiers de flux suit les redirections, mais si votre fichier de flux a été déplacé de façon définitive, vous devez mettre à jour les paramètres de votre fichier de flux au lieu de spécifier une redirection.
- Bloquée en raison d'une interdiction d'accès (403) : Google n'a pas été autorisé à lire votre fichier en raison d'une restriction d'accès. Assurez-vous d'inclure toutes les informations d'authentification requises dans votre configuration de flux pour permettre à Google d'accéder au fichier.
- Bloquée en raison d'un autre problème de type 4xx : un autre problème a empêché Google d'accéder à ce fichier de flux.
- Problème d'analyse : un problème fatal lors de l'analyse a empêché la lecture de l'intégralité du fichier. Cliquez sur la description du problème pour afficher l'extrait contenant l'erreur d'analyse.
- Erreur interne : Google a rencontré un problème non spécifié et réessayera plus tard.
- Aucune réponse du serveur DNS : le serveur DNS n'a pas répondu à notre requête. Google réessaiera régulièrement de lire votre flux.
- Erreur DNS : hôte inconnu : le service DNS n'est pas parvenu à interpréter l'URL de flux que vous avez fournie. L'erreur peut être temporaire, mais vérifiez l'URL fournie par prudence.
- Erreur DNS : adresse IP privée fournie : le service DNS a renvoyé une adresse IP réservée à l'usage privé (par exemple, 10.0.0.1). Contactez votre fournisseur de services DNS.
- Erreur de connexion au serveur : une erreur de niveau 5XX s'est produite (serveur inaccessible, connexion refusée ou absence de réponse).
- Réponse non valide pour le serveur : le serveur n'est pas compatible avec le protocole demandé, les réponses ou les en-têtes sont tronqués, ou la réponse ne pas peut être analysée (par exemple, suite à une erreur de compression).
- Certificat SSL du serveur non valide : le certificat SSL du site n'est pas valide. Google ne traite pas les demandes dont le certificat SSL n'est pas valide.
- Extrait, mais pas traité : si l'un des fichiers du flux n'a pas pu être extrait ni traité, Google tente d'extraire les fichiers restants sans les traiter, ce qui provoque l'échec de l'ingestion du flux. "Extrait, mais pas traité" est le libellé attribué à tous les fichiers extraits dans cette situation.
Entités détectées
Cette section affiche toutes les entités de niveau supérieur de votre verticale qui ont été identifiées dans cette ingestion, regroupées par type.
Tableau des entités de niveau supérieur
Pour chaque type d'entité de niveau supérieur, le tableau indique le nombre d'entités par état. Pour afficher les détails concernant un type d'entité, cliquez sur la ligne de l'entité dans le tableau pour ouvrir sa page d'informations.
Si une ingestion échoue, car aucun fichier ne peut être lu, les valeurs du tableau sont toutes 0, mais vous pouvez toujours cliquer sur une ligne d'entité pour afficher l'historique des ingestions de ce type d'entité. N'oubliez pas que Google continue à diffuser les entités de la dernière ingestion réussie.
Autres entités
Si le type Autres entités est affiché, il répertorie les entités qui n'ont pas pu être correctement classifiées, soit parce que la description du type d'entité est manquante, soit parce que le flux contient des entités en double portant le même ID. Les entités qui ne peuvent pas être analysées ne sont pas incluses dans les rapports.
Page d'informations sur l'entité
Cliquez sur une ligne du tableau des entités du flux pour afficher des informations sur le type d'entité sélectionné.
Graphique de l'historique des ingestions d'entités
Le graphique d'historique d'un type d'entité affiche le nombre d'entités de ce type par état pour chaque ingestion. Les points de données du graphique représentent les ingestions, réussies ou non. Le graphique ne montre pas l'inventaire sur Google, mais le nombre d'entités associées à un état donné pour une ingestion donnée.
Bien que le graphique présente des courbes ascendantes ou descendantes reliant les points d'ingestion, toutes les modifications sont instantanées au moment de l'ingestion. Vous pouvez donc le lire comme un graphique à barres plutôt que comme un graphique en courbes, chaque barre représentant l'intervalle de temps entre deux ingestions.
Les annotations du graphique signalent les échecs d'ingestion. Si aucun fichier n'a pu être lu, le graphique affiche zéro pour tous les états de l'ingestion concernée.
Tableau des entités
Ce tableau présente des informations sur l'état du type d'entité choisi dans la dernière tentative d'ingestion.
- Cliquez sur une ligne du tableau pour afficher plus d'informations concernant les entités associées à un état et à une description spécifiques, y compris une liste d'exemples (limitée à 1 000 entités) et un graphique de l'historique des entités concernées.
- Cliquez sur un exemple d'entité dans le tableau pour afficher plus de détails, y compris le code de l'entité signalant l'erreur (quand cela est possible).
État de l'entité
Les problèmes d'entité sont classés dans l'un des états suivants. Une entité est classée en fonction du problème le plus grave qu'elle contient. Si elle présente deux problèmes, dont l'un est du type Non valide et l'autre, du type Valide avec des avertissements, l'état de l'entité est Non valide.
- Non valide : cette entité ne peut pas être utilisée telle que fournie dans le flux. Pour qu'elle puisse être utilisée, veuillez la mettre à jour pour la prochaine ingestion du flux. Si l'état du flux est correct et qu'il s'agit d'un flux en direct, l'entité non valide sera supprimée de Google.
- Valide avec des avertissements : cette entité peut être utilisée telle que fournie, mais contient au moins un élément qui nécessite votre attention. Il peut s'agir d'un élément que vous devez modifier (un champ obsolète, par exemple) ou pour lequel vous êtes invité à fournir des informations supplémentaires (des prix, par exemple). Certains de ces problèmes peuvent se convertir en erreurs au fil du temps.
- Valide : cette entité peut être incluse dans le Knowledge Graph. Pour afficher la liste des entités valides, cliquez sur Afficher les données concernant les entités valides sous le graphique de la page récapitulative du rapport sur le flux.
Déboguer votre flux
Le débogage d'un flux est un processus itératif. Utilisez le rapport sur le flux pour identifier et corriger les bugs, puis observer le résultat de vos corrections lors de la prochaine ingestion de flux.
Les problèmes sont regroupés par type d'entité de niveau supérieur. Vous pouvez probablement résoudre la plupart, si ce n'est tous les problèmes d'un type donné, en examinant une instance du problème, puis en corrigeant le code de génération de votre entité.
Pour valider un élément individuel, vous pouvez utiliser l'outil de validation de flux de données.
Pour résoudre les problèmes d'entité :
- Examinez la liste des types d'entités dans le tableau en bas du rapport sur le flux. Cliquez sur une ligne qui affiche au moins un élément Non valide.
- Assurez-vous que l'onglet Non valide est sélectionné pour que vous puissiez voir l'historique des entités présentant un état d'erreur dans vos flux.
- Consultez la liste des erreurs dans le tableau d'informations en bas du rapport.
- Cliquez sur une erreur pour afficher l'historique des entités concernées par cette erreur, ainsi que des exemples issus de la dernière tentative d'ingestion. La liste d'exemples d'entités peut ne pas être exhaustive, et ce, pour différentes raisons, mais le nombre d'entités concernées par l'erreur sélectionnée dans le graphique devrait être correct.
- Cliquez sur une entité dans la liste d'exemples pour afficher le code avec l'erreur en surbrillance (la mise en surbrillance ne fonctionne pas pour toutes les erreurs). Cliquez sur le lien En savoir plus pour en savoir plus sur cette erreur. Dans certains cas, une suggestion de correction peut s'afficher dans le panneau d'informations supplémentaires. Consultez également la documentation concernant l'entité en question pour connaître les valeurs ou formats requis.
- Générez un flux actualisé, puis vérifiez si vos corrections ont fonctionné en utilisant l'outil de validation de flux de données pour examiner une ou plusieurs des entités précédemment affectées.
- Si tout semble correct, mettez à jour votre flux et attendez la prochaine ingestion pour voir si ces erreurs ont disparu. Vous pouvez consulter l'historique d'un type d'erreur spécifique dans un type d'entité donné. Pour ce faire, cliquez sur le type d'entité concerné dans le tableau "Entités détectées" du rapport sur le flux, puis cliquez sur un problème dans le tableau d'informations.
Types de problèmes
Un flux peut comporter des problèmes d'entité et des problèmes de flux.
- Les problèmes de flux impliquent la lecture et l'analyse du fichier. Tout problème de fichier entraîne l'échec d'une ingestion. Consultez la liste des problèmes de fichiers.
- Les problèmes d'entité peuvent être causés par des erreurs de syntaxe ou des valeurs manquantes dans les champs obligatoires. Les problèmes d'entité peuvent également survenir lors du rapprochement d'une entité du flux avec une entité du Knowledge Graph. En savoir plus
Problèmes d'entité
Une entité peut présenter un ou plusieurs problèmes et/ou plusieurs instances du même problème. Pour déboguer un problème d'entité, cliquez sur le rapport du dernier flux pour afficher les erreurs et les avertissements, puis cliquez sur des entités spécifiques pour afficher une liste d'exemples d'entités affectées par un problème spécifique.
- Si vous souhaitez déboguer un type d'erreur spécifique (par exemple, toutes les entités où la propriété "nom" manque), vous devrez rechercher l'erreur dans le détail des types d'entités concernés.
Types de problèmes en lien avec les entités
Les entités peuvent présenter des problèmes d'analyse/de conformité ou de correspondance. Le rapport sur le flux ne fait pas la distinction entre ces deux catégories de problèmes, mais les connaître peut vous aider à les résoudre :
- Les problèmes d'analyse ou de conformité indiquent que l'entité ne peut pas être analysée, qu'elle ne contient pas les valeurs requises ou qu'elle contient des valeurs non prises en charge pour un champ donné. Dans ce cas, lisez le nom du problème et consultez la documentation correspondant au type d'entité spécifique pour en savoir plus sur les exigences de l'entité concernée.
- [Expérimental] Les problèmes de correspondance surviennent lorsque Google ne parvient pas à mettre en correspondance une entité de votre flux avec une entité du Knowledge Graph. Ce problème survient principalement lorsque certaines données sur l'entité de flux manquent ou ne correspondent pas à celles dont Google dispose. Les déclencheurs de ces problèmes sont encore en développement. Commencez plutôt par résoudre les problèmes d'analyse ou de conformité. Découvrez comment déboguer les problèmes de correspondance.