Collecte de données de modèle d'entité à partir d'Enterprise Manager Cloud Control et collecte de journaux

Oracle Enterprise Manager Cloud Control (EM) est l'application de gestion des technologies de l'information d'entreprise d'Oracle, qui fournit des fonctions complètes, intégrées et orientées entreprise de gestion cloud. EM collecte des informations supplémentaires sur ces entités, telles que les informations nécessaires à la localisation des fichiers journaux et les relations entre les entités afin d'offrir des vues topologiques des applications. Ces vues topologiques sur les 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 bénéficier de l'installation automatisée qui importe les données du modèle d'entité, telles que 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 site sont équivalentes aux entités dans Oracle Log Analytics. Par conséquent, vous pouvez utiliser les cibles repérées dans EM pour accélérer l'intégration dans Oracle Log Analytics au lieu de les recréer.

  • La topologie d'EM, y compris celle des cibles composites complexes, peut être conservée et reproduite dans Oracle Log Analytics. Les associations cible dans EM sont converties en relations d'entité dans Oracle Log Analytics, ce qui évite la perte d'informations.

  • Les métadonnées cible 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 régulièrement mises à jour avec les informations cible transférées d'EM vers OCI Object Storage, puis collectées par Oracle Log Analytics à l'aide d'un pont EM.

    • Une fois le pont EM configuré, les informations relatives aux cibles EM et à leurs associations sont collectées.

    • 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 de cibles : quotidien

      Propriétés de cible et de cible : horaire

Présentation du workflow de collecte de données à partir d'EM :


Présentation du workflow de collecte de 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 cloud dans votre environnement surveillé EM pour exporter les informations cible vers OCI Object Storage. Après avoir indiqué que les données d'entité sont collectées dans Object Storage, créez un pont EM entre Object Storage 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 les journaux à partir de vos cibles dans EM, associez les entités créées automatiquement à une source de journal afin que les journaux puissent être collectés à l'aide des agents de gestion.

Pour collecter des données EM et des journaux, procédez comme suit :

  1. Créez un compartiment OCI Object Storage pour collecter les données cible à partir d'EM. Reportez-vous à Création d'un bucket : utilisation de la console.

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

    A ce stade, la connectivité OCI est configurée et les données cible sont automatiquement téléchargées à intervalles réguliers vers OCI Object Storage.

  3. A l'aide du nom d'un compartiment et du nom d'un bucket indiqués dans EM lors de la configuration d'un pont cloud, vérifiez dans OCI Object Storage que les données d'entité ont été collectées. Reportez-vous à Visualisation des détails de bucket : utilisation de la console dans la documentation Oracle Cloud Infrastructure.

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

    Reportez-vous à la documentation des agents de gestion Oracle pour effectuer les tâches suivantes :

    • Exécution des prérequis pour le déploiement des agents de gestion

    • Installer les agents de gestion

  5. Créez des stratégies IAM pour collecter les informations d'entité à partir d'Object Storage. Reportez-vous à Autoriser les utilisateurs à effectuer des opérations de pont EM.

  6. Maintenant que les informations d'entité sont disponibles dans OCI Object Storage, créez un pont EM pour les collecter et créez le modèle De données d'entité qui permet d'effectuer une analyse complète de journal pour la surveillance des cibles EM. Lors de la création du pont EM, les entités sont créées automatiquement dans Oracle Log Analytics.

    Remarque

    • Création d'une opération de pont EM :

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

      Un seul pont EM peut exister pour un bucket de banque d'objets OCI spécifique dans une location donnée.

    • Suppression d'une opération de pont EM :

      Si vous supprimez un pont EM, les entités créées automatiquement à l'aide de ce pont ne sont 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 lorsque vous créez le pont EM ne peuvent pas être déplacées vers d'autres compartiments.

  7. Veillez à activer la fonctionnalité d'association automatique pour les sources spécifiques à associer aux entités EM. Reportez-vous à Activation de l'association automatique pour une source. Après la création du pont EM, les entités éligibles sont automatiquement associées aux sources pertinentes.

A ce stade, la collecte des journaux va commencer à partir des cibles EM vers Oracle Log Analytics. Vous pouvez les afficher dans l'explorateur de journaux.

Pour arrêter la collecte de journaux à partir de vos cibles EM, reportez-vous à Arrêt de la collecte de journaux basée sur un agent.

Prérequis pour la création du pont EM

Avant de créer le pont EM pour collecter les données d'entité à partir d'Object Storage, vous devez effectuer les tâches suivantes dans l'environnement EM. Pour obtenir le détail des étapes, reportez-vous à Intégration d'Enterprise Manager aux services OCI dans le guide de l'administrateur Enterprise Manager Cloud Control.

  • Définissez des informations 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 exporter des données vers Oracle Log Analytics.

  • Définissez les informations d'identification préférées de tous les hôtes OMS.

  • Exportez les données d'Enterprise Manager vers OCI en créant un pont cloud. Sélectionnez Logging Analytics comme service OCI qui utilisera les données et indiquez le groupe de cibles que vous avez créé précédemment.

  • Vérifiez le statut de télé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 agrégé de ressource : loganalytics-resources-family

Cas d'emploi Stratégies IAM

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

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

    ALL {resource.type='loganalyticsembridge'}

  2. Exemple d'instruction de stratégie permettant de fournir des droits d'accès aux utilisateurs ou aux groupes d'utilisateurs pour la gestion de la ressource de pont EM :

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

  3. Exemple d'instruction de stratégie 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 permettant de 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'instruction de stratégie permettant de fournir des droits d'accès aux utilisateurs ou aux groupes d'utilisateurs pour la gestion de la ressource de pont EM :

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

  3. Exemple d'instruction de stratégie 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 le droit d'accès 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 stratégie IAM pour loganalytics-em-bridge :

Inspect Read Use Manage

Répertorier les ponts EM et leur récapitulatif

Obtenir des détails sur un pont EM

Use a le même niveau de droits d'accès et d'opérations d'API que Read.

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

Ajout d'un pont EM

  1. Dans Log Analytics, cliquez sur Administration. La page Présentation de l'administration apparaît.

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

    La page de liste des 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. Saisissez les informations suivantes :

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

    2. Compartiment du pont : compartiment dans lequel la ressource de pont EM doit être créée. Cette valeur est automatiquement définie sur le compartiment que vous sélectionnez sur la page de liste des ponts EM.

    3. Description (facultatif) : description du pont EM.

    4. Sous Configuration du pont côté OEM, section Compartiment Object Storage : compartiment dans Object Storage où les données EM sont stockées.

    5. Sous Configuration du pont côté OEM, section Bucket OCI : nom du bucket dans Object Storage dans lequel 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 du pont EM à l'aide de l'interface de ligne de commande

Avant de commencer à utiliser l'interface de ligne de commande pour effectuer les opérations de pont EM, effectuez les tâches suivantes :

Liste des opérations de pont EM disponibles

Reportez-vous à em-bridge.

Création d'un pont EM

Pour créer un pont EM, reportez-vous à 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 de l'interface de ligne de commande ci-dessus :

  • Namespace : espace de noms de la location

  • Object_Storage_Compartment_OCID : OCID du compartiment d'Object Storage dans lequel les données EM sont stockées

  • EM_Bridge_Name : nom d'affichage du pont EM

  • Object_Storage_Bucket_Name : nom du bucket dans Object Storage dans lequel 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

Obtention des détails relatifs à un pont EM

Pour obtenir des informations détaillées sur le pont EM, reportez-vous à 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>

Liste des ponts EM

Pour répertorier les ponts EM, reportez-vous à em-bridge : list.

Exemple de commande pour répertorier les ponts EM :

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

Opérations du 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 cible EM Propriétés d'entité Log Analytics
Service Haute disponibilité Oracle Noeud de cluster 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)

Aucun Aucun
OC4J OC4J

-

omc_server_log_path

Oracle HTTP Server Oracle HTTP Server

{DOMAIN_HOME}{OracleInstance}

ComponentName

ohs_home

component_name

Instance de base de données Instance de base de données Oracle

-

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 de base de données Oracle

Aucun

Aucun

Oracle Internet Directory Oracle Internet Directory

IASInternalName

OracleInstance

ias_internal_name

oracle_instance

Processus d'écoute Processus d'écoute de base de données Oracle

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 pluggable Base de données pluggable Oracle

Name

MachineName

Port

SID

ServiceName

-

pdb_name

host_name

port

sid

service_name

domain_name

Oracle VM Manager Oracle VM Manager

Aucun

Aucun

Pool de serveurs Oracle VM Pool de serveurs Oracle VM

Aucun

Aucun

Cluster ASM Automatic Storage Management

Aucun

Aucun

Automatic Storage Management Instance Automatic Storage Management

AdrHome

adr_home

Base de données de cluster Base de données Oracle

Aucun

Aucun

Composant Siebel Composant Siebel

-

SARMLogDirectory

siebel_component_log_file_name

siebel_component_sarm_log_directory

Siebel Enterprise Oracle Siebel Enterprise

Aucun

Aucun

Serveur Siebel Serveur Siebel

filesystem:installdir

filesystem:logdir

-

siebel_server_install_dir

siebel_server_log_dir

siebel_component_sarm_log_directory

Cluster Oracle WebLogic Cluster WebLogic

DOMAIN_HOME

omc_weblogic_cluster_home

Domaine Oracle WebLogic Domaine WebLogic

DOMAIN_HOME

WebLogicHome

domain_home

weblogic_home

Oracle WebLogic Server Serveur WebLogic

DOMAIN_HOME

ServerNames

domain_home

server_names

Gestionnaire de noeud Oracle WebLogic Gestionnaire de noeud WebLogic

-

omc_nodemanager_home