Ingesta de logs desde otros servicios de OCI mediante el conector de servicio

En función del tipo de logs de servicio de cuya ingesta desee realizar, debe crear políticas para permitir que Oracle Log Analytics obtenga la información sobre los recursos y cree una entidad para cada recurso.

Después de crear la política, la entidad que se crea se asociará automáticamente a todos los logs recopilados de ese recurso. Si la política no se crea, se sigue realizando la ingesta de los logs, pero no se crea la entidad.

Los siguientes permisos son para cargar logs en Oracle Log Analytics desde el conector de servicio. Se le pedirá que agregue estas sentencias de política al crear el conector de servicio mediante la consola de OCI. También puede crear manualmente la política que incluye las siguientes sentencias de política:

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <userGroup> to MANAGE serviceconnectors in tenancy
allow group <userGroup> to READ logging-family in tenancy

En las declaraciones de política anteriores,

• Log_Group_Compartment_OCID: OCID de compartimento del grupo de log en Oracle Log Analytics donde se deben almacenar los logs.

• Log_Group_OCID: OCID del grupo de log en Oracle Log Analytics donde se deben almacenar los logs.

• Service_Connector_Compartment_OCID: OCID de compartimento del hub del conector de servicio.

Oracle Log Analytics crea una entidad que representa el recurso de OCI subyacente cuando se reciben nuevos logs a través del conector de servicio. Para obtener la información necesaria del recurso de OCI, debe proporcionar a Oracle Log Analytics un acceso mínimo de read al recurso de OCI. Por ejemplo, para leer información sobre un cubo de Object Storage, puede escribir una de las siguientes políticas:

Sentencia de política con el READ PRIVILEGE del recurso de OCI:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to {BUCKET_READ} in compartment <specify_compartment>

OR

Sentencia de política con el verbo de lectura para OCI RESOURCE:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to read buckets in compartment <specify_compartment>

Las sentencias de política anteriores restringen el acceso read a un compartimento. Para ampliar el acceso a todo el arrendamiento, puede cambiar la sentencia de política según corresponda.

Los siguientes recursos de OCI están soportados en Oracle Log Analytics para la recopilación de logs a través del conector de servicio. Puede crear la política mediante el verbo de lectura para el recurso de OCI o utilizar el privilegio de lectura para el recurso, como se ilustra anteriormente.

Antes de configurar el conector de servicio para realizar la ingesta de logs, asegúrese de que el compartimento y el grupo de logs estén identificados para los logs cuya ingesta desea realizar.

En el siguiente ejemplo, los pasos muestran cómo recopilar logs del servicio de VCN del servicio Logging de Oracle Cloud Infrastructure:

1. Este es un paso sugerente para mostrar cómo activar logs en el servicio Logging de Oracle Cloud Infrastructure.

   Vaya al servicio de Oracle Cloud Infrastructure Logging y vaya a Logs.

   Haga clic en Activar log de recursos para activar los logs del servicio de VCN. Se abre el cuadro de diálogo.

   1. Seleccione el compartimento de recursos.
   2. Seleccione el servicio, por ejemplo, Virtual Cloud Network (subnets).
   3. Seleccione el recurso, por ejemplo, el recurso VCN.
   4. En Configurar log, seleccione la categoría de log, por ejemplo, Flow Logs, y el nombre de log.
   5. En Ubicación de log, seleccione el compartimento y la agrupación de logs desde los que Oracle Log Analytics hará referencia a los logs.

   Haga clic en Activar log.

