Documentação do Oracle Cloud Infrastructure

Views de Interface do Oracle Cloud Infrastructure Logging

As views da interface de log do OCI (Oracle Cloud Infrastructure) permitem que usuários autorizados acessem dados de log por meio de um conjunto de views.

O registro em log do OCI (Oracle Cloud Infrastructure) é a solução de registro em log central para serviços do OCI, incluindo logs de fluxo da VCN, logs do balanceador de carga, logs de armazenamento de objetos e outros dentro do recurso adicional para incluir logs personalizados. Os logs não são armazenados no Autonomous Database. Em vez disso, os logs são recuperados dinamicamente com base em vários predicados fornecidos pelo usuário, incluindo intervalo de datas, grupo de logs, nome do log e outros.

  • Visão Geral da Interface do Oracle Cloud Infrastructure Logging
    Fornecer acesso aos dados de log dentro de um Autonomous Database em formato relacional fornece um método de acesso útil, juntamente com a capacidade de obter os dados de log no formato relacional ou JSON e enriquecer a análise unindo-se a outros dados que possam ter no Autonomous Database.
  • OCI_LOG_LIST Exibir
    Exibe uma lista de todos os logs no tenant. A view não mostra dados de log, mas fornece os metadados sobre os logs em uma tenancy. Esses metadados são usados para especificar corretamente valores de parâmetro para outra view de log. Se não houver logs em um grupo de logs, esse grupo não será incluído nessa view.
  • OCI_LOG_DATA View
    A view comum que fornece acesso a todos os tipos de log suportados pelo Serviço OCI Logging. O conteúdo do log está na coluna DATA.
  • OCI_VCN_FLOWLOGS View
    Exibição que fornece detalhes sobre o tráfego que passa pela VCN do usuário. Esse log permite que os usuários auditem o tráfego e solucionem problemas de listas de segurança. Cada registro de log de fluxo reflete o tráfego registrado em uma direção de uma conexão entre dois pontos finais. Por exemplo, uma única conexão TCP, você pode ter dois registros na janela de captura: um para tráfego de entrada e outro para tráfego de saída.
  • OCI_LBLOG_ACCESS Exibir
    Exibição que fornece logs de acesso do balanceador de carga capturando informações detalhadas sobre solicitações enviadas a um balanceador de carga. Cada entrada contém o horário em que a solicitação foi recebida, o cliente, os endereços IP do proxy HTTP intermediário e os horários usados pelo balanceador de carga e pelo backend para processar a solicitação.
  • OCI_LBLOG_ERRORS View
    View que fornece logs de erro do balanceador de carga capturando informações detalhadas sobre solicitações relacionadas à solução de problemas e ao monitoramento. Cada entrada contém informações como a hora em que a solicitação foi recebida, o tipo de erro e os detalhes adicionais do erro específico.

Tópico principal: Views do Autonomous Database

Visão Geral da Interface do Oracle Cloud Infrastructure Logging

Fornecer acesso aos dados de log dentro de um Autonomous Database em formato relacional fornece um método de acesso útil, juntamente com a capacidade de obter os dados de log no formato relacional ou JSON e enriquecer a análise unindo-se a outros dados que eles possam ter no Autonomous Database.

O serviço de log da Oracle fornece acesso a logs de recursos do OCI (Oracle Cloud Infrastructure). Esses logs incluem informações críticas de diagnóstico que descrevem o desempenho e o acesso dos recursos. Existem vários tipos de log para cada serviço Oracle. Para saber mais sobre o serviço de log e os serviços do OCI suportados, consulte Visão Geral do Oracle Cloud Infrastructure Logging.

Por meio da Interface do Oracle Cloud Infrastructure Logging, os dados de log agora podem ser acessados por meio de um Autonomous Database em formato relacional. Os usuários podem consultar diferentes dados de log no OCI em todos os compartimentos e regiões. As views do OCI implementadas usam a credencial OCI$RESOURCE_PRINCIPAL.

Para usar essas exibições, as etapas a seguir precisam ser executadas.
  1. Um Administrador permite o uso da credencial OCI$RESOURCE_PRINCIPAL no banco de dados.
  2. Os usuários criam um novo grupo dinâmico para a credencial OCI$RESOURCE_PRINCIPAL.

Para saber mais sobre como ativar a credencial, configurar um grupo dinâmico e criar instruções de política, consulte Usar o Controlador de Recursos para Acessar Recursos do Oracle Cloud Infrastructure.

Como Administrador, ative o controlador de recursos.
EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();
O grupo dinâmico deve ter as regras a seguir que incluem o ID do recurso da instância. 
resource.id = '<resource.id>'
Há duas instruções de política necessárias para acessar views de log.
-- 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 as views têm valores de predicado obrigatórios e opcionais (nomes de colunas).

Os valores de predicado são os seguintes:
Observação

A view OCI_LOG_LIST não tem colunas obrigatórias. Se o valor REGION não for fornecido, a view retornará dados para a região home.
  • REGION (Obrigatório)
  • COMPARTMENT_ID (Obrigatório)
  • LOG_GROUP_ID (Obrigatório)
  • LOG_ID (Opcional) - Se o valor for fornecido, os resultados da consulta usarão o valor LOG_ID. Se nenhum valor for fornecido, o valor será retornado do servidor.
  • START_TIME (Opcional) - Se nenhum valor for fornecido, os valores de retorno serão nos últimos 5 minutos no GMT.
  • END_TIME (Opcional) - Se nenhum valor for fornecido, os valores de retorno serão nos últimos 5 minutos no GMT.
  • SEARCH_CRITERIA (Opcional) - Se nenhum valor for fornecido, nulo será retornado.

Como pode haver diferentes tipos de log em um único grupo de logs, é recomendável especificar LOG_ID em um predicado ao usar as views OCI_VCN_FLOWLOGS, OCI_LBLOG_ACCESS e OCI_LBLOG_ERRORS.

Notas e Restrições:
  • A view comum OCI_LOG_DATA suporta todos os tipos de log; portanto, COMPARTMENT_ID, LOG_GROUP_ID e REGION são suficientes. Da mesma forma, se um usuário usar o LOG_ID de um balanceador de carga com a view OCI_VCN_FLOWLOGS, ele não retornará dados corretos ou nenhum dado.
  • Para a view OCI_LOG_LIST, o select * from OCI_LOG_LIST mostrará dados somente para a região home. Se precisar de dados para outra região, você precisará usar um predicado de igualdade REGION na cláusula WHERE.
  • Se OCI_LOG_DATA, OCI_VCN_FLOWLOGS, OCI_LBLOG_ACCESS e OCI_LBLOG_ERRORS, o select * from <view> fornecerá a um 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. os valores de predicado necessários.
  • A estrutura suporta a consulta de dados de log nos últimos 7 dias (a partir da hora atual) para consulta nas views suportadas. Qualquer valor para os predicados START_TIME e END_TIME fora dessa faixa resultará em ORA-20000: start_time and end_time should be from current_timestamp to current_timestamp-7.
  • Se você não fornecer os predicados obrigatórios listados, verá 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. Outras colunas podem ser usadas como predicados de qualquer tipo (=, IN). Os predicados obrigatórios só podem ser usados uma vez em uma consulta e não podem ser usados várias vezes com AND ou NOT.
  • Os valores para START_TIME e END_TIME devem ser fornecidos no formato DD-MM-YY HH24:MI:SS. Se não for fornecido neste formato, a consulta não retornará dados.

OCI_LOG_LIST Exibir

Exibe uma lista de todos os logs no tenant. A view não mostra dados de log, mas fornece os metadados sobre os logs em uma tenancy. Esses metadados são usados para especificar corretamente valores de parâmetro para outra view de log. Se não houver logs em um grupo de logs, esse grupo não será incluído nessa view.

Coluna Tipo de dados Descrição

REGION

VARCHAR2

Nome da região do OCI

COMPARTMENT_ID

VARCHAR2

OCID do Compartimento

LOG_GROUP_ID

VARCHAR2

OCID LOG_GROUP

LOG_GROUP_NAME

VARCHAR2

Nome do grupo de logs.

LOG_ID

VARCHAR2

LOG OCID

LOG_NAME

VARCHAR2

Nome do log

LOG_SERVICE

VARCHAR2

Serviço de log

OCI_LOG_DATA Exibir

A view comum que fornece acesso a todos os tipos de log suportados pelo Serviço OCI Logging. O conteúdo do log está na coluna DATA.

Coluna Tipo de dados Descrição

DATE_TIME

TIMESTAMP

Igual ao campo oracle.ingestedtime

ID

VARCHAR2

Um UUID aleatório para cada entrada de log

SOURCE

VARCHAR2

Nome do recurso que gerou a mensagem de log

SPEC_VERSION

NUMBER

Versão da especificação CloudEvents que esta mensagem de log usa

LOG_TIME

TIMESTAMP

Registrar hora de geração da mensagem

TYPE

VARCHAR2

Registrar tipo de mensagem

COMPARTMENT_ID

