Documentación de Oracle Cloud Infrastructure

Vistas de la interfaz de Oracle Cloud Infrastructure Logging

Las vistas de la interfaz de registro de Oracle Cloud Infrastructure (OCI) permiten a los usuarios autorizados acceder a los datos de log a través de un juego de vistas.

El registro de Oracle Cloud Infrastructure (OCI) es la solución de registro central para los servicios de OCI, incluidos los logs de flujo de VCN, los logs del equilibrador de carga, los logs de almacenamiento de objetos y otros dentro de la capacidad agregada para incluir logs personalizados. Los logs no se almacenan en Autonomous Database. En su lugar, los logs se recuperan dinámicamente en función de varios predicados proporcionados por el usuario, incluidos el rango de fechas, el grupo de logs, el nombre de log y otros.

  • Visión general de la interfaz de Oracle Cloud Infrastructure Logging
    Proporcionar acceso a los datos de log dentro de una instancia de Autonomous Database en formato relacional proporciona un método de acceso útil, junto con la capacidad de obtener los datos de registro en formato relacional o JSON y enriquecer los análisis uniéndose a otros datos que puedan tener en Autonomous Database.
  • Vista OCI_LOG_LIST
    Muestra una lista de todos los logs del inquilino. La vista no muestra los datos de log, pero proporciona los metadatos sobre los logs de un arrendamiento. Estos metadatos se utilizan para especificar correctamente valores de parámetros para otras vistas de registro. Si no hay ningún log en un grupo de logs, ese grupo no se incluirá en esta vista.
  • Vista OCI_LOG_DATA
    Vista común que proporciona acceso a todos los tipos de log soportados por el servicio OCI Logging. El contenido del log está en la columna DATA.
  • Vista OCI_VCN_FLOWLOGS
    Vista que proporciona detalles sobre el tráfico que pasa a través de la VCN del usuario. Este log permite a los usuarios auditar el tráfico y solucionar problemas de listas de seguridad. Cada registro de log de flujo refleja el tráfico registrado en una dirección de una conexión entre dos puntos finales. Por ejemplo, una única conexión TCP, puede tener dos registros en la ventana de captura: uno para el tráfico de entrada y otro para el tráfico de salida.
  • OCI_LBLOG_ACCESS Vista
    Vista que proporciona logs de acceso del equilibrador de carga que capturan información detallada sobre las solicitudes enviadas a un equilibrador de carga. Cada entrada contiene la hora a la que se recibió la solicitud, el cliente, las direcciones IP de proxy HTTP intermedias y las horas que utiliza el equilibrador de carga y el backend para procesar la solicitud.
  • Vista OCI_LBLOG_ERRORS
    Vista que proporciona logs de errores del equilibrador de carga que capturan información detallada sobre las solicitudes relacionadas con la solución de problemas y la supervisión. Cada entrada contiene información como la hora de recepción de la solicitud, el tipo de error y detalles adicionales del error específico.

Tema principal: vistas de Autonomous Database

Visión general de la interfaz de Oracle Cloud Infrastructure Logging

Proporcionar acceso a los datos de log dentro de una instancia de Autonomous Database en formato relacional proporciona un método de acceso útil, junto con la capacidad de obtener los datos de registro en formato relacional o JSON y enriquecer los análisis uniéndose a otros datos que puedan tener en Autonomous Database.

El servicio de registro de Oracle proporciona acceso a los logs desde los recursos de Oracle Cloud Infrastructure (OCI). Estos logs incluyen información de diagnóstico crítica que describe el rendimiento de los recursos y cómo se está accediendo a ellos. Hay distintos tipos de log para cada servicio de Oracle. Para obtener más información sobre el servicio de registro y los servicios de OCI soportados, consulte Visión general de Oracle Cloud Infrastructure Logging.

A través de la interfaz de registro de Oracle Cloud Infrastructure, se puede acceder a los datos de log a través de una instancia de Autonomous Database en formato relacional. Los usuarios pueden consultar diferentes datos de log en OCI en todos los compartimentos y regiones. Las vistas de OCI implantadas utilizan la credencial OCI$RESOURCE_PRINCIPAL.

Para utilizar estas vistas, es necesario realizar los siguientes pasos.
  1. Un administrador permite el uso de la credencial OCI$RESOURCE_PRINCIPAL en la base de datos.
  2. Los usuarios crean un nuevo grupo dinámico para la credencial OCI$RESOURCE_PRINCIPAL.

Para obtener más información sobre la activación de la credencial, la configuración de un grupo dinámico y la creación de sentencias de política, consulte Uso de la entidad de recurso para acceder a los recursos de Oracle Cloud Infrastructure.

