Collecter des données de modèle d'entité à partir d'Enterprise Manager Cloud Control et collecter des journaux

Oracle Enterprise Manager Cloud Control (EM) est la solution de gestion des technologies de l'information d'entreprise (TI) d'Oracle, qui fournit une solution complète, intégrée et axée sur l'entreprise pour la gestion en nuage. EM collecte des informations supplémentaires sur les entités telles que les informations de configuration nécessaires pour localiser les fichiers journaux et les relations entre les entités afin de fournir des vues topologiques des applications. Ces vues topologiques sur l'ensemble des composants de la pile d'applications permettent de résoudre facilement les problèmes de disponibilité et de performances des applications. Les utilisateurs existants d'EM peuvent configurer le pont EM et tirer parti de la configuration automatisée qui importe leurs données de modèle d'entité, comme les associations d'entités, et les informations sur les propriétés d'EM dans Oracle Log Analytics. Les informations d'association d'entité sont ensuite utilisées pour construire la topologie dans Oracle Log Analytics.

Plus d'informations sur la collecte des données à partir d'EM :

  • Les cibles EM qui représentent les ressources sur place sont des équivalents des entités dans Oracle Log Analytics. Par conséquent, vous pouvez tirer parti des cibles détectées dans EM pour accélérer l'intégration dans Oracle Log Analytics au lieu de les recréer.

  • La topologie dans EM, y compris celle des cibles composites complexes, est conservée et reproduite dans Oracle Log Analytics. Les associations cibles dans EM sont converties en relations d'entité dans Oracle Log Analytics afin d'éviter la perte d'informations.

  • Les métadonnées cibles pertinentes dans EM sont stockées en tant que propriétés d'entité dans Oracle Log Analytics, ce qui permet une meilleure surveillance de ces ressources EM.

  • Les propriétés d'entité sont mises à jour périodiquement avec les informations cibles transférées d'EM vers le stockage d'objets OCI, puis collectées par Oracle Log Analytics à l'aide d'un pont EM.

    • Immédiatement après la configuration du pont EM, les informations sur les cibles EM et leurs associations sont collectées.

    • La périodicité de la transmission des informations à partir d'EM et de leur collecte dans Oracle Log Analytics ultérieurement :

      Mesures de configuration et associations cibles : Tous les jours

      Propriétés cible et cible : Horaire

Aperçu du flux de travail de collecte des données à partir d'EM :


Aperçu du flux de travail de collecte des données à partir d'EM

Pour pouvoir collecter le modèle de données d'entité à partir d'EM, vous devez d'abord regrouper les cibles dans EM pour le service Oracle Log Analytics. Créez un pont en nuage dans votre environnement surveillé EM pour exporter les informations cibles vers le stockage d'objets OCI. Après avoir vérifié que les données d'entité ont été collectées dans le service de stockage d'objets, créez un pont EM entre le service de stockage d'objets et Oracle Log Analytics pour importer les informations d'entité dans Oracle Log Analytics. Les entités sont créées automatiquement dans Oracle Log Analytics à l'aide des informations d'entité collectées auprès d'EM. Pour collecter vos journaux à partir de vos cibles dans EM, associez les entités créées automatiquement à des sources de journaux afin que les journaux puissent être collectés à l'aide des agents de gestion.

Voici la marche à suivre pour collecter des données EM et des journaux :

  1. Créez un seau de stockage d'objets OCI pour collecter les données cibles à partir d'EM. Voir Créer un seau à l'aide de la console.

  2. Avant de configurer le pont EM, vous devez préparer l'environnement EM pour exporter les informations requises vers OCI. Voir Préalables pour la création du pont EM.

    À ce stade, la connectivité OCI est configurée et les données cibles sont automatiquement chargées à intervalles réguliers vers le stockage d'objets OCI.

  3. À l'aide du nom du compartiment et du nom du seau que vous avez spécifiés dans EM lors de la configuration du pont en nuage, vérifiez dans le stockage d'objets OCI que les données d'entité ont bien été collectées. Voir Voir les détails du seau à l'aide de la console dans la documentation sur Oracle Cloud Infrastructure.

  4. Installez les agents de gestion sur vos hôtes EM pour collecter en continu les journaux des entités EM :

    Voir Documentation sur les agents de gestion Oracle pour effectuer les tâches suivantes :

    • Préalables pour le déploiement des agents de gestion

    • Installer les agents de gestion

  5. Créez des politiques GIA pour collecter les informations sur l'entité à partir du stockage d'objets. Voir Autoriser les utilisateurs à effectuer des opérations de pont EM.

  6. Maintenant que les informations sur l'entité sont disponibles dans le service de stockage d'objets OCI, créez un pont EM pour les collecter et créez le modèle de données d'entité qui aide à effectuer une analyse complète des journaux pour surveiller les cibles EM. Lors de la création du pont EM, les entités sont créées automatiquement dans Oracle Log Analytics.

    Note

    • Opération Créer un pont EM :

      Chaque pont EM doit avoir un nom d'affichage unique dans une location spécifique.

      Il ne peut y avoir qu'un pont EM pour un seau de magasin d'objets OCI spécifique dans une location indiquée.

    • Opération Supprimer un pont EM :

      Si vous supprimez un pont EM, les entités créées automatiquement à l'aide du pont EM ne seront pas supprimées.

      Si une cible est supprimée dans EM, l'entité correspondante n'est pas automatiquement supprimée dans Oracle Log Analytics.

    • Modification du compartiment du pont EM :

      Cette opération déplace uniquement la ressource de pont EM vers un autre compartiment. Les entités créées automatiquement lors de la création du pont EM ne peuvent pas être déplacées vers d'autres compartiments.

  7. Veillez à activer la fonction d'association automatique pour les sources spécifiques que vous souhaitez associer aux entités EM. Voir Activer l'association automatique pour une source. Après la création du pont EM, les entités admissibles sont automatiquement associées aux sources pertinentes.

À ce stade, les journaux commenceront à collecter des cibles EM dans Oracle Log Analytics. Vous pouvez les afficher dans l'explorateur de journaux.

Pour arrêter la collecte des journaux à partir de vos cibles EM, voir Arrêter la collecte de journaux basée sur un agent.

Préalables pour la création du pont EM

Avant de créer le pont EM pour collecter les données d'entité à partir du stockage d'objets, vous devez effectuer les tâches suivantes dans l'environnement EM. Pour des étapes détaillées, voir Intégration d'Enterprise Manager avec les services OCI dans le Guide de l'administrateur d'Enterprise Manager Cloud Control.

  • Définissez des données d'identification nommées globales dans Enterprise Manager pour OCI.

  • Configurez un utilisateur exclusif pour la connexion à Enterprise Manager.

  • Créez un groupe Enterprise Manager contenant les cibles pour lesquelles vous voulez exporter des données vers Oracle Log Analytics.

  • Définissez les informations d'identification privilégiées d'hôte pour tous les hôtes OMS.

  • Exportez les données Enterprise Manager vers OCI en créant un pont vers le nuage. Sélectionnez Logging Analytics comme Service OCI qui utilisera les données et spécifiez le groupe cible que vous avez créé précédemment.

  • Vérifiez le statut de chargement des données pour Oracle Log Analytics côté EM.

Autoriser les utilisateurs à effectuer des opérations de pont EM

Type de ressource individuel : loganalytics-em-bridge

Partie du type de ressource agrégé : loganalytics-resources-family

Cas d'utilisation Politiques GIA

Le pont EM peut se trouver dans n'importe quel compartiment de la location

  1. Exemple de règle pour créer un groupe dynamique pour les ressources de pont EM :

    ALL {resource.type='loganalyticsembridge'}

  2. Exemple d'énoncé de politique pour fournir des autorisations aux utilisateurs ou aux groupes d'utilisateurs pour gérer la ressource de pont EM :

    allow group <user_group> to MANAGE loganalytics-em-bridge in tenancy

  3. Exemple d'énoncé de politique permettant au groupe dynamique de ressources de pont EM de lire le stockage d'objets :

    allow dynamic-group <group_name> to read objects in tenancy

