Antes de empezar

En este tutorial de 20 minutos se muestra cómo configurar el entorno en Logging Analytics para recopilar datos de las tablas o vistas de Oracle Autonomous Database. Logging Analytics recopila los datos de las tablas o vistas conectándose a la base de datos y ejecutando la consulta SQL que proporcione.

Antecedentes

Realice los pasos descritos en este tutorial para recopilar datos de las tablas o vistas de la entidad de base de datos autónoma, como la creación del origen de log, la creación de la entidad de base de datos autónoma, la descarga de los archivos de cartera, el registro de las credenciales, el registro de la información de cartera y, por último, la asociación del origen de log a la entidad de base de datos autónoma para empezar a recopilar los logs.

¿Qué se necesita?

  • Configure políticas de servicio para Oracle Cloud Logging Analytics. Consulte Activación del acceso a Logging Analytics y sus recursos y Políticas de IAM de requisitos previos en la documentación de Oracle Cloud Infrastructure.
  • Cree las políticas de IAM para configurar la recopilación continua de logs. Consulte Permitir recopilación continua de logs mediante instancias de Management Agent en la documentación de Oracle Cloud Infrastructure.
  • Utilice un grupo de logs existente o cree al menos un grupo de logs para almacenar los logs que recopile de la base de datos autónoma. Consulte Creación de grupos de logs para almacenar los logs en la documentación de Oracle Cloud Infrastructure.
  • Familiarícese con las directrices de consulta SQL para escribir las consultas SQL para extraer datos de log. Consulte Directrices de consulta SQL en la documentación de Oracle Cloud Infrastructure.
  • Asegúrese de que tiene acceso a los compartimentos en los que residen las bases de datos autónomas en Oracle Cloud Infrastructure.
  • Opcionalmente, puede configurar el panel de control de gestión para crear y utilizar paneles de control, que son herramientas de visualización de datos que proporcionan estadísticas rápidas del estado y del rendimiento de su infraestructura y aplicaciones de TI, así como ayudar a identificar valores atípicos y a realizar acciones correctivas. Consulte Configuración del panel de control de gestión en la documentación de Oracle Cloud Infrastructure.
  • Para que el agente de gestión recopile los logs de la entidad de base de datos autónoma, debe proporcionar las credenciales para acceder a la base de datos autónoma. Para obtener más información sobre las credenciales que se deben registrar con el agente de gestión, consulte Credenciales de origen de agente de gestión: DBTCPSCreds en la documentación de Oracle Cloud Infrastructure.
  • Deberá proporcionar el nombre del servicio al crear la entidad de base de datos autónoma. Para obtener información sobre los nombres de servicio predefinidos para bases de datos autónomas, consulte Nombres de servicio de base de datos predefinidos para Autonomous Database en la documentación de Oracle Database.
  • Instale agentes de gestión en cualquier host que pueda tener conectividad JDBC a ATP-S o ADW-W. Para conocer los pasos para establecer la conectividad JDBC con ATP y ADW, consulte Conectividad de Java con Autonomous Database (ATP o ADW) mediante 19c y JDBC 18.3.

    Despliegue el plugin Logging Analytics al instalar el agente. Asegúrese de cumplir también los requisitos para desplegar los agentes de gestión. Consulte Management Agent: introducción en la documentación de Oracle Cloud Infrastructure.

    Como parte del proceso de instalación, deberá crear un archivo de respuesta en el que debe incluir la siguiente línea sobre la activación del plugin Logging Analytics:

    Service.plugin.logan.download=true

    Si desea activar el plugin de Management Agent en Oracle Cloud Agent, asegúrese de que el tamaño de pila de JVM es de al menos 512 MB.

Descarga de los archivos de cartera

Management Agent necesita carteras de Java Key Store (JKS) u Oracle para conectarse a ATP o ADW. La conectividad del agente de gestión a una instancia de Oracle Autonomous Database requiere el uso de carteras de Oracle. Asegúrese de que el usuario del agente tiene acceso de lectura a los archivos de cartera.

En hosts basados en Unix, el usuario del agente que instala el agente de gestión es mgmt_agent para el agente de gestión autónomo instalado manualmente y oracle-cloud-agent cuando el agente de gestión es un plugin activado con Oracle Cloud Agent.

  1. Conéctese a Oracle Cloud con sus credenciales en la nube > Vaya a la página inicial de la base de datos autónoma.

  2. Haga clic en el separador Conexión de base de datos > Descargue el archivo zip de cartera wallet_<dbname>.zip.

  3. Descomprima el zip en un directorio de forma segura para que solo los usuarios autorizados tengan acceso a ellos. El contenido del archivo zip se describe a continuación:

    • tnsnames.ora y sqlnet.ora: archivos de configuración de red que almacenan descriptores de conexión y configuración de cliente de SQL*Net.
    • cwallet.ora y ewallet.p12: cartera SSO de apertura automática y archivo PKCS12. El archivo PKCS12 está protegido con la contraseña de la cartera proporcionada en la interfaz de usuario.
    • keystore.jks y truststore.jks: almacén de confianza y almacén de claves de JKS protegido por el pasaporte de cartera proporcionado al descargar la cartera.
    • ojdbc.properties: contiene la propiedad de conexión relacionada con la cartera necesaria para la conexión JDBC. Debe encontrarse en la misma ruta de acceso que tnsnames.ora.

