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 del 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 del log y otros.

  • Visión general de la interfaz de Oracle Cloud Infrastructure Logging
    Al proporcionar acceso a los datos de log dentro de una instancia de Autonomous Database en formato relacional, se 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 la instancia de Autonomous Database.
  • Vista OCI_LOG_LIST
    Muestra una lista de todos los logs del inquilino. La vista no muestra los datos del log, pero proporciona los metadatos sobre los logs de un arrendamiento. Estos metadatos se utilizan para especificar correctamente los valores de parámetros para otras vistas de registro. Si no hay logs en un grupo de logs, ese grupo de logs 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, para una única conexión TCP, puede tener dos registros en la ventana de captura: uno para la entrada de tráfico y el otro para la salida de tráfico.
  • Vista OCI_LBLOG_ACCESS
    Vista que proporciona logs de acceso de 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 utilizan el equilibrador de carga y el backend para procesar la solicitud.
  • Vista OCI_LBLOG_ERRORS
    Vista que proporciona registros 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 relativos al error específico.

Tema principal: Vistas de Autonomous Database

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

Al proporcionar acceso a los datos de log dentro de una instancia de Autonomous Database en formato relacional, se 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 diferentes tipos de log para cada Oracle service. 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 Oracle Cloud Infrastructure Logging, ahora se puede acceder a los datos del 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 activa 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 valor se devolverá del servidor.
  • 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á los datos correctos ni ningún dato.
  • Para la vista OCI_LOG_LIST, select * from OCI_LOG_LIST mostrará los datos solo 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 un valor 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. que proporciona los valores de predicado necesarios.
  • El marco admite la consulta de datos de log de hasta 7 días (desde la hora actual) para consultar desde las vistas soportadas. Cualquier valor para los predicados START_TIME y END_TIME predicados 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 para 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.

OCI_LOG_LIST Vista

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

Columna Tipo de dato Descripción

REGION

VARCHAR2

Nombre de región de OCI

COMPARTMENT_ID

VARCHAR2

OCID de compartimento

LOG_GROUP_ID

VARCHAR2

OCID LOG_GROUP

LOG_GROUP_NAME

VARCHAR2

Nombre del grupo de logs.

LOG_ID

VARCHAR2

OCID LOG

LOG_NAME

VARCHAR2

Nombre de log

LOG_SERVICE

VARCHAR2

Servicio de log

OCI_LOG_DATA Vista

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 generó 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

Tiempo de ingesta de mensajes de log

LOG_GROUP_ID

VARCHAR2

OCID del 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

OCI_VCN_FLOWLOGS Vista

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, para una única conexión TCP, puede tener dos registros en la ventana de captura: uno para la entrada de tráfico y el otro para la salida de trá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

UUID aleatorio único para cada entrada de log.

ACTION

VARCHAR2

Valores posibles de ACEPTAR o RETIRAR

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

Capturar Hora de Finalización de Ventanas

PACKETS

NUMBER

Número de paquetes registrados en el período de captura

VERSION

VARCHAR2

Número de esquema de registro de log de flujo

BYTES_OUT

NUMBER

Número de Bytes Registrados en Ventana de Captura

PROTOCOL

NUMBER

Número de protocolo IANA

START_TIME

TIMESTAMP

Capturar hora de inicio de la ventana

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 la notación IPv4 o IPv6

DESTINATION_PORT

NUMBER

Número de puerto IANA de destino

DESTINATION_ADDRESS

VARCHAR2

Dirección IP del destino en la 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

OCID DE VNIC

LOG_GROUP_ID

VARCHAR2

OCID del grupo de logs

INGESTED_TIME

TIMESTAMP

Registro de tiempo ingerido por OCI Logging

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 de recurso que generó el mensaje de log

SPEC_VERSION

NUMBER

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

OCI_LBLOG_ACCESS Vista

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 utilizan 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

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 en milisegundos) para establecer la conexión con el servidor backend

BACKEND_PROCESSING_TIME

NUMBER

Tiempo total (en segundos, con una precisión de milisegundos) que tarda el equilibrador de carga en establecer una conexión a un backend hasta que se completa

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 la dirección IP asignada al equilibrador de carga

LB_STATUS_CODE

NUMBER

Código de estado del 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 (en segundos, con una precisión de milisegundos) que tarda el equilibrador de carga en recibir la solicitud del cliente hasta que el equilibrador de carga completa la respuesta de envío 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

El nombre de regla de política de enrutamiento, que coincide para esta solicitud específica

ROUTING_RULES_RULE_HITS

NUMBER

Número de reglas de enrutamiento evaluadas como verdaderas 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 del grupo de logs

RESOURCE_ID

VARCHAR2

OCID de recurso

INGESTED_TIME

TIMESTAMP

Registro de tiempo ingerido por OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID de compartimento de grupo de logs

SOURCE

VARCHAR2

Nombre de recurso que generó el mensaje de log

SUBJECT

VARCHAR2

Asunto del log

SPEC_VERSION

NUMBER

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

OCI_LBLOG_ERRORS Vista

Vista que proporciona registros 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 relativos al 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

UUID aleatorio único para cada entrada de log.

ERROR_LOG_TYPE

VARCHAR2

Tipo 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 del grupo de logs

RESOURCE_ID

VARCHAR2

OCID de recurso

INGESTED_TIME

TIMESTAMP

Registro de tiempo ingerido por OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID de compartimento de grupo de logs

SOURCE

VARCHAR2

Nombre de recurso que generó el mensaje de log

SUBJECT

VARCHAR2

Asunto del log

SPEC_VERSION

NUMBER

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