Intégrer des journaux du service OSDU à Azure Monitor

  • Article

Azure Data Manager for Energy prend en charge l’exportation des journaux de service OSDU vers Azure Monitor à l’aide d’un paramètre de diagnostic. Cette fonctionnalité vous permet de mieux dépanner, déboguer et surveiller les services OSDU. Les instructions fournies ici sont similaires à la façon dont vous intégreriez d’autres journaux, tels que Airflow et Elastic, à Azure Monitor.

Prérequis

  • Un espace de travail Log Analytics existant. Cet espace de travail est utilisé pour interroger les journaux du service OSDU à l’aide de l’éditeur de requête Langage de requête Kusto (KQL) dans l’espace de travail Log Analytics. Ressource utile : Créer un espace de travail Log Analytics dans le Portail Azure.

  • Un compte de stockage existant : il est utilisé pour stocker des vidages JSON des journaux du service OSDU. Il n’est pas nécessaire que le compte de stockage figure dans le même abonnement que votre espace de travail Log Analytics.

Activation des paramètres de diagnostic pour l’intégration des journaux de service OSDU

  1. Ouvrez la page Vue d’ensemble de Microsoft Azure Data Manager for Energy.

  2. Sélectionnez Diagnostic Paramètres dans le volet gauche.

    Screenshot shows that the list of OSDU services currently supported is visible on the diagnostic settings overview page.

  3. Sélectionnez Ajouter le paramètre de diagnostic. Choisissez un nom de paramètre de diagnostic et sélectionnez les services sous Catégories pour lesquelles vous souhaitez envoyer des journaux à votre destination choisie.

    Screenshot to show that users can select all or a few log categories while creating a diagnostic setting.

  4. Dans la section Journaux, vous pouvez choisir un ou plusieurs services OSDU pour lesquels vous souhaitez créer un paramètre de diagnostic. Sélectionnez Archiver dans un compte de stockage et/ou Envoyer à l’espace de travail Log Analytics comme vous le souhaitez.

    Screenshot shows that export to multiple destinations can be configured with just one diagnostic setting.

  5. Vérifiez l’abonnement, le compte de stockage et l’espace de travail Log Analytics dans lequel vous souhaitez archiver les journaux ou les intégrer.

Utilisation des journaux du service OSDU dans l’espace de travail Log Analytics

  1. Accédez à l’onglet Journaux dans le volet gauche.

  2. Développez la liste des tables sous catégorie Gestion des journaux. Les journaux du service OSDU exportés à l’aide d’un paramètre de diagnostic s’affichent dans la table OEPDataplaneLogs .

  3. Accédez au volet de l’éditeur. Ici, vous pouvez écrire des requêtes Langage de requête Kusto (KQL) pour filtrer vos journaux de service OSDU et afficher uniquement les journaux pertinents.

    Screenshot shows the different parts of a Log Analytics workspace interface.

Résolution des problèmes avec les journaux du service OSDU

L’analyse des journaux de service OSDU dans Azure Monitor peut vous aider à identifier les erreurs et les problèmes liés à des services et API spécifiques. Examinez les journaux d’activité des services tels que le service de flux de travail, le service de partition ou les droits d’utilisation pour identifier et résoudre rapidement les problèmes liés aux appels d’API ou aux fonctionnalités de service.

L’éditeur de requête de l’espace de travail Log Analytics prend en charge les requêtes KQL. Voici quelques exemples de requêtes qui peuvent être utiles :

  • Requête permettant de filtrer les journaux du service OSDU générés par un service spécifique dans votre Azure Data Manager for Energy au cours des 6 dernières heures.
OEPDataplaneLogs
| where TimeGenerated >= ago(6h)
| where _ResourceID contains "name-of-your-adme-instance"
| where Category = "DatasetLogs"
  • Requête permettant de filtrer les journaux d’activité pour tous les appels de service OSDU qui ont entraîné des erreurs aujourd’hui.
OEPDataplaneLogs
| where _ResourceID contains "name-of-your-adme-instance"
| where TimeGenerated >= startofday(ago(0d))
| where TimeGenerated < startofday(ago(-1d))
| where LogLevel != "INFO"

Archivage des journaux du service OSDU sur des comptes de stockage

Vous pouvez archiver les journaux du service OSDU sur des comptes de stockage et tirer parti des fonctionnalités d’Azure Monitor pour l’archivage des journaux, les stratégies de rétention, etc. :

  • Spécifiez le compte de stockage pour les journaux d’archivage pendant le processus de création du paramètre de diagnostic.
  • Définissez des stratégies de rétention pour les journaux archivés.
  • Accédez aux journaux d’activité dans le compte de stockage pour une autre analyse ou un stockage à long terme.

Étapes suivantes

Maintenant que vous collectez les journaux du service OSDU, créez une alerte de requête de journal pour être avertie de manière proactive lorsque des données intéressantes sont identifiées dans vos données de journal.

Créer une alerte de requête de journal pour une ressource Azure