Como administrador, active la entidad de recurso.
EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();
El grupo dinámico debe tener las siguientes reglas que incluyan el ID de recurso de la instancia. 
resource.id = '<resource.id>'
Hay dos sentencias de política necesarias para acceder a las vistas de registro.
-- For OCI Logging Views
Allow dynamic-group <group-name> to use logging-family in tenancy
Allow dynamic-group <group-name> to use compartments in tenancy

Todas las vistas tienen valores de predicado obligatorios y opcionales (nombres de columna).

Los valores de predicado son los siguientes:
Nota

La vista OCI_LOG_LIST no tiene columnas obligatorias. Si no se proporciona el valor REGION, la vista devuelve datos para la región principal.
  • REGION (Obligatorio)
  • COMPARTMENT_ID (Obligatorio)
  • LOG_GROUP_ID (Obligatorio)
  • LOG_ID (Opcional): si se proporciona el valor, los resultados de la consulta utilizarán el valor LOG_ID. Si no se proporciona ningún valor, el servidor devolverá el valor.
  • START_TIME (Opcional): si no se proporciona ningún valor, los valores devueltos son para los últimos 5 minutos en GMT.
  • END_TIME (Opcional): si no se proporciona ningún valor, los valores devueltos son para los últimos 5 minutos en GMT.
  • SEARCH_CRITERIA (Opcional): si no se proporciona ningún valor, se devolverá un valor nulo.

Puesto que puede haber diferentes tipos de log en un único grupo de logs, se recomienda especificar LOG_ID en un predicado al utilizar las vistas OCI_VCN_FLOWLOGS, OCI_LBLOG_ACCESS y OCI_LBLOG_ERRORS.

Notas y restricciones:
  • La vista común OCI_LOG_DATA soporta todos los tipos de log, por lo que COMPARTMENT_ID, LOG_GROUP_ID y REGION son suficientes. Del mismo modo, si un usuario utiliza el valor LOG_ID de un equilibrador de carga con la vista OCI_VCN_FLOWLOGS, no devolverá datos correctos ni ningún dato.
  • Para la vista OCI_LOG_LIST, select * from OCI_LOG_LIST solo mostrará datos para la región principal. Si necesita datos para otra región, tendrá que utilizar un predicado de igualdad REGION en la cláusula WHERE.
  • Si OCI_LOG_DATA, OCI_VCN_FLOWLOGS, OCI_LBLOG_ACCESS y OCI_LBLOG_ERRORS, select * from <view> proporciona ORA-20000: compartment_id,log_group_id and region are mandatory predicates, please provide valid values for them as equality predicate in the WHERE clause. para proporcionar los valores de predicado necesarios.
  • El marco soporta la consulta de datos de log de hasta 7 días (desde la hora actual) para consultarlos desde las vistas soportadas. Cualquier valor para los predicados START_TIME y END_TIME fuera de este rango dará como resultado ORA-20000: start_time and end_time should be from current_timestamp to current_timestamp-7.
  • Si no proporciona los predicados obligatorios mostrados, verá un ORA-20000: compartment_id,log_group_id and region are mandatory predicates, please provide valid values for them as equality predicate in the WHERE clause. Otras columnas se pueden utilizar como predicados de cualquier tipo (=, IN). Los predicados obligatorios solo se pueden utilizar una vez en una consulta y no se pueden utilizar varias veces con AND o NOT.
  • Los valores de START_TIME y END_TIME se deben proporcionar en formato DD-MM-YY HH24:MI:SS. Si no se proporciona en este formato, la consulta no devolverá ningún dato.

Vista OCI_LOG_LIST

Muestra una lista de todos los logs del inquilino. La vista no muestra los datos de log, pero proporciona los metadatos sobre los logs de un arrendamiento. Estos metadatos se utilizan para especificar correctamente valores de parámetros para otras vistas de registro. Si no hay ningún log en un grupo de logs, ese grupo no se incluirá en esta vista.

Columna Tipo de Dato Descripción

REGION

VARCHAR2

Nombre de región de OCI

COMPARTMENT_ID

VARCHAR2

Compartment OCID

LOG_GROUP_ID

VARCHAR2

OCID LOG_GROUP

LOG_GROUP_NAME

VARCHAR2

Nombre del grupo de logs.

LOG_ID

VARCHAR2

OCID de LOG

LOG_NAME

VARCHAR2

Nombre de log

LOG_SERVICE

VARCHAR2

Servicio de log

Vista OCI_LOG_DATA

Vista común que proporciona acceso a todos los tipos de log soportados por el servicio OCI Logging. El contenido del log está en la columna DATA.

Columna Tipo de Dato Descripción

DATE_TIME

TIMESTAMP

Igual que el campo oracle.ingestedtime

ID

VARCHAR2

Un UUID aleatorio para cada entrada de log

SOURCE

VARCHAR2

Nombre del recurso que ha generado el mensaje de log

SPEC_VERSION

NUMBER