Le pont EM peut se trouver dans un compartiment spécifique

  1. Exemple de règle pour créer un groupe dynamique pour les ressources de pont EM :

    ALL {resource.type='loganalyticsembridge', resource.compartment.id=<loganalyticsembridge_resource_compartment_OCID>}

  2. Exemple d'énoncé de politique pour fournir des autorisations aux utilisateurs ou aux groupes d'utilisateurs pour gérer la ressource de pont EM :

    allow group <user_group> to MANAGE loganalytics-em-bridge in compartment id <compartment_OCID>

  3. Exemple d'énoncé de politique permettant au groupe dynamique de ressources de pont EM de lire le stockage d'objets :

    allow dynamic-group <group_name> to read objects in compartment <compartment_name>

Les exemples ci-dessus fournissent l'autorisation MANAGE pour loganalytics-em-bridge dans la location ou dans un compartiment spécifique.

Les opérations suivantes peuvent être effectuées avec chaque verbe lorsque vous créez une politique IAM pour loganalytics-em-bridge :

Inspect Read Use Manage

Lister les ponts EM et leur sommaire

Obtenir des détails sur un pont EM

Le service Utilisation a le même niveau d'autorisations et d'opérations d'API que le service Lecture.

Créez, mettez à jour ou supprimez un pont EM ou déplacez-le vers un autre compartiment.

Ajouter un pont EM

  1. Dans Log Analytics, cliquez sur Administration. La page Aperçu de l'administration s'ouvre.

  2. Cliquez sur Ponts EM dans la liste des ressources disponibles.

    La page de liste Ponts EM affiche tous les ponts EM disponibles.

  3. Cliquez sur Créer un pont.

    La boîte de dialogue Créer un pont apparaît.

  4. Entrez les informations suivantes :

    1. Nom du pont : Nom d'affichage du pont EM

    2. Compartiment de ponts : Compartiment dans lequel la ressource de pont EM doit être créée. Ce paramètre est automatiquement réglé au compartiment que vous sélectionnez dans la page de liste Ponts EM.

    3. Description (facultatif) : Description du pont EM

    4. Sous Configuration du pont côté OEM, section Compartiment de stockage d'objets : Compartiment du stockage d'objets dans lequel les données EM sont stockées

    5. Sous Configuration du pont côté OEM, section Compartiment de stockage d'objets : Nom du seau dans le stockage d'objets où les données EM sont stockées

    6. Compartiment d'entité : Compartiment dans lequel les entités doivent être créées

    Cliquez sur Créer.

Opérations de pont EM à l'aide de l'interface de ligne de commande

Avant de commencer à utiliser l'interface de ligne de commande pour effectuer des opérations de pont EM :

Lister les opérations de pont EM disponibles

Voir em-bridge.

Créer un pont EM

Pour créer un pont EM, voir em-bridge : create. Par exemple :

oci log-analytics em-bridge create -ns <Namespace> -c <Object_Storage_Compartment_OCID> --display-name <EM_Bridge_Name> --bucket-name <Object_Storage_Bucket_Name> --description "<EM_Bridge_Description>" --em-entities-compartment-id <Entity_Compartment_OCID>

Dans l'exemple de commande d'interface de ligne de commande ci-dessus :

  • Namespace : Espace de noms de votre location

  • Object_Storage_Compartment_OCID : OCID du compartiment dans le stockage d'objets où les données EM sont stockées

  • EM_Bridge_Name : Nom d'affichage du pont EM

  • Object_Storage_Bucket_Name : Nom du seau dans le stockage d'objets où les données EM sont stockées

  • EM_Bridge_Description : Description du pont EM

  • Entity_Compartment_OCID : OCID du compartiment dans lequel les entités doivent être créées

Obtenir les détails sur un pont EM

Pour obtenir des détails sur le pont EM, voir em-bridge : get.

Exemples de commande permettant d'obtenir plus de détails sur le pont EM :

  1. oci log-analytics em-bridge get -ns <Namespace> --bridge-id <EM_Bridge_OCID>
  2. oci log-analytics entity get -ns <Namespace> --bridge-id <EM_Bridge_OCID>

Lister les ponts EM

Pour lister les ponts EM, voir em-bridge : list.

Exemple de commande pour lister les ponts EM :

oci log-analytics em-bridge list -ns <Namespace> -c <EM_Bridge_Compartment_OCID>

Opérations de pont EM à l'aide de l'API REST

Vous pouvez effectuer les opérations de pont EM suivantes à l'aide de l'API :

Types de cible EM et propriétés collectés

Le pont EM prend en charge les types de cible suivants et leurs propriétés :

Type de cible EM Type d'entité Log Analytics Propriétés de la cible EM Propriétés d'entité Log Analytics
Service à haute disponibilité Oracle Noeud de grappe Oracle

NodeName

-

OracleHome

node_name

omc_crs_base

oracle_home

Hôte

Hôte (AIX)

Hôte (HP-UX)

Hôte (Linux)

Hôte (Solaris)

Hôte (Windows)

Aucune Aucune
OC4J OC4J

-

omc_server_log_path

Serveur HTTP Oracle Serveur HTTP Oracle

{DOMAIN_HOME}{OracleInstance}

ComponentName

ohs_home

component_name

Instance de base de données Instance Oracle Database

-

MachineName

Port

ADRHome

SID

ServiceName

OracleHome

diagnostic_dest

audit_file_dest

audit_dest

host_name

port

adr_home

sid

service_name

oracle_home

DIAGNOSTIC_DEST

AUDIT_FILE_DEST

Système de base de données Système Oracle Database

Aucune

Aucune

Oracle Internet Directory Oracle Internet Directory

IASInternalName

OracleInstance

ias_internal_name

oracle_instance

Module d'écoute Module d'écoute Oracle Database

OracleHome

ADRHome

{ORACLE_HOME}/../diag/tnslsnr/*/{LSNR_ALIAS}/alert

Machine

{ORACLE_HOME}/../diag/tnslsnr/*/{LSNR_ALIAS}/trace

oracle_home

adr_home

log_dir_path

host_name

trace_dir_path

Base de données enfichable Base de données enfichable Oracle

Name

MachineName

Port

SID

ServiceName

-

pdb_name

host_name

port

sid

service_name

domain_name

Oracle VM Manager Oracle VM Manager

Aucune

Aucune

Groupe de serveurs de machine virtuelle Oracle Groupe de serveurs de machine virtuelle Oracle

Aucune

Aucune

Gestion automatique du stockage de grappe Gestion automatique du stockage

Aucune

Aucune

Gestion automatique du stockage Instance de gestion automatique du stockage

AdrHome

adr_home

Base de données de grappe Oracle Database

Aucune

Aucune

Composant Siebel Composant Siebel

-

SARMLogDirectory

siebel_component_log_file_name

siebel_component_sarm_log_directory

Siebel Enterprise Oracle Siebel Enterprise

Aucune

Aucune

Serveur Siebel Serveur Siebel

filesystem:installdir

filesystem:logdir

-

siebel_server_install_dir

siebel_server_log_dir

siebel_component_sarm_log_directory

Grappe Oracle WebLogic Grappe WebLogic

DOMAIN_HOME

omc_weblogic_cluster_home

Domaine Oracle WebLogic Domaine WebLogic

DOMAIN_HOME

WebLogicHome

domain_home

weblogic_home

Serveur Oracle WebLogic Server Serveur WebLogic

DOMAIN_HOME

ServerNames

domain_home

server_names

Gestionnaire de noeuds Oracle WebLogic Gestionnaire de noeuds WebLogic

-

omc_nodemanager_home