Gérer les entités
Une entité est une ressource Log Analytics qui est utilisée pour référencer la ressource réelle sur votre hôte sur place ou sur votre hôte virtuel. Après avoir détecté cette entité dans Log Analytics, vous pouvez l'associer à une source de journaux et activer la collecte de journaux à partir de celle-ci.
Ressources utiles :
-
Pour en savoir plus sur une entité, voir Termes et concepts relatifs à Log Analytics.
-
Pour créer une entité, voir Créer une entité pour représenter votre ressource émettrice de journaux. De plus, Log Analytics vous permet de la modifier ultérieurement, de la déplacer d'un compartiment à un autre et d'effectuer plusieurs autres tâches de gestion comme indiqué ci-dessous.
-
Pour lancer la détection d'entités telles que les applications groupées, les bases de données, l'intergiciel et d'autres composants, voir Détection automatique des entités et collecte de journaux.
-
Une entité doit avoir un type d'entité. Près de 100 types d'entité définis par Oracle sont déjà disponibles. Voir 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. For example, in an Oracle Database entity type, you must provide path values for properties such as
ADR_HOME
,ORACLE_HOME
, andINSTALL_HOME
. Vous pouvez créer de nouveaux types d'entité à l'aide de l'API REST ou de l'interface de ligne de commande. Voir API Log Analytics et Informations de référence sur la ligne de commande. -
Lorsque vous utilisez des agents de gestion pour collecter des journaux en continu, vous devez configurer une association source-entité pour permettre à une source de collecter les données des journaux pour des entités spécifiques. Voir Gérer l'association source-entité.
-
Pour arrêter la collecte de journaux d'une entité, dissociez l'entité de la source. Voir Arrêter la collecte de journaux à partir d'une entité.
Pour effectuer d'autres actions sur l'entité, dans la page Entités, sélectionnez le compartiment de l'entité dans la section Portée des entités et affinez la recherche de l'entité en sélectionnant le type d'entité dans la section Filtres. Après avoir identifié votre entité, cliquez sur l'icône Actions dans la rangée de votre entité :
-
Voir les détails : La page des entités est affichée. Dans l'onglet Informations sur l'entité, vous pouvez voir le type d'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 création et de dernière mise à jour et les sources associées. Cliquez sur l'icône Modifier
à côté de Agent de gestion pour mettre à jour les informations sur l'agent. Dans l'onglet Marqueurs, vous pouvez voir les marqueurs associés à l'entité. Cliquez sur le bouton Ajouter un marqueur pour en ajouter un.
De plus, cliquez sur le bouton Modifier, Déplacer la ressource, Ajouter des marqueurs ou Supprimer dans la page d'entité pour effectuer les actions correspondantes.
-
Modifier : La boîte de dialogue Modifier l'entité est affichée. Pour ajouter d'autres propriétés, cliquez sur le bouton Ajouter dans la section Propriétés et spécifiez le nom de propriété et la valeur de propriété. Cliquez sur Enregistrer les modifications.
Ces propriétés permettent de localiser l'emplacement des fichiers journaux. Par exemple, dans un type d'entité Oracle Database, vous devez fournir des valeurs de chemin pour les propriétés telles que
ADR_HOME
,ORACLE_HOME
etINSTALL_HOME
. -
Ajouter des données : La boîte de dialogue Configurer la collecte de journaux basée sur un agent ou Configurer la collecte de journaux pour les ressources OCI s'affiche selon que l'entité est une ressource OCI ou non OCI. Les assistants vous aident à associer l'entité à une source appropriée. Cela configure l'analyseur et le filtre pour traiter les enregistrements de journal provenant de l'entité.
-
Charger des fichiers : L'Assistant Charger des fichiers s'ouvre. Suivez les étapes de l'assistant pour charger les fichiers journaux associés à l'entité. Cela est particulièrement utile pour charger un lot de fichiers qui ne font pas partie de la collecte continue des journaux ou qui appartiennent à un intervalle de temps 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 référencer cette ressource n'importe où dans Oracle Cloud Infrastructure.
-
Déplacer la ressource : La boîte de dialogue Déplacer la ressource vers un autre compartiment s'affiche. Dans les options, sélectionnez le compartiment vers lequel vous voulez déplacer l'entité et cliquez sur Déplacer la ressource.
-
Ajouter un marqueur : Ajouter des marqueurs aux ressources Log Analytics.
-
Supprimer : Vous devrez peut-être supprimer certaines de vos anciennes entités ou de vos entités inutilisées pour vous conformer aux limites de service de Log Analytics. Voir Limites par service dans la documentation sur Oracle Cloud Infrastructure. Pour supprimer l'entité, confirmez la suppression dans la boîte de dialogue Supprimer l'entité.
Note
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'un des cas suivants :
-
Les nouveaux journaux sont poussés pour les entités supprimées au moyen du centre de connecteurs de service ou des collections du service de stockage d'objets.
-
Les nouveaux chargements de pont EM contiennent l'entité supprimée.
-
Gérer les préférences d'entité
Vous pouvez gérer les préférences par défaut pour les entités au moyen du groupe de préférences entityLifecycle
. Créer des politiques IAM pour permettre aux utilisateurs de lire, de mettre à jour et de supprimer les préférences d'entité.
Pour plus de détails sur les groupes de préférences et les politiques IAM pour les préférences, voir Préférences d'opération de service Log Analytics.
Pour que l'API REST gère les préférences dans Oracle Log Analytics, voir Informations de référence sur l'API Log Analytics.
Rubriques :
- Préférences d'entité dans le groupe de préférences entityLifecycle
- Types d'entité pour la préférence AUTO_DELETE_SCH_ENTITIES_OF_TYPES
Préférences d'entité dans le groupe de préférences entityLifecycle
Fonction | Nom de préférence | Valeurs autorisées | Détails |
---|---|---|---|
Cycle de vie des entités d'agent et d'hôte dans Oracle Log Analytics | AUTO_CREATE_AGENT_HOST_ENTITY |
VRAI/FAUX |
TRUE (Valeur par défaut) : Les entités pour l'agent et l'hôte sont créées automatiquement. FALSE : Les entités pour l'agent et l'hôte ne sont pas créées. |
AUTO_DELETE_AGENT_ENTITY |
VRAI/FAUX |
FALSE (Valeur par défaut) : Les entités d'agent ne sont pas supprimées lorsque les agents de gestion sont supprimés. TRUE : Les entités d'agent sont supprimées lorsque les agents de gestion sont supprimés. |
|
AUTO_DELETE_HOST_ENTITY |
VRAI/FAUX |
FALSE (Valeur par défaut) : Les entités hôtes ne sont pas supprimées lorsque les agents de gestion sont supprimés. TRUE : Les entités d'hôte sont supprimées lorsque les agents de gestion sont supprimés. |
|
Suppression d'entités créées automatiquement pour les journaux reçus au moyen du centre de connecteurs de service dans Oracle Log Analytics | AUTO_DELETE_SCH_ENTITIES_OF_TYPES |
Liste séparée par des virgules des types d'entité pris en charge / _ALL_ / <empty> (aucun jeu de valeurs) |
<vide> (aucun jeu de valeurs) (valeur par défaut) : Les entités ne sont pas supprimées. _ALL_ : Les entités sont supprimées pour tous les types pris en charge lorsque les ressources OCI sous-jacentes sont supprimées. Liste séparée par des virgules : Les entités sont supprimées pour les types d'entité spécifiés lorsque les ressources OCI sous-jacentes sont supprimées. |
Attribution de nom personnalisé pour les entités d'hôte créées automatiquement dans Oracle Log Analytics | USE_CUSTOM_HOSTNAME_FROM_TAG |
<tagKeyName> à partir des marqueurs à structure libre de l'agent |
Par défaut, Oracle Log Analytics utilise le nom d'hôte fourni par la ressource d'agent de gestion lors de la création de l'entité hôte. Pour remplacer ce nom d'hôte, un marqueur à structure libre peut être défini dans la ressource d'agent de gestion. La valeur du marqueur est utilisée pour remplacer le nom utilisé pour l'entité hôte. Si la préférence est définie et que le marqueur à structure libre n'est pas défini dans la ressource d'agent de gestion, l'entité hôte n'est pas créée. La valeur du marqueur est soit préfixée (par défaut), soit suffixée au nom d'hôte fourni par l'agent. Example: If the hostname reported by Management Agent service is |
USE_CUSTOM_HOSTNAME_POSITION |
Préfixe / Suffixe | Voir les détails pour USE_CUSTOM_HOSTNAME_FROM_TAG .
|
Types d'entité pour la préférence AUTO_DELETE_SCH_ENTITIES_OF_TYPES
Type d'entité Log Analytics | Ressource OCI |
---|---|
oci_analytics_cloud_instance | Analytics Cloud |
oci_api_gateway | Passerelle d'API |
oci_apm_domain | Domaine APM |
oci_compute_instance | Calculer |
oci_data_flow_application | Flux de données |
oci_devops_build_pipeline | Pipeline de compilation Devops |
oci_devops_build_pipeline_stage | Étape de pipeline de compilation Devops |
oci_devops_build_run | Exécution du pipeline de compilation Devops |
oci_devops_deployment | Déploiement Devops |
oci_devops_deployment_pipeline | Pipeline de déploiement DevOps |
oci_devops_deployment_stage | Étape de déploiement DevOps |
oci_emailsender | Transmission de messages |
oci_event_rule | Règles d'événement |
oci_functions_app | Applications de fonctions |
oci_functions_function | Fonctions |
oci_load_balancer | Équilibreur de charge |
oci_media_workflow | Flux de travail des services de médias |
oci_media_workflow_job | Tâche de flux de travail des services de médias |
oci_network_firewall | Pare-feu de réseau |
oci_opctloperatorcontrol | Base de données - Contrôle de l'accès des opérateurs Oracle |
oci_os_bucket | Seau de stockage d'objets |
oci_service_connector | Connecteur de service |
oci_vcn | Réseau en nuage virtuel |
oci_vcn_subnet | Sous-réseau de VCN |
oci_vcn_vnic | Carte VNIC du VCN |
oci_vpn_ipsecconnection | Connexion RPV IPSec |
oci_vpn_ipsectunnel | Tunnel RPV IPSec |
oci_webappfirewall | Pare-feu pour application Web |
omc_kubernetes_cluster | OKE |
omc_opc_ics_instance | Instance Integration Cloud Service |
omc_opc_ics_integration | Intégration d'Integration Cloud Service |