Versión de la especificación CloudEvents que utiliza este mensaje de log

LOG_TIME

TIMESTAMP

Hora de generación de mensaje de log

TYPE

VARCHAR2

Tipo de Mensaje de Log

COMPARTMENT_ID

VARCHAR2

OCID de compartimento

INGESTED_TIME

TIMESTAMP

Hora de ingesta de mensajes de log

LOG_GROUP_ID

VARCHAR2

OCID de grupo de logs

LOG_ID

VARCHAR2

OCID de log

TENANT_ID

VARCHAR2

OCID de inquilino del propietario del objeto de log

DATA

CLOB

Mensaje de log

ORACLE_DETAILS

CLOB

Metadatos específicos de Oracle

Vista OCI_VCN_FLOWLOGS

Vista que proporciona detalles sobre el tráfico que pasa a través de la VCN del usuario. Este log permite a los usuarios auditar el tráfico y solucionar problemas de listas de seguridad. Cada registro de log de flujo refleja el tráfico registrado en una dirección de una conexión entre dos puntos finales. Por ejemplo, una única conexión TCP, puede tener dos registros en la ventana de captura: uno para el tráfico de entrada y otro para el tráfico de salida.

Columna Tipo de Dato Descripción

REGION

VARCHAR2

Nombre de región de OCI

DATE_TIME

TIMESTAMP

Igual que el campo oracle.ingestedtime

ID

VARCHAR2

Un UUID aleatorio único para cada entrada de log

ACTION

VARCHAR2

Valores posibles de ACCEPT o REJECT

FLOW_ID

VARCHAR2

Hash de campos clave (direcciones de origen y destino, puertos y protocolo)

STATUS

VARCHAR2

Valores posibles de OK, NODATA o SKIPDATA

END_TIME

TIMESTAMP

Hora de finalización de ventana de captura

PACKETS

NUMBER

Número de paquetes registrados en la ventana de captura

VERSION

VARCHAR2

Número de esquema de registro de flujo

BYTES_OUT

NUMBER

Número de bytes registrados en la ventana de captura

PROTOCOL

NUMBER

IANA protocol number

START_TIME

TIMESTAMP

Hora de inicio de la ventana de captura

SOURCE_PORT

NUMBER

Número de puerto IANA de origen

PROTOCOL_NAME

VARCHAR2

Nombre de protocolo IANA

SOURCE_ADDRESS

VARCHAR2

Dirección IP del origen en notación IPv4 o IPv6

DESTINATION_PORT

NUMBER

Número de puerto IANA de destino

DESTINATION_ADDRESS

VARCHAR2

Dirección IP del destino en notación IPv4 o IPv6

TIME

TIMESTAMP

Igual que START_TIME

TYPE

VARCHAR2

Categoría de log

LOG_ID

VARCHAR2

OCID de log

TENANT_ID

VARCHAR2

OCID de arrendatario

VNIC_OCID

VARCHAR2

VNIC OCID

LOG_GROUP_ID

VARCHAR2

OCID de grupo de logs

INGESTED_TIME

TIMESTAMP

Registro de tiempo ingerido por el registro de OCI

COMPARTMENT_ID

VARCHAR2

OCID de compartimento de grupo de logs

VNIC_SUBNET_OCID

VARCHAR2

OCID de subred de VNIC

VNIC_COMPARTMENT_ID

VARCHAR2

OCID de compartimento de VNIC

SOURCE

VARCHAR2

Nombre del recurso que ha generado el mensaje de log

SPEC_VERSION

NUMBER

Versión de la especificación CloudEvents que utiliza este mensaje de log

Vista OCI_LBLOG_ACCESS

Vista que proporciona logs de acceso del equilibrador de carga que captura información detallada sobre las solicitudes enviadas a un equilibrador de carga. Cada entrada contiene la hora a la que se recibió la solicitud, el cliente, las direcciones IP de proxy HTTP intermedias y las horas que utiliza el equilibrador de carga y el backend para procesar la solicitud.

Columna Tipo de Dato Descripción

REGION

VARCHAR2

Nombre de región de OCI

DATE_TIME

TIMESTAMP

Igual que el campo oracle.ingestedtime

ID

VARCHAR2

Un UUID aleatorio único para cada entrada de log

BACKEND_ADDRESS

VARCHAR2

Dirección IP y número de puerto del servidor backend que ha procesado la solicitud del cliente

BACKEND_CONNECT_TIME

NUMBER

Tiempo empleado (en segundos, con precisión de milisegundos) para establecer la conexión del servidor de backend

BACKEND_PROCESSING_TIME

NUMBER

Tiempo total (en segundos, con precisión de milisegundos) transcurrido desde que el equilibrador de carga establece una conexión con un backend hasta que finaliza

BACKEND_STATUS_CODE

NUMBER

