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 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 Icône d'actions 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 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 et INSTALL_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

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 myhost.example.com and if the preference USE_CUSTOM_HOSTNAME_FROM_TAG is set to tagForHostNameOverride and the Management Agent resource has a free form tag tagForHostNameOverride set to value -customEnvName-, then the name of the Log Analytics Host entity is either -customEnvName-myhost.example.com or myhost.example.com-customEnvName- depending on whether Prefix or Suffix option is specified for the USE_CUSTOM_HOSTNAME_POSITION preference.

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