Gestión de entidades
Una entidad es un recurso de Log Analytics que se utiliza para hacer referencia al activo real en un host local o en un host virtual. Después de detectar esta entidad en Log Analytics, puede asociarla a un origen de log y activar la recopilación de logs desde ella.
Recursos útiles:
-
Para obtener más información sobre una entidad, consulte Términos y conceptos de Log Analytics.
-
Para crear una entidad, consulte Creación de una entidad para representar el recurso que emite logs. Además, Log Analytics permite editarla más adelante, moverla de un compartimento a otro y realizar otras tareas de gestión como se muestra a continuación.
-
Para iniciar la detección de entidades como aplicaciones empaquetadas, bases de datos, middleware y otros componentes, consulte Detección Automática de Entidades y Recopilación de Log.
-
Una entidad debe tener un tipo de entidad. Ya están disponibles casi 100 tipos de entidad definidos por Oracle. Consulte Tipos de entidad modelados en Log Analytics. También puede crear tipos de entidades personalizadas. Cuando se crea una entidad, un tipo de entidad define las propiedades que se utilizan para localizar la ubicación de los archivos log. Por ejemplo, en un Tipo de entidad Oracle Database, debe proporcionar valores de ruta para propiedades como
ADR_HOME,ORACLE_HOMEyINSTALL_HOME. Puede crear nuevos tipos de entidad mediante la API de REST o la CLI. Consulte API de Log Analytics y Referencia de la línea de comandos. -
Cuando utiliza agentes de gestión para recopilar logs continuamente, debe configurar una asociación origen-entidad para permitir que un origen para entidades específicas recopile los datos del log. Consulte Gestión de las asociaciones origen-entidad.
-
Para parar la recopilación de logs de una entidad, disocie la entidad del origen. Consulte Detener la recopilación de registros de una entidad.
Para realizar otras acciones en la entidad, en la página Entidades, seleccione el compartimento de su entidad y acote el tipo de entidad seleccionando el tipo de entidad en la barra de búsqueda. Después de identificar la entidad, haga clic en el icono
Acciones en la fila de la entidad:
-
Ver detalles: se muestra la página de la entidad. En el separador Información de entidad, puede ver el tipo de entidad, su OCID, el tipo de creación, el compartimento en el que reside, los detalles del agente de gestión, el momento en el que se ha creado y actualizado por última vez y los orígenes asociados. Haga clic en el icono Editar
junto a Agente de gestión para actualizar la información del agente. En el separador Etiquetas, puede ver las etiquetas asociadas a la entidad. Haga clic en el botón Agregar etiqueta para agregar una.
Además, haga clic en los botones Editar, Mover recurso, Agregar etiquetas o Suprimir de la página de la entidad para realizar las acciones correspondientes.
-
Editar: se muestra el cuadro de diálogo Editar entidad. Aquí, para agregar más propiedades, puede hacer clic en el botón Agregar en la sección Propiedades y especificar Nombre de propiedad y Valor de propiedad. Haga clic en Guardar cambios.
Estas propiedades se utilizan para localizar la ubicación de los archivos log. Por ejemplo, en un tipo de entidad Oracle Database, debe proporcionar valores de ruta para propiedades como
ADR_HOME,ORACLE_HOMEyINSTALL_HOME. -
Agregar datos: se muestra el cuadro de diálogo Configurar recopilación de logs basada en agente o Configurar recopilación de logs para recursos de OCI en función de si la entidad es un recurso de OCI o no de OCI. Los asistentes le ayudan a asociar la entidad a un origen adecuado. De esta forma, se configura el analizador y el filtro para procesar los registros log que fluyen desde la entidad.
-
Cargar archivos: se abre el asistente Cargar archivos. Siga los pasos del asistente para cargar los archivos log asociados a la entidad. Esto resulta especialmente útil para cargar un lote de archivos que no forman parte de la recopilación continua de logs o que pertenecen a un intervalo de tiempo fuera de lo definido para la recopilación.
-
Copiar OCID: se copia el OCID del recurso de entidad. Puede utilizarlo para hacer referencia a este recurso en cualquier lugar de Oracle Cloud Infrastructure.
-
Mover recurso: se muestra el cuadro de diálogo Mover recurso a un compartimento diferente. En las opciones, seleccione el compartimento al que desea mover la entidad y haga clic en Mover recurso.
-
Agregar etiqueta: consulte Adición del etiquetado a los recursos de Log Analytics.
-
Suprimir: puede que tenga que suprimir algunas de las entidades antiguas o no utilizadas para ajustarse a los límites de servicio de Log Analytics. Consulte Límites por servicio en la documentación de Oracle Cloud Infrastructure. Para suprimir la entidad, confirme en el cuadro de diálogo Suprimir entidad.
Nota
Las entidades que ha suprimido mediante la API de supresión de entidades pueden volver a aparecer en la lista de entidades en cualquiera de las siguientes circunstancias:
-
Se transfieren nuevos logs para las entidades suprimidas mediante las recopilaciones de Service Connector Hub u Object Storage.
-
Las nuevas cargas del puente de EM contienen la entidad suprimida.
-
Gestionar preferencias de entidad
Puede gestionar las preferencias predeterminadas para las entidades mediante el grupo de preferencias entityLifecycle. Cree políticas de IAM para permitir a los usuarios leer, actualizar y suprimir preferencias de entidad.
Para obtener más información sobre los grupos de preferencias y las políticas de IAM para las preferencias, consulte Preferencias de operación del servicio Log Analytics.
Para que la API de REST gestione las preferencias en Oracle Log Analytics, consulte Referencia de API de Log Analytics.
Temas:
- Preferencias de entidad en el grupo de preferencias entityLifecycle
- Tipos de entidad para la preferencia AUTO_DELETE_SCH_ENTITIES_OF_TYPES
Preferencias de entidad en el grupo de preferencias entityLifecycle
| Función | Nombre de preferencia | Valores Permitidos | Detalles |
|---|---|---|---|
| Ciclo de vida de las entidades de agente y host en Oracle Log Analytics | AUTO_CREATE_AGENT_HOST_ENTITY |
VERDADERO/FALSO |
VERDADERO (valor por defecto): las entidades del agente y el host se crean automáticamente. FALSO: no se crean las entidades para el agente y el host. |
AUTO_DELETE_AGENT_ENTITY |
VERDADERO/FALSO |
FALSO (valor por defecto): las entidades de agente no se suprimen cuando se suprimen las instancias de Management Agent. VERDADERO: las entidades de agente se suprimen cuando se suprimen las instancias de Management Agent. |
|
AUTO_DELETE_HOST_ENTITY |
VERDADERO/FALSO |
FALSO (valor por defecto): las entidades de host no se suprimen cuando se suprimen los agentes de gestión. VERDADERO: las entidades de host se suprimen cuando se suprimen las instancias de Management Agent. |
|
| Supresión de entidades creadas automáticamente para logs recibidos a través de Service Connector Hub en Oracle Log Analytics | AUTO_DELETE_SCH_ENTITIES_OF_TYPES |
Lista separada por comas de tipos de entidad admitidos / _ALL_ / <empty> (sin juego de valores) |
<empty> (no se ha definido ningún valor) (valor por defecto): las entidades no se suprimen. _ALL_: las entidades se suprimen para todos los tipos soportados cuando se suprimen los recursos de OCI subyacentes. Lista separada por comas: las entidades se suprimen para los tipos de entidad especificados cuando se suprimen los recursos de OCI subyacentes. |
| Nomenclatura personalizada para entidades de host creadas automáticamente en Oracle Log Analytics | USE_CUSTOM_HOSTNAME_FROM_TAG |
<tagKeyName> de las etiquetas de formato libre del agente |
Por defecto, Oracle Log Analytics utiliza el nombre de host proporcionado por el recurso del agente de gestión al crear la entidad de host. Para sustituir este nombre de host, se puede definir una etiqueta de formato libre en el recurso Management Agent. El valor de la etiqueta se utiliza para sustituir el nombre utilizado para la entidad Host. Si la preferencia está establecida y la etiqueta de formato libre no está establecida en el recurso Management Agent, la entidad Host no se crea. El valor de la etiqueta tiene el prefijo (por defecto) o el sufijo del nombre de host proporcionado por el agente. Example: If the hostname reported by Management Agent service is |
USE_CUSTOM_HOSTNAME_POSITION |
Prefijo/sufijo | Consulte los detalles de USE_CUSTOM_HOSTNAME_FROM_TAG.
|
Tipos de entidad para la preferencia AUTO_DELETE_SCH_ENTITIES_OF_TYPES
| Tipo de entidad de Log Analytics | Recurso de OCI |
|---|---|
| oci_analytics_cloud_instance | Analytics Cloud |
| oci_api_gateway | Gateway de API |
| oci_apm_domain | Dominio de APM |
| oci_compute_instance | Recursos informáticos |
| oci_data_flow_application | Flujo de datos |
| oci_devops_build_pipeline | Pipelines de compilación de Devops |
| oci_devops_build_pipeline_stage | Etapa de pipeline de compilación de Devops |
| oci_devops_build_run | Ejecución de pipeline de compilación de Devops |
| oci_devops_deployment | Despliegue de Devops |
| oci_devops_deployment_pipeline | Pipeline de despliegue de Devops |
| oci_devops_deployment_stage | Etapa de despliegue de Devops |
| oci_emailsender | Email Delivery |
| oci_event_rule | Reglas de evento |
| oci_functions_app | Aplicaciones de Functions |
| oci_functions_function | Funciones de Functions |
| oci_load_balancer | Equilibrador de carga |
| oci_media_workflow | Flujo de trabajo de servicios de medios |
| oci_media_workflow_job | Trabajo de flujo de trabajo de servicios de medios |
| oci_network_firewall | Firewall de red |
| oci_opctloperatorcontrol | Base de datos - Control de acceso de operador de Oracle |
| oci_os_bucket | Cubo de almacenamiento de objetos |
| oci_service_connector | Conector de servicio |
| oci_vcn | Red virtual en la nube |
| oci_vcn_subnet | Subred de la VCN |
| oci_vcn_vnic | VNIC de VCN |
| oci_vpn_ipsecconnection | Conexión VPN IPSec |
| oci_vpn_ipsectunnel | Túnel de VPN IPSec |
| oci_webappfirewall | Firewall de aplicación web |
| omc_kubernetes_cluster | OKE |
| omc_opc_ics_instance | Instancia de Integration Cloud Service |
| omc_opc_ics_integration | Integración de Integration Cloud Service |