Documentación de Oracle Cloud Infrastructure

Recopilación de datos del modelo de entidad de Enterprise Manager Cloud Control y recopilación de logs

Oracle Enterprise Manager Cloud Control (EM) es la solución de administración de tecnología de la información (TI) empresarial de Oracle, que proporciona una solución de gestión en la nube empresarial completa, integrada y basada en la empresa. EM recopila información adicional sobre entidades, como el tipo de información necesaria para localizar archivos log y relaciones entre entidades para proporcionar vistas topológicas de aplicaciones. Estas vistas topológicas en los componentes de la pila de aplicaciones ayudan a solucionar fácilmente las incidencias con la disponibilidad y el rendimiento de las aplicaciones. Los usuarios existentes de EM pueden configurar el puente de EM y beneficiarse de las opciones de configuración automatizadas que importan los datos de sus modelos de entidad, como la información de asociaciones y propiedades de EM a Oracle Log Analytics. A continuación, la información de asociación de entidades se utiliza para crear la topología en Oracle Log Analytics.

Más información sobre la recogida de datos de EM:

  • Los destinos de EM que representan los recursos locales son equivalentes de entidades en Oracle Log Analytics. Por lo tanto, puede aprovechar los destinos detectados en EM para lograr una vinculación más rápida en Oracle Log Analytics en lugar de volver a crearlos.

  • La topología de EM, incluida la de destinos compuestos complejos, se conserva y se reproduce en Oracle Log Analytics. Las asociaciones de destino en EM se convierten en relaciones de entidad en Oracle Log Analytics para evitar la pérdida de información.

  • Los metadatos de destino relevantes en EM se almacenan como propiedades de entidad en Oracle Log Analytics, lo que permite una mejor supervisión de esos recursos de EM.

  • Las propiedades de entidad se actualizan periódicamente con la información del destino que se transfiere de EM a OCI Object Storage y, a su vez, las recopila Oracle Log Analytics mediante el puente para EM.

    • Inmediatamente después de configurar el puente de EM, se recopila la información sobre los destinos de EM y sus asociaciones.

    • La periodicidad de la transmisión de información desde EM y su recopilación en Oracle Log Analytics más adelante:

      Métricas de configuración y asociaciones de destino: diario

      Propiedades de destino y destino: por hora

Visión General del Flujo de Trabajo para Recopilar Datos de EM:


Visión General del Flujo de Trabajo para Recopilar Datos de EM

Para poder recoger el modelo de datos de entidad de EM, primero debe agrupar los destinos en EM para el servicio Oracle Log Analytics. Cree un puente de nube en el entorno supervisado por EM para exportar la información del destino a OCI Object Storage. Después de confirmar que los datos de entidad se recopilan en Object Storage, cree un puente para EM entre Object Storage y Oracle Log Analytics para importar la información de entidad a Oracle Log Analytics. Las entidades se crean automáticamente en Oracle Log Analytics mediante la información de entidad recopilada de EM. Para recopilar los logs de los destinos en EM, asocie las entidades creadas automáticamente a orígenes del log para que los logs se puedan recopilar mediante agentes de gestión.

Estos son los pasos de visión general para recopilar datos de EM y recopilar logs:

  1. Cree un cubo de almacenamiento de objetos de OCI para recopilar los datos de destino de EM. Consulte la sección sobre creación de un cubo con la consola.

  2. Antes de configurar el puente de EM, debe preparar el entorno de EM para exportar la información necesaria a OCI. Consulte Requisitos para crear el puente de EM.

    En este punto, se configura la conectividad de OCI y los datos de destino se cargan automáticamente a intervalos frecuentes en OCI Object Storage.

  3. Mediante el nombre del compartimento y el nombre del cubo especificados en EM al configurar el puente de Cloud, verifique en OCI Object Storage que los datos del entidad se han recopilado correctamente. Consulte la sección sobre visualización de detalles del cubo con la consola en la documentación de Oracle Cloud Infrastructure.

  4. Instale las instancias de Management Agent en los hosts de EM para recopilar continuamente logs de las entidades de EM:

    Consulte la documentación de los agentes de Oracle Management Agent para realizar las siguientes tareas:

    • Tareas necesarias para desplegar agentes de gestión

    • Instalación de instancias de Management Agent

  5. Cree políticas de IAM para recopilar la información de entidad de Object Storage. Consulte Permitir que los usuarios realicen operaciones de puente de EM.

  6. Ahora que la información sobre la entidad está disponible en OCI Object Storage, cree un Puente de EM para recopilarla y cree el modelo a partir de datos de entidad que ayude a realizar un análisis de log completo para supervisar los destinos de EM. Al crear el puente de EM, las entidades se crean automáticamente en Oracle Log Analytics.

    Nota

    • Operación de creación de puente de EM:

      Cada puente de EM debe tener un nombre mostrado único en un arrendamiento específico.

      Solo puede haber un puente de EM para un cubo de almacenamiento de objetos de OCI específico en un arrendamiento determinado.

    • Operación de supresión de puente de EM:

      Si suprime un puente de EM, no se suprimirán las entidades creadas automáticamente con el puente de EM.

      Si se suprime un destino en EM, la entidad correspondiente no se suprime automáticamente en Oracle Log Analytics.

    • Cambio del compartimento del puente de EM:

      Con esta operación solo se mueve el recurso del puente de EM a otro compartimento. Las entidades que se crean automáticamente al crear el puente de EM no se pueden mover a otros compartimentos.

  7. Asegúrese de activar la función de asociación automática para los orígenes específicos que desea asociar a las entidades de EM. Consulte Activación de la asociación automática para un origen. Tras la creación del puente de EM, las entidades elegibles se asocian automáticamente a los orígenes pertinentes.

