Dépanner le pipeline d'ingestion

Une fois les données du journal ingérées dans Log Analytics à l'aide de l'une des méthodes d'ingestion disponibles, le traitement des données commence de manière asynchrone. Lors du traitement des données, si des erreurs se sont produites au niveau de la configuration, de la taille ou de la structure du journal, de l'autorisation (applicable pour le type ObjectCollection uniquement) ou de la définition de l'analyseur, elles peuvent entraîner des problèmes, notamment :

  • Les données de journal ne sont pas disponibles dans l'explorateur de journaux pour la visualisation.

  • Seules des données partielles sont disponibles pour visualisation.

  • Les données sont traitées de manière incomplète et marquées avec des échecs d'analyse.

  • Les données ne sont pas associées aux ressources attendues, telles qu'une entité ou des métadonnées supplémentaires

Utilisez la mesure Erreurs de traitement pour détecter l'erreur et dépanner votre pipeline d'ingestion en identifiant le type d'erreur et en le mappant à la méthode d'ingestion utilisée. Pour savoir comment accéder à la mesure Erreurs de traitement, voir Surveiller Log Analytics à l'aide de mesures de service.

Voici les méthodes d'ingestion (collectionType) pour lesquelles la mesure d'erreurs de traitement sera générée :

  • Chargement sur demande (ODU) : Pour toutes les données chargées dans Log Analytics au moyen d'une des méthodes de chargement sur demande.

  • Ingestion des journaux à l'aide du connecteur de service (ServiceConnector) : Utilisez le connecteur de service pour collecter les journaux de votre service Oracle Cloud Infrastructure avec Log Analytics en tant que cible.

  • Collecte des données du seau de stockage d'objets (ObjectCollection) : Pour les données de journal collectées en continu que vous avez stockées dans un seau du magasin d'objets Oracle Cloud.

  • Collecte d'événements de journal (LogEventsCollection) : Pour les données collectées à l'aide de l'API uploadLogEvents.

Lorsque des erreurs sont détectées, la mesure Erreurs de traitement affiche une ligne pour chaque type de collecte activé dans la location ou le compartiment. Pointez le curseur de la souris sur les points de données du graphique pour afficher plus de détails sur l'erreur. Suivez les étapes ci-dessous lorsqu'une erreur est signalée pour un type de collecte et que vous souhaitez trouver le type d'erreur exact :

  1. Cliquez sur le menu Options dans le coin supérieur droit de la mesure Erreurs de traitement, puis sélectionnez Voir dans l'explorateur des mesures.

    La mesure est maintenant affichée dans l'explorateur des mesures. Ici, vous pouvez voir le graphique plus en détail.

  2. Cliquez sur Modifier les interrogations et sélectionnez Nom de dimension et Valeur de dimension pour la mesure. Par exemple, si la mesure Erreur de traitement a signalé une erreur pour le type de collecte ServiceConnector, sélectionnez la valeur du nom de dimension collectionType et la valeur de dimension serviceConnector.

    Cliquez sur Mettre à jour le graphique pour actualiser la visualisation du graphique. Le graphique affiche à présent uniquement les erreurs provenant du flux de collecte des journaux de connexions au service. Il trace une ligne pour chaque combinaison errorType et resourceId.

    Vous pouvez passer à la vue Table de données pour obtenir une représentation tabulaire des points de données d'erreur collectés.

  3. Remplacez le nom de la dimension par errorType et resourceId, puis consultez les informations d'erreur correspondantes dans le graphique.

Voici les différents types d'erreur signalés au moyen de cette mesure :

Type d'erreur Description Correction recommandée

InvalidConfiguration

Il y a une erreur dans la configuration que vous avez fournie, par exemple, une source de journaux incorrecte ou des détails d'entité incorrects.

Exemples :

  • Connecteur de service : eventType n'est pas reconnu ou pris en charge dans Log Analytics. Vous avez peut-être configuré un mappage incorrect pour eventType si vous utilisez des journaux personnalisés.
  • Chargement sur demande (ODU), Collecte d'objets : La source utilisée lors de l'exécution d'un chargement sur demande n'est peut-être pas valide; le type de source n'est pas pris en charge par le chargement sur demande; la combinaison source et type d'entité (quand EntityId est indiqué) n'est pas valide.

Révisez vos paramètres de configuration et vérifiez qu'ils sont définis correctement. Voir Hiérarchie des ressources clés.

InvalidPayload

Les données ingérées présentent l'un des problèmes suivants :

  • Format des données utiles non valide
  • Dépassement de la limite de taille
  • Format d'archive non valide

Assurez-vous que les données sont conformes à la limite de taille, au format et aux formats d'archive prescrits. Voir Ingérer des journaux.

StructureMismatch

Les données identifiées pour la collecte et la définition de l'analyseur ne concordent pas.

Par exemple :

  • L'expression de début d'entrée n'a pas de correspondance dans le fichier JSON ou XML donné, ce qui entraîne la collecte d'entrées de journal ZERO
  • Lorsque la source a un type d'analyseur Expression rationnelle mais qu'un fichier JSON est disponible pour la collecte

Vérifiez la définition de l'analyseur et assurez-vous que les données entrantes sont conformes à la définition fournie. Créer un analyseur

NotAuthorizedOrNotFound

Cette erreur est visible uniquement pour la collecte de données à partir du seau de stockage d'objets lorsqu'une erreur d'autorisation est détectée lors de la lecture des données de votre location.

Par exemple :

  • Les politiques requises pour Log Analytics pour lire les objets de votre location ont été supprimées ou n'existent pas.

Vérifiez les politiques IAM que vous avez créées pour activer la collecte de journaux à partir du seau de stockage d'objets et assurez-vous que les autorisations suivantes sont accordées à Log Analytics :

allow service loganalytics to read buckets in compartment/tenancy

allow service loganalytics to read objects in compartment/tenancy