Los nombres de servicio predefinidos están disponibles en el archivo tnsnames.ora que descargó. El valor de la propiedad tiene el formato dbName_predefinedServiceName.

Creación de la entidad de Autonomous Database

Cree la entidad de base de datos autónoma para hacer referencia a la instancia de base de datos y activar la recopilación de logs de ella.

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Logging Analytics, haga clic en Administración. Se abre la página Visión general de administración.

    Los recursos de administración se muestran en el panel de navegación de la izquierda en Recursos. Haga clic en Unidades.

    Se abre la página Entidades. Asegúrese de que el selector de compartimentos de la izquierda indica que está en el compartimento deseado para esta nueva entidad. Haga clic en Crear.

  2. En el menú Tipo de entidad, seleccione Autonomous Transaction Processing o Autonomous Data Warehouse.
    Crear entidad de base de datos autónoma
    Descripción de la ilustración Create_Entity.png

    Proporcione un nombre para la entidad y anótelo para referencia futura. Lo necesitará para registrar los detalles de la base de datos con el agente de gestión.

  3. Seleccione Compartimento de Management Agent en el que está instalado el agente.
  4. En el menú Management Agent, seleccione el agente de gestión instalado en el host que tiene conectividad JDBC a ATP-S o ADW-W.
  5. Opcionalmente, en la sección ID de recurso en la nube, proporcione el OCID de la instancia de base de datos autónoma.
  6. En Propiedades, especifique el valor de la propiedad service_name.

    Los nombres de servicio predefinidos están disponibles en el archivo tnsnames.ora que descargó en el paso anterior. El valor de la propiedad tiene el formato dbName_predefinedServiceName.

  7. Haga clic en Crear.

Registro de Credenciales de Base de Datos y Detalles de Cartera con Management Agent

Para que el agente de gestión recopile los logs de la entidad de base de datos autónoma, debe proporcionar las credenciales para acceder a la base de datos autónoma. Utilice los siguientes pasos para agregar las credenciales o actualizar las credenciales existentes. Registre también los detalles de cartera con el agente.

  1. Recopile la siguiente información sobre la base de datos:
    • Database_Entity_Name: nombre de entidad especificado anteriormente al crear la entidad ATP/ADW
    • Database_User_Name: nombre de usuario de base de datos
    • Database_Password: contraseña de base de datos
    • Rol de usuario de base de datos (opcional)
  2. Recopile la siguiente información sobre los archivos de cartera:
    • SSL_Truststore_Location: ubicación del almacén de confianza de SSL
    • SSL_Truststore_Password: contraseña del almacén de confianza SSL
    • SSL_Keystore_Location: ubicación del almacén de claves SSL
    • SSL_Keystore_Password: contraseña del almacén de claves SSL
  3. Cree un archivo JSON con la información de la base de datos: 
     { "source": "lacollector.la_database_sql", "name": "LCAgentDBCreds.<Database_Entity_Name>", "type": "DBTCPSCreds", "usage": "LOGANALYTICS", "disabled": "false", "properties":[ {"name":"DBUserName","value":"<Database_User_Name>"}, {"name":"DBPassword","value":"<Database_Password>"}, {"name":"ssl_trustStoreType","value":"JKS"}, {"name":"ssl_trustStoreLocation","value":"<SSL_Truststore_Location>"}, {"name":"ssl_trustStorePassword","value":"<SSL_Truststore_Password>"}, {"name":"ssl_keyStoreType","value":"JKS"}, {"name":"ssl_keyStoreLocation","value":"<SSL_Keystore_Location>"}, {"name":"ssl_keyStorePassword","value":"<SSL_Keystore_Password>"}, {"name":"ssl_server_cert_dn","value":"yes"}] }

    Actualice los campos ssl_trustStoreLocation y ssl_keyStoreLocation con rutas de archivo absolutas que incluyan nombres de archivo. Por ejemplo: 

    {"name": "ssl_trustStoreLocation", "value": "/usr/local/wallet/truststore.jks"}, {"name": "ssl_keyStoreLocation", "value": "/usr/local/wallet/keystore.jks"}

    Para las rutas de Windows, utilice la barra diagonal inversa \ y, para las rutas similares a UNIX, utilice la barra diagonal / dentro de JSON.

  4. Para registrar las credenciales de base de datos y los detalles de cartera con el agente de gestión, conéctese al host del agente de gestión y ejecute el siguiente comando especificando la ruta al archivo JSON que ha creado en el paso anterior:

    • En host similar a UNIX:

      cat <path_to_JSON_file> | sh /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s logan

      Por ejemplo:

      cat /net/example.com/scratch/imp/my_atp/Wallet_ATP/my_logan_creds.json | sh /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s logan

      Note:

      Para las agentes de gestión que se ejecutan en instancias informáticas mediante el plugin de Oracle Cloud Agent, la ubicación del script credential_mgmt.sh está en /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin.

    • En el host de Windows:

      type <path_to_JSON_file> | <path_to_credential_mgmt.bat> -o upsertCredentials -s logan

      Por ejemplo:

      type C:\Oracle\my_logan_creds.json | C:\Oracle\mgmt_agent\agent_inst\bin\credential_mgmt.bat -o upsertCredentials -s logan

Asignación de Privilegios al Usuario del Agente de Gestión para Leer Archivos de Cartera

Asegúrese de que el usuario del agente de gestión tiene los privilegios correctos para leer los archivos de cartera. Proporcione acceso READ y EXECUTE al directorio de cartera y acceso READ a los archivos de cartera. Para ver ejemplos de comandos que puede utilizar, consulte Grant READ Access of the Logs to the Agent User on Your Host en Logging Analytics Documentation.

Creación de un origen para el tipo de entidad de Autonomous Database

  1. Abra el menú de navegación y haga clic en Observación y gestión. En Logging Analytics, haga clic en Administración. Se abre la página Visión general de administración.

    Los recursos de administración se muestran en el panel de navegación de la izquierda en Recursos. Haga clic en Orígenes.

    Se abre la página Orígenes. Haga clic en Crear origen.

  2. En el campo Nombre, introduzca el nombre del origen.

    También puede agregar una descripción.

  3. En la lista Tipo de origen, seleccione Base de datos.
  4. En el menú Tipo de entidad, seleccione Autonomous Transaction Processing o Autonomous Data Warehouse.
    Crear origen de base de datos autónoma
    Descripción de la ilustración Create_Source.png
  5. Haga clic en el separador Consultas de base de datos y especifique las sentencias SQL basadas en las que Oracle Cloud Logging Analytics recopila logs de base de datos autónoma:
    • Introduzca la sentencia SQL en el campo Consulta SQL.

      Puede que desee ejecutar las consultas SQL fuera de Logging Analytics para verificar primero los resultados.

    • Haga clic en Configurar y asigne las columnas de la tabla SQL a los nombres de campo que se mostrarán en los registros log reales.
    • Especifique una columna de secuencia. El valor de este campo debe determinar la secuencia de los registros insertados en la tabla. Debe tener un valor incremental único.

    Note:

    • El primer campo asignado con un tipo de datos Timestamp se utiliza como registro de hora del registro de log. Si no existe este campo, la hora de recopilación se utiliza como la hora del registro de log.
    • Cuando los logs se recopilan por primera vez después de crear el origen de log (recopilación de log histórica):

      Si algún campo de la consulta SQL se asigna al campo Time, el valor de ese campo se utiliza como referencia para cargar los registros de log de los 30 días anteriores.

      Si ninguno de los campos de la consulta SQL se asigna al campo Time, se cargan un máximo de 10.000.000 de registros.

    Haga clic en Listo.

    Para agregar varias consultas SQL, haga clic en Agregar y repita este paso.

  6. Seleccione Activado para cada una de las consultas SQL y, a continuación, haga clic en Guardar.

Se abre la página de lista de orígenes y muestra todos los orígenes definidos por Oracle y personalizados, incluido el que acaba de crear.

Asociación del origen de log con la entidad de Autonomous Database

  1. En la página de lista de orígenes, identifique el origen que creó en el paso anterior. Haga clic en el nombre del origen. Se abre la página de detalles del origen.
  2. A la izquierda de la página Detalles de origen, en Ámbito de recurso, seleccione el compartimento. Esto limitará las entidades visibles según el compartimento seleccionado.
  3. En Recursos, haga clic en Entidades no asociadas para ver las entidades que se pueden asociar a este origen. Seleccione la entidad que ha creado anteriormente para asociarla a este origen y haga clic en Agregar asociación.
    Entidad y origen de base de datos autónoma de Assocaite
    Descripción de la ilustración Associate_Source_Entity.png

    Se abre el cuadro de diálogo Agregar asociación.

  4. Seleccione el compartimento que contenga el grupo de logs en el que se deben ubicar los datos de log una vez recopilados e indexados.
  5. Seleccione el grupo de logs que haya creado anteriormente durante la configuración.
  6. Haga clic en Ejecutar.

La entidad seleccionada ahora se mueve a la sección Entidades asociadas en la que se muestra el estado de la asociación. Si falla la tarea de asociación entre entidad y origen, haga clic en Volver a intentar asociación.

Las instrucciones de recopilación se enviarán al agente que supervisa esta entidad como se ha definido anteriormente y se iniciará la recopilación de logs. Vaya a la sección Avisos de recopilación de agente para ver las advertencias para la recopilación de logs. Tenga en cuenta que la lista de advertencias se corresponde con todas las entidades de asociación para este origen.

Si tiene alguna incidencia con el agente de gestión que recopila los datos, asegúrese de que el nombre de usuario que ha proporcionado en el almacén de credenciales tiene acceso READ a las tablas o vistas que se están consultando. Espere unos minutos para ver los logs en el explorador de logs. Después de que el agente haya recopilado los logs históricos, comenzará a ver solo los logs más recientes que se están recopilando.

Más información

En las siguientes secciones de la documentación de Oracle Cloud Infrastructure: