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 la solution 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 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 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 la configuration automatisée qui importe leurs données de modèle d'entité, telles que les associations d'entités, et les informations sur les propriétés d'EM vers Oracle Logging Analytics. Les informations d'association d'entité sont ensuite utilisées pour construire la topologie dans Oracle Logging Analytics.

Pour 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 Logging Analytics. Par conséquent, vous pouvez exploiter les cibles repérées dans EM pour accélérer l'intégration dans Logging Analytics au lieu de les créer à nouveau.

  • La topologie d'EM, y compris celle des cibles composites complexes, est conservée et reproduite dans Oracle Logging Analytics. Les associations cible dans EM sont converties en relations d'entité dans Oracle Logging Analytics afin d'éviter 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 Logging 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 Logging 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.

    • Périodicité de transmission des informations à partir d'EM et de collecte ultérieure dans Oracle Logging Analytics :

      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

Afin de 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 Logging Analytics. Créez un pont cloud dans votre environnement surveillé EM pour exporter les informations cible vers OCI Object Storage. Après avoir confirmé que les données d'entité sont collectées dans Object Storage, créez un pont EM entre Object Storage et Oracle Logging Analytics pour importer les informations d'entité vers Oracle Logging Analytics. Les entités sont créées automatiquement dans Oracle Logging Analytics à l'aide des informations d'entité collectées dans EM. Pour collecter les journaux à partir de vos cibles dans EM, associez les entités créées automatiquement à des sources de journal afin que les journaux puissent être collectés à l'aide des agents de gestion.

Voici la présentation des étapes de collecte des données EM et des journaux :

  1. Créez un bucket 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 de compartiment et du nom de bucket indiqués dans EM lors de la configuration du 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 de gestion sur les 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

    • Installation des agents de gestion

  5. Créez des stratégies IAM pour collecter les informations d'entité à partir d'Object Storage. Reportez-vous à Autorisation des 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 de journal complète pour la surveillance des cibles EM. Lorsque vous créez le pont EM, les entités sont créées automatiquement dans Oracle Logging 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 Logging 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 démarrer à partir des cibles EM vers Oracle Logging Analytics. Vous pouvez les afficher dans l'explorateur de journaux.

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 les données vers Oracle Logging Analytics.

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

  • Exportez les données 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 Logging 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 fournissant des droits d'accès 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'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 fournissant des droits d'accès 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'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

Utiliser dispose du même niveau de droits d'accès et d'opérations d'API que Lecture.

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

Ajout d'un pont EM

  1. Dans Logging 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 de stockage d'objet : compartiment dans Object Storage dans lequel les données EM sont stockées.

    5. Sous Configuration du pont côté OEM, section Bucket Object Storage : 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 d'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é Logging Analytics correspondant Propriétés de cible EM Propriétés d'entité Logging 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