2. Configure el conector a servicio especificando el servicio de origen de los logs y el destino como Oracle Log Analytics. Puede configurarlo desde el servicio de origen que se ha integrado con el hub de conector de servicio de Oracle Cloud Infrastructure, por ejemplo, el servicio Oracle Cloud Infrastructure Logging, o directamente desde el hub de conector de servicio de Oracle Cloud Infrastructure.

   Vaya al servicio de Oracle Cloud Infrastructure Logging, vaya a Conectores de servicio y haga clic en Crear conector.

   También puedes ir al servicio de Oracle Cloud Infrastructure Service Connector Hub y hacer clic en Crear conector de servicios.

   Se abre la página Crear conector de servicio.

   1. Introduzca un nombre para el conector y proporcione una descripción.
   2. Seleccione el compartimento de recursos en el que se debe crear el recurso de conector.
   3. En Configurar conector de servicio, especifique Logging como servicio Origen y Logging Analytics como servicio Destino.
   4. En Configurar conexión de origen, proporcione los detalles de los logs que se van a recopilar del servicio, por ejemplo, los logs del servicio de VCN.

      Seleccione el nombre del compartimento, el grupo de logs al que pertenecen los logs y el nombre de los logs que ha configurado en el paso 1.

   Puede configurar el mismo conector de servicio para recopilar más logs. Haga clic en Otro log y repita el paso 2-d.

   De manera opcional, puede crear filtros en Configurar tarea.

   Haga clic en Crear conector.

Una vez creado el conector de servicio, puede verificar que los logs seleccionados estén disponibles en Oracle Log Analytics.

Deje que Source_Tenant sea el inquilino del servicio de origen, como Oracle Cloud Infrastructure Logging, del que se recopilan los logs. Deje que el Target_Tenant sea el inquilino en el que se crea la conexión de servicio. El conector de servicio se configura con Oracle Log Analytics como destino para los logs que se recopilan del servicio de origen. Se supone que el hub de conector de servicio y Oracle Log Analytics están disponibles en el mismo inquilino de destino.

Defina las siguientes políticas para configurar la recopilación de logs de un arrendamiento distinto del arrendamiento en el que se ha creado el conector del servicio.

define tenancy <Target_Tenant> as <Target_Tenant_OCID>
define group <Common_User_Group> as <Common_User_Group_OCID>
admit any-user of tenancy <Target_Tenant> to read logging-family IN TENANCY WHERE ALL {request.principal.type = 'serviceconnector'}
admit group <Common_User_Group> of tenancy <Target_Tenant> to read logging-family IN TENANCY

admit group <Common_User_Group> of tenancy <Target_Tenant> to read audit-events in TENANCY
admit any-user of tenancy <Target_Tenant> to read audit-events IN tenancy WHERE ALL {request.principal.type = 'serviceconnector'}

define tenancy <Source_Tenant> as <Source_Tenant_OCID>
endorse any-user to read logging-family IN tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}
endorse group <Common_User_Group> to read logging-family IN tenancy <Source_Tenant>

endorse group <Common_User_Group> to read audit-events in tenancy <Source_Tenant>
endorse any-user to read audit-events in tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <Common_User_Group> to MANAGE serviceconnectors in tenancy

oci --profile <Target_Profile> sch service-connector create 
    --display-name XTenancyConnector 
    --compartment-id <Connector_Compartment_OCID> 
    --source '{ "kind": "logging", "logSources": 
        [ { "compartmentId": "<Logging_LogGroup_Compartment_OCID>", 
            "logGroupId": "<Logging_LogGroup_OCID>" } ] }' 
    --target '{ "kind": "loggingAnalytics", "logGroupId": "<LogAnalytics_LogGroup_OCID>" }'

Si ha configurado un conector de servicio para recopilar continuamente logs de OCI Logging a Oracle Log Analytics, puede parar la recopilación de logs desactivando el conector o suprimiéndolo.

Si su requisito es detener temporalmente la recopilación de logs pero conservar la configuración del conector para que pueda reiniciar la recopilación de logs en un momento posterior, desactive el conector.

Si desea parar permanentemente la recopilación de logs del conector de servicio, Suprimir el conector.

1. Identificar el conector de servicio configurado para la recopilación de logs: navegue hasta el servicio Connector Hub y muestre los conectores del compartimento. Consulte Listado de conectores.

   Haga clic en el nombre del conector para ver los detalles y la configuración del conector. Identifique el conector de servicio adecuado configurado para la recopilación de logs.

2. Detener recopilación de logs: según sus requisitos, haga clic en Desactivar o Suprimir. Consulte Desactivación de un Conector y Supresión de un Conector.

   Esto para el flujo de datos del servicio de OCI específico a Oracle Log Analytics.

Si ha desactivado el conector y desea reiniciar la recopilación de logs, vuelva a activar ese conector. Consulte Activación de un conector.