VARCHAR2

OCID do Compartimento

INGESTED_TIME

TIMESTAMP

Tempo de ingestão da mensagem de log

LOG_GROUP_ID

VARCHAR2

OCID do grupo de logs

LOG_ID

VARCHAR2

OCID do Log

TENANT_ID

VARCHAR2

OCID do tenant do proprietário do objeto de log

DATA

CLOB

Mensagem de log

ORACLE_DETAILS

CLOB

Metadados específicos da Oracle

OCI_VCN_FLOWLOGS Exibir

View que fornece detalhes sobre o tráfego que passa pela VCN do usuário. Esse log permite que os usuários auditem o tráfego e solucionem problemas de listas de segurança. Cada registro de log de fluxo reflete o tráfego registrado em uma direção de uma conexão entre dois pontos finais. Por exemplo, uma única conexão TCP, você pode ter dois registros na janela de captura: um para tráfego de entrada e outro para tráfego de saída.

Coluna Tipo de dados Descrição

REGION

VARCHAR2

Nome da região do OCI

DATE_TIME

TIMESTAMP

Igual ao campo oracle.ingestedtime

ID

VARCHAR2

Um UUID aleatório exclusivo de cada entrada de log

ACTION

VARCHAR2

Valores possíveis de ACCEPT ou REJECT

FLOW_ID

VARCHAR2

Hash de campos-chave (endereços, de origem e destino, portas e protocolo)

STATUS

VARCHAR2

Valores possíveis de OK, NODATA ou SKIPDATA

END_TIME

TIMESTAMP

Horário final da janela de captura

PACKETS

NUMBER

Número de pacotes registrados na janela de captura

VERSION

VARCHAR2

Número do esquema de registro do log de fluxo

BYTES_OUT

NUMBER

Número de bytes registrados na janela de captura

PROTOCOL

NUMBER

Número do protocolo IANA

START_TIME

TIMESTAMP

Horário inicial da janela de captura

SOURCE_PORT

NUMBER

Número da porta da AINA de origem

PROTOCOL_NAME

VARCHAR2

Nome do protocolo IANA

SOURCE_ADDRESS

VARCHAR2

Endereço IP da origem na notação IPv4 ou IPv6

DESTINATION_PORT

NUMBER

Número da porta da AINA de destino

DESTINATION_ADDRESS

VARCHAR2

Endereço IP do destino na notação IPv4 ou IPv6

TIME

TIMESTAMP

O mesmo que START_TIME

TYPE

VARCHAR2

Categoria de log

LOG_ID

VARCHAR2

OCID do Log

TENANT_ID

VARCHAR2

OCID do Tenant

VNIC_OCID

VARCHAR2

VNIC OCID

LOG_GROUP_ID

VARCHAR2

OCID do grupo de logs

INGESTED_TIME

TIMESTAMP

Log de tempo ingerido pelo OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID do compartimento do grupo de logs

VNIC_SUBNET_OCID

VARCHAR2

OCID da sub-rede da VNIC

VNIC_COMPARTMENT_ID

VARCHAR2

OCID do compartimento da VNIC

SOURCE

VARCHAR2

Nome do recurso que gerou a mensagem de log

SPEC_VERSION

NUMBER

Versão da especificação CloudEvents que esta mensagem de log usa

OCI_LBLOG_ACCESS Exibir

Exibição que fornece logs de acesso do balanceador de carga capturando informações detalhadas sobre solicitações enviadas a um balanceador de carga. Cada entrada contém o horário em que a solicitação foi recebida, o cliente, os endereços IP do proxy HTTP intermediário e os horários usados pelo balanceador de carga e pelo backend para processar a solicitação.

Coluna Tipo de dados Descrição

REGION

VARCHAR2

Nome da região do OCI

DATE_TIME

TIMESTAMP

Igual ao campo oracle.ingestedtime

ID

VARCHAR2

Um UUID aleatório exclusivo de cada entrada de log

BACKEND_ADDRESS

VARCHAR2

Endereço IP e número da porta do servidor de backend que processou a solicitação do cliente

BACKEND_CONNECT_TIME

NUMBER

Tempo gasto (em segundos, com precisão de milissegundo) para estabelecer conexão com o servidor de backend

BACKEND_PROCESSING_TIME

NUMBER

Tempo total gasto (em segundos, com precisão de milissegundos) do balanceador de carga que estabelece uma conexão com um backend até que ele seja concluído

BACKEND_STATUS_CODE

NUMBER

Código de status da resposta do destino

CLIENT_ADDRESS

VARCHAR2

Endereço IP e número da porta do cliente solicitante

FORWARDED_FOR_ADDRESS

VARCHAR2

Endereço IP do cliente e dos proxies http entre o cliente e o balanceador de carga

HOST

VARCHAR2

Nome do domínio que é resolvido para o endereço IP atribuído ao balanceador de carga

LB_STATUS_CODE

NUMBER

Código de status do balanceador de carga

LISTENER_NAME

VARCHAR2

Listener que recebeu a solicitação de tráfego de entrada no endereço IP do balanceador de carga

RECEIVED_BYTES

NUMBER

Tamanho total da solicitação (em bytes) recebido do cliente

REQUEST

VARCHAR2

Linha de solicitação recebida do cliente

REQUEST_PROCESSING_TIME

NUMBER

Tempo total gasto (em segundos, com precisão de milissegundo) do balanceador de carga que está recebendo a solicitação do cliente até que o balanceador de carga conclua o envio de resposta ao cliente.

ROUTING_RULES_ENGINE_ERRORS

NUMBER

Erro do mecanismo da regra de roteiro durante a avaliação da política da solicitação com um 0 (sem erro) ou 1 (erro). Se ocorrer um erro, as solicitações serão encaminhadas ao backend padrão anexado ao listener.

ROUTING_RULES_MATCHED_RULE

VARCHAR2

Nome da regra da política de roteamento, que correspondeu a esta solicitação específica

ROUTING_RULES_RULE_HITS

NUMBER

Número de regras de roteamento avaliadas como verdadeiras para a solicitação

ROUTING_RULES_RULE_MISSES

NUMBER

Número de regras de roteamento avaliadas como falsas para a solicitação

SENT_BYTES

NUMBER

Tamanho total da solicitação (em bytes) enviada para o cliente

SSL_CIPHER

VARCHAR2

Cifra SSL negociada entre o cliente e o balanceador de carga

SSL_PROTOCOL

VARCHAR2

Protocolo SSL negociado entre o cliente e o balanceador de carga

TIMESTAMP

TIMESTAMP

Horário de geração da entrada do log

USER_AGENT

VARCHAR2

Agente de usuário usado para enviar a solicitação ao balanceador de carga

TIME

TIMESTAMP

Horário de geração da entrada do log

TYPE

VARCHAR2

Categoria de log

LOG_ID

VARCHAR2

OCID do Log

TENANT_ID

VARCHAR2

OCID do Tenant

LOG_GROUP_ID

VARCHAR2

OCID do grupo de logs

RESOURCE_ID

VARCHAR2

OCID do Recurso

INGESTED_TIME

TIMESTAMP

Log de tempo ingerido pelo OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID do compartimento do grupo de logs

SOURCE

VARCHAR2

Nome do recurso que gerou a mensagem de log

SUBJECT

VARCHAR2

Assunto do log

SPEC_VERSION

NUMBER

Versão da especificação CloudEvents que esta mensagem de log usa

OCI_LBLOG_ERRORS Exibir

Exibição que fornece logs de erro do balanceador de carga capturando informações detalhadas sobre solicitações relacionadas a solução de problemas e monitoramento. Cada entrada contém informações como a hora em que a solicitação foi recebida, o tipo de erro e os detalhes adicionais do erro específico.

Coluna Tipo de dados Descrição

REGION

VARCHAR2

Nome da região do OCI

DATE_TIME

TIMESTAMP

Igual ao campo oracle.ingestedtime

ID

VARCHAR2

Um UUID aleatório exclusivo de cada entrada de log

ERROR_LOG_TYPE

VARCHAR2

Tipo de log

ERROR_LOG_ERROR_DETAILS

VARCHAR2

Descrição detalhada da mensagem de erro

DATA_TIMESTAMP

TIMESTAMP

Horário de geração da entrada do log

TIME

TIMESTAMP

Horário de geração da entrada do log

TYPE

VARCHAR2

Categoria de log

LOG_ID

VARCHAR2

OCID do Log

TENANT_ID

VARCHAR2

OCID do Tenant

LOG_GROUP_ID

VARCHAR2

OCID do grupo de logs

RESOURCE_ID

VARCHAR2

OCID do Recurso

INGESTED_TIME

TIMESTAMP

Log de tempo ingerido pelo OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID do compartimento do grupo de logs

SOURCE

VARCHAR2

Nome do recurso que gerou a mensagem de log

SUBJECT

VARCHAR2

Assunto do log

SPEC_VERSION

NUMBER

Versão da especificação CloudEvents que esta mensagem de log usa