Código de estado de la respuesta del destino

CLIENT_ADDRESS

VARCHAR2

Dirección IP y número de puerto del cliente solicitante

FORWARDED_FOR_ADDRESS

VARCHAR2

Dirección IP del cliente y proxies http entre el cliente y el equilibrador de carga

HOST

VARCHAR2

Nombre de dominio que se resuelve en una dirección IP asignada al equilibrador de carga

LB_STATUS_CODE

NUMBER

Código de estado de equilibrador de carga

LISTENER_NAME

VARCHAR2

Listener que ha recibido la solicitud de tráfico entrante en la dirección IP del equilibrador de carga

RECEIVED_BYTES

NUMBER

Tamaño total de la solicitud (en bytes) recibida del cliente

REQUEST

VARCHAR2

Línea de solicitud recibida del cliente

REQUEST_PROCESSING_TIME

NUMBER

Tiempo total transcurrido (en segundos, con precisión de milisegundos) desde que el equilibrador de carga recibe la solicitud del cliente hasta que el equilibrador de carga termina de enviar respuesta al cliente.

ROUTING_RULES_ENGINE_ERRORS

NUMBER

Error del motor de reglas de enrutamiento durante la evaluación de la política de la solicitud con un 0 (sin error) o 1 (error). Si se ha producido un error, las solicitudes se reenvían al backend por defecto asociado al listener.

ROUTING_RULES_MATCHED_RULE

VARCHAR2

Nombre de regla de política de enrutamiento con la coincidencia para esta solicitud específica

ROUTING_RULES_RULE_HITS

NUMBER

Número de reglas de enrutamiento evaluadas como true para la solicitud

ROUTING_RULES_RULE_MISSES

NUMBER

Número de reglas de enrutamiento evaluadas como false para la solicitud

SENT_BYTES

NUMBER

Tamaño total de la solicitud (en bytes) enviada al cliente

SSL_CIPHER

VARCHAR2

Cifrado SSL negociado entre el cliente y el equilibrador de carga

SSL_PROTOCOL

VARCHAR2

Protocolo SSL negociado entre el cliente y el equilibrador de carga

TIMESTAMP

TIMESTAMP

Hora de generación de entrada de log

USER_AGENT

VARCHAR2

Agente de usuario utilizado para enviar la solicitud al equilibrador de carga

TIME

TIMESTAMP

Hora de generación de entrada de log

TYPE

VARCHAR2

Categoría de log

LOG_ID

VARCHAR2

OCID de log

TENANT_ID

VARCHAR2

OCID de arrendatario

LOG_GROUP_ID

VARCHAR2

OCID de grupo de logs

RESOURCE_ID

VARCHAR2

OCID de recurso

INGESTED_TIME

TIMESTAMP

Registro de tiempo ingerido por el registro de OCI

COMPARTMENT_ID

VARCHAR2

OCID de compartimento de grupo de logs

SOURCE

VARCHAR2

Nombre del recurso que ha generado el mensaje de log

SUBJECT

VARCHAR2

Asunto del registro

SPEC_VERSION

NUMBER

Versión de la especificación CloudEvents que utiliza este mensaje de log

Vista OCI_LBLOG_ERRORS

Vista que proporciona logs de errores del equilibrador de carga que captura información detallada sobre las solicitudes relacionadas con la solución de problemas y la supervisión. Cada entrada contiene información como la hora de recepción de la solicitud, el tipo de error y detalles adicionales del error específico.

Columna Tipo de Dato Descripción

REGION

VARCHAR2

Nombre de región de OCI

DATE_TIME

TIMESTAMP

Igual que el campo oracle.ingestedtime

ID

VARCHAR2

Un UUID aleatorio único para cada entrada de log

ERROR_LOG_TYPE

VARCHAR2

Tipo de Log

ERROR_LOG_ERROR_DETAILS

VARCHAR2

Descripción detallada del mensaje de error

DATA_TIMESTAMP

TIMESTAMP

Hora de generación de entrada de log

TIME

TIMESTAMP

Hora de generación de entrada de log

TYPE

VARCHAR2

Categoría de log

LOG_ID

VARCHAR2

OCID de log

TENANT_ID

VARCHAR2

OCID de arrendatario

LOG_GROUP_ID

VARCHAR2

OCID de grupo de logs

RESOURCE_ID

VARCHAR2

OCID de recurso

INGESTED_TIME

TIMESTAMP

Registro de tiempo ingerido por el registro de OCI

COMPARTMENT_ID

VARCHAR2

OCID de compartimento de grupo de logs

SOURCE

VARCHAR2

Nombre del recurso que ha generado el mensaje de log

SUBJECT

VARCHAR2

Asunto del registro

SPEC_VERSION

NUMBER

Versión de la especificación CloudEvents que utiliza este mensaje de log