En este punto, los logs comenzarán a recopilar desde los destinos de EM a Oracle Log Analytics. Puede verlos en el explorador de logs.

Para dejar de recopilar logs de los destinos de EM, consulte Parada de la Recopilación de Logs Basada en Agente.

Requisitos para crear el puente de EM

Antes de crear el puente en EM para recopilar los datos de entidad de Object Storage, debe realizar las siguientes tareas en el entorno de EM. Para obtener más información sobre los pasos, consulte la sección sobre integración de Enterprise Manager con los servicios de OCI en Enterprise Manager Cloud Control Administrator's Guide.

  • Defina una credencial con nombre global en Enterprise Manager para OCI.

  • Configure un usuario exclusivo para la conexión a Enterprise Manager.

  • Cree un grupo de los Enterprise Manager que contenga los destinos para los que desea exportar datos a Oracle Log Analytics.

  • Defina las credenciales preferidas del host para todos los hosts de OMS.

  • Exporte Enterprise Manager Data a OCI mediante la creación de un puente de Cloud. Seleccione Logging Analytics como Servicio de OCI, que consumirá los datos y especificará el grupo de destino que ha creado anteriormente.

  • Verifique el estado de carga de datos de Oracle Log Analytics en EM.

Permitir a los usuarios realizar operaciones de puente de EM

Tipo de recurso individual: loganalytics-em-bridge

Parte del tipo de recurso agregado: loganalytics-resources-family

Caso de uso Políticas de IAM

El puente de EM puede estar en cualquier compartimento del arrendamiento

  1. Regla de ejemplo para crear un grupo dinámico para recursos de puente de EM:

    ALL {resource.type='loganalyticsembridge'}

  2. Sentencia de política de ejemplo para proporcionar permisos a los usuarios o grupos de usuarios para GESTIONAR el recurso del puente de EM:

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

  3. Sentencia de política de ejemplo para permitir que el grupo dinámico de recursos del puente de EM lea el almacenamiento de objetos:

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

El puente de EM puede estar en un compartimento específico

  1. Regla de ejemplo para crear un grupo dinámico para recursos de puente de EM:

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

  2. Sentencia de política de ejemplo para proporcionar permisos a los usuarios o grupos de usuarios para GESTIONAR el recurso del puente de EM:

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

  3. Sentencia de política de ejemplo para permitir que el grupo dinámico de recursos del puente de EM lea el almacenamiento de objetos:

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

En los ejemplos anteriores se proporciona el permiso MANAGE para loganalytics-em-bridge en el arrendamiento o en un compartimento específico.

Las siguientes operaciones se pueden realizar con cada verbo al crear la política de IAM para loganalytics-em-bridge:

Inspect Read Use Manage

Enumeración de los Puentes de EM y su Resumen

Obtener detalles sobre un puente de EM

Use tiene el mismo nivel de permisos y operaciones de API que Read.

Crear, actualizar o suprimir un puente de EM o moverlo a un compartimento diferente.

Adición de un puente de EM

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Log Analytics, haga clic en Administración.

  2. Los recursos de administración se muestran en el panel en Administración en la izquierda. Haga clic en Puentes de EM. La página de lista de puentes de EM muestra los puentes de EM disponibles.

  3. Haga clic en Crear puente.

    Se abre el cuadro de diálogo Crear puente.

  4. Introduzca la siguiente información:

    1. Nombre de puente: nombre mostrado del puente de EM

    2. Compartimento de puentes: compartimento en el que se debe crear el recurso Puente de EM. Se define automáticamente en el compartimento seleccionado en la página de listado de puentes de EM.

    3. Descripción (opcional): descripción del puente de EM

    4. En Configuración de puente lateral de OEM, sección Compartimento de almacenamiento de objeto: compartimento del almacenamiento de objeto en el que se guardan los datos de EM

    5. En Configuración de puente lateral de OEM, sección Bloque de almacenamiento del objeto: nombre del cubo del almacenamiento de objeto donde se almacenan los datos de EM

    6. Compartimento de entidad: compartimento en el que se deben crear las entidades

    Haga clic en Crear.

Operaciones de puente de EM mediante la CLI

Antes de empezar a usar la CLI para realizar operaciones de puente de EM,

Visualización de las operaciones de puente de EM disponibles

Consulte em-bridge.

Crear un puente de EM

Para crear un puente de EM, consulte em-bridge: create. Por ejemplo: 

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>

En el ejemplo de comando de la CLI anterior:

  • Espacio de nombres: espacio de nombres de su arrendamiento

  • Object_Storage_Compartment_OCID: OCID del compartimento en el almacenamiento de objetos en el que están almacenados los datos de EM

  • Nombre_puente_EM: nombre mostrado del puente de EM

  • Object_Storage_Bucket_Name: nombre del cubo en Object Storage en el que están almacenados los datos de EM

  • EM_Bridge_Description: descripción del puente de EM

  • OCID_compartimento_entidades: OCID del compartimento en el que se deben crear las entidades

Obtener los detalles sobre un puente de EM

Para obtener detalles sobre el puente de EM, consulte em-bridge: get.

Comandos de ejemplo para obtener más información sobre el puente de 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>

Visualización de los puentes de EM

Para mostrar los puentes de EM, consulte em-bridge: list.

Comando de ejemplo para mostrar los puentes de EM:

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

Operaciones de puente de EM mediante la API de REST

Puede realizar las siguientes operaciones de puente de EM mediante la API:

Tipos y propiedades de destino de EM recopilados

El puente de EM soporta los siguientes tipos de destino y sus propiedades:

tipo de objetivo de EM Tipo de entidad de Log Analytics Propiedades del Destino de EM Propiedades de entidad de Log Analytics
Servicio de alta disponibilidad de Oracle Nodo de Oracle Cluster

NodeName

-

OracleHome

node_name

omc_crs_base

oracle_home
Host

Host (AIX)

Host (HP-UX)

Host (Linux)

Host (Solaris)

Host (Windows)

 Ninguna Ninguna
OC4J OC4J

-

omc_server_log_path
Oracle HTTP Server Oracle HTTP Server

{DOMAIN_HOME}{OracleInstance}

ComponentName

ohs_home

component_name
Instancia de base de datos Instancia de 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
Sistema de base de datos Sistema Oracle Database

Ninguna

Ninguna
Oracle Internet Directory Oracle Internet Directory

IASInternalName

OracleInstance

ias_internal_name

oracle_instance
Listener Listener de 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 datos conectable Base de datos conectable de Oracle

Name

MachineName

Port

SID

ServiceName

-

pdb_name

host_name

port

sid

service_name

domain_name
Oracle VM Manager Oracle VM Manager

Ninguna

Ninguna

Pool de Oracle VM Server Pool de Oracle VM Server

Ninguna

Ninguna
ASM de cluster Gestión automática de almacenamiento

Ninguna

Ninguna
Gestión automática de almacenamiento Instancia de gestión automática de almacenamiento

AdrHome

adr_home
Base de datos de cluster Oracle Database

Ninguna

Ninguna
Componente de Siebel Componente de Siebel

-

SARMLogDirectory

siebel_component_log_file_name

siebel_component_sarm_log_directory
Siebel Enterprise Oracle Siebel Enterprise

Ninguna

Ninguna
Servidor de Siebel Servidor de Siebel

filesystem:installdir

filesystem:logdir

-

siebel_server_install_dir

siebel_server_log_dir

siebel_component_sarm_log_directory
Cluster de Oracle WebLogic Cluster de WebLogic

DOMAIN_HOME

omc_weblogic_cluster_home
Dominio de Oracle WebLogic Dominio de WebLogic

DOMAIN_HOME

WebLogicHome

domain_home

weblogic_home
Oracle WebLogic Server WebLogic Server

DOMAIN_HOME

ServerNames

domain_home

server_names
Gestor de nodos de Oracle WebLogic Gestor de nodos de WebLogic

-

omc_nodemanager_home