Gestion d'entités

Une entité est une ressource dans Log Analytics servant à référencer la ressource réelle sur l'hôte on-premise ou virtuel. Après avoir repéré l'entité dans Log Analytics, vous pouvez l'associer à une source du journal et activer la collecte de journaux à partir de celle-ci.

Ressources utiles :

• Pour en savoir plus sur une entité, reportez-vous à la section Concepts et termes de Log Analytics.

• Pour créer une entité, reportez-vous à Création d'une entité pour représenter votre ressource émettrice de journal. De plus, Log Analytics permet de la modifier ultérieurement, de le déplacer d'un compartiment à un autre et d'effectuer plusieurs autres tâches de gestion, comme indiqué ci-dessous.

• Pour lancer le repérage d'entités telles que les applications packagées, les bases de données, le middleware et d'autres composants, reportez-vous à Détection automatique des entités et de la collecte de journaux.

• Une entité doit être d'un certain type. Près de 100 types d'entité définis par Oracle sont déjà disponibles. Reportez-vous à Types d'entité modélisés dans Log Analytics. Vous pouvez également créer des types d'entité personnalisés. Lorsqu'une entité est créée, un type d'entité définit les propriétés utilisées pour localiser l'emplacement des fichiers journaux. Par exemple, pour le type d'entité Oracle Database, vous devez fournir des valeurs de chemin pour les propriétés telles que ADR_HOME, ORACLE_HOME et INSTALL_HOME. Vous pouvez créer des types d'entité à l'aide de l'interface de ligne de commande ou de l'API REST. Reportez-vous à API Log Analytics et à Référence de ligne de commande.

• Lorsque vous utilisez des agents de gestion pour collecter les journaux en continu, vous devez configurer une association source-entité pour permettre à une source d'entités spécifiques de collecter les données de journal. Reportez-vous à Gestion d'une association source-entité.

• Pour arrêter la collection de journaux d'une entité, dissociez l'entité de la source. Reportez-vous à Arrêt de la collecte de journal à partir d'une entité.

Pour exécuter d'autres actions sur l'entité, sur la page Entités, sélectionnez le compartiment de l'entité dans la section Portée des entités et affinez la recherche en sélectionnant le type d'entité dans la section Filtres. Après avoir identifié l'entité, cliquez sur l'icône Actions de la ligne correspondante :

• Afficher les détails : la page de l'entité apparaît. Dans l'onglet Informations sur l'entité, vous pouvez visualiser le type de l'entité, son OCID, le type de création, le compartiment dans lequel elle réside, les détails de l'agent de gestion, l'heure de sa création et de sa dernière mise à jour, ainsi que les sources associées. Cliquez sur l'icône Modifier en regard de Agent de gestion pour mettre à jour les informations sur l'agent. Dans l'onglet Balises, vous pouvez afficher les balises associées à l'entité. Cliquez sur le bouton Ajouter une balise pour en ajouter une.

  Vous pouvez également cliquer sur le bouton Modifier, Déplacer la ressource, Ajouter des balises ou Supprimer sur la page de l'entité pour effectuer les actions correspondantes.

• Modifier : la boîte de dialogue Modifier l'entité apparaît. Pour ajouter d'autres propriétés, cliquez sur le bouton Ajouter de la section Propriétés, et indiquez le nom et la valeur de la propriété. Cliquez sur Enregistrer les modifications.

  Ces propriétés permettent de localiser l'emplacement des fichiers journaux. Par exemple, pour le type d'entité Oracle Database, vous devez fournir des valeurs de chemin pour les propriétés telles que ADR_HOME, ORACLE_HOME et INSTALL_HOME.

• Ajouter des données : la boîte de dialogue Configurer la collecte de journaux basée sur l'agent ou Configurer la collecte de journaux pour les ressources OCI apparaît selon que l'entité est une ressource OCI ou non OCI. Les assistants vous aident à associer l'entité à une source appropriée. Cela permet de configurer l'analyseur et le filtre pour traiter les enregistrements de journal provenant de l'entité.

• Télécharger des fichiers : l'assistant Télécharger des fichiers s'ouvre. Suivez les étapes de l'assistant pour télécharger les fichiers journaux associés à l'entité. Cela est particulièrement utile pour télécharger un lot de fichiers qui ne font pas partie d'une collecte de journaux continue ou qui appartiennent à une période en dehors de ce qui est défini pour la collecte.

• Copier l'OCID : l'OCID de la ressource d'entité est copié. Vous pouvez l'utiliser pour faire référence à cette ressource partout dans Oracle Cloud Infrastructure.

• Déplacer la ressource : la boîte de dialogue Déplacer la ressource vers un autre compartiment apparaît. Dans les options, sélectionnez le compartiment vers lequel déplacer l'entité, puis cliquez sur Déplacer la ressource.

• Ajouter une balise : reportez-vous à l'ajout de balises aux ressources Log Analytics.

• Supprimer : vous devrez peut-être supprimer certaines de vos entités anciennes ou inutilisées pour respecter les limites de service de Log Analytics. Reportez-vous à Limites par service dans la documentation Oracle Cloud Infrastructure. Pour supprimer l'entité, confirmez l'opération dans la boîte de dialogue Supprimer une entité.

  Remarque
  
  

  Les entités que vous avez supprimées à l'aide de l'API de suppression d'entité peuvent réapparaître dans votre liste d'entités dans l'une des circonstances suivantes :

  • Les nouveaux journaux sont propagés pour les entités supprimées via Service Connector Hub ou les collections Object Storage.

  • Les nouveaux téléchargements de pont EM contiennent l'entité supprimée.