Documentazione dell'infrastruttura Oracle Cloud

Viste dell'interfaccia di Oracle Cloud Infrastructure Logging

Le viste dell'interfaccia di log di Oracle Cloud Infrastructure (OCI) consentono agli utenti autorizzati di accedere ai dati di log tramite un set di viste.

Il log di Oracle Cloud Infrastructure (OCI) è la soluzione di log centrale per i servizi OCI, inclusi i log di flusso VCN, i log del load balancer, i log dello storage degli oggetti e altri all'interno della funzionalità aggiunta per includere i log personalizzati. I log non vengono memorizzati in Autonomous Database. I log vengono invece recuperati in modo dinamico in base a vari predicati forniti dall'utente, tra cui intervallo di date, gruppo di log, nome log e altri.

  • Panoramica dell'interfaccia di Oracle Cloud Infrastructure Logging
    Fornire l'accesso ai dati di log all'interno di un Autonomous Database in formato relazionale fornisce un metodo di accesso utile, insieme alla possibilità di ottenere i dati di log in formato relazionale o JSON e arricchire l'analitica unendosi ad altri dati che potrebbero avere nell'Autonomous Database.
  • Vista OCI_LOG_LIST
    Visualizza una lista di tutti i log nel tenant. La vista non mostra i dati di log, ma fornisce i metadati relativi ai log in una tenancy. Questi metadati vengono utilizzati per specificare correttamente i valori dei parametri per altre viste di log. Se non sono presenti log in un gruppo di log, tale gruppo di log non verrà incluso in questa vista.
  • OCI_LOG_DATA Vista
    Vista comune che fornisce l'accesso a tutti i tipi di log supportati dal servizio di log OCI. Il contenuto del log si trova nella colonna DATA.
  • OCI_VCN_FLOWLOGS Vista
    Visualizzazione che fornisce dettagli sul traffico che passa attraverso la VCN dell'utente. Questo log consente agli utenti di eseguire l'audit del traffico e risolvere i problemi relativi alle liste di sicurezza. Ogni record del log di flusso riflette il traffico registrato in una direzione di una connessione tra due endpoint. Ad esempio, una singola connessione TCP, è possibile che nella finestra di acquisizione siano presenti due record: uno per il traffico in entrata e uno per il traffico in uscita.
  • Vista OCI_LBLOG_ACCESS
    Visualizzazione che fornisce log degli accessi al load balancer che acquisiscono informazioni dettagliate sulle richieste inviate a un load balancer. Ogni voce contiene l'ora in cui la richiesta è stata ricevuta, il client, gli indirizzi IP proxy HTTP intermedi e gli orari utilizzati dal load balancer e dal backend per elaborare la richiesta.
  • Vista OCI_LBLOG_ERRORS
    Visualizzazione che fornisce i log degli errori del load balancer, acquisendo informazioni dettagliate sulle richieste relative alla risoluzione dei problemi e al monitoraggio. Ogni voce contiene informazioni quali l'ora di ricezione della richiesta, il tipo di errore e i dettagli aggiuntivi dell'errore specifico.

Argomento padre: Viste di Autonomous Database

Panoramica dell'interfaccia di Oracle Cloud Infrastructure Logging

Fornire l'accesso ai dati di log all'interno di un Autonomous Database in formato relazionale fornisce un metodo di accesso utile, insieme alla possibilità di ottenere i dati di log in formato relazionale o JSON e arricchire l'analitica unendoti ad altri dati che potrebbero avere nell'Autonomous Database.

Il servizio di registrazione Oracle fornisce l'accesso ai log dalle risorse di Oracle Cloud Infrastructure (OCI). Questi log includono informazioni di diagnostica critiche che descrivono le prestazioni e l'accesso alle risorse. Esistono vari tipi di log per ogni Oracle service. Per ulteriori informazioni sul servizio di log e sui servizi OCI supportati, vedere Panoramica di Oracle Cloud Infrastructure Logging.

Attraverso l'interfaccia Oracle Cloud Infrastructure Logging, è ora possibile accedere ai dati di log tramite un Autonomous Database in formato relazionale. Gli utenti possono eseguire query su dati di log diversi in OCI in tutti i compartimenti e le aree. Le viste OCI implementate utilizzano la credenziale OCI$RESOURCE_PRINCIPAL.

Per utilizzare queste viste, è necessario procedere come segue.
  1. Un amministratore consente di utilizzare la credenziale OCI$RESOURCE_PRINCIPAL nel database.
  2. Gli utenti creano un nuovo gruppo dinamico per la credenziale OCI$RESOURCE_PRINCIPAL.

Per ulteriori informazioni sull'abilitazione della credenziale, sull'impostazione di un gruppo dinamico e sulla creazione di istruzioni dei criteri, vedere Usa principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure.

Abilitare il principal risorsa come amministratore.
EXEC DBMS_CLOUD_ADMIN.ENABLE_RESOURCE_PRINCIPAL();
Il gruppo dinamico deve avere le regole seguenti che includono l'ID risorsa dell'istanza. 
resource.id = '<resource.id>'
Per accedere alle viste di log sono necessarie due istruzioni criterio.
-- 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

Tutte le viste hanno valori di predicato obbligatori e facoltativi (nomi di colonna).

I valori di predicato sono i seguenti:
La vista Nota

OCI_LOG_LIST non dispone di colonne obbligatorie. Se il valore REGION non viene fornito, la vista restituisce i dati per l'area di origine.
  • REGION (obbligatorio)
  • COMPARTMENT_ID (obbligatorio)
  • LOG_GROUP_ID (obbligatorio)
  • LOG_ID (facoltativo): se viene fornito il valore, i risultati della query utilizzeranno il valore LOG_ID. Se non viene fornito alcun valore, il valore verrà restituito dal server.
  • START_TIME (facoltativo): se non viene fornito alcun valore, i valori restituiti si riferiscono agli ultimi 5 minuti nel GMT.
  • END_TIME (facoltativo): se non viene fornito alcun valore, i valori restituiti si riferiscono agli ultimi 5 minuti nel GMT.
  • SEARCH_CRITERIA (facoltativo): se non viene fornito alcun valore, verrà restituito un valore nullo.

Poiché possono esistere tipi di log diversi all'interno di un singolo gruppo di log, si consiglia di specificare LOG_ID in un predicato quando si utilizzano le viste OCI_VCN_FLOWLOGS, OCI_LBLOG_ACCESS e OCI_LBLOG_ERRORS.

Note e restrizioni:
  • La vista comune OCI_LOG_DATA supporta tutti i tipi di log, pertanto COMPARTMENT_ID, LOG_GROUP_ID e REGION sono sufficienti. Allo stesso modo, se un utente utilizza il LOG_ID di un load balancer con la vista OCI_VCN_FLOWLOGS, non restituirà dati corretti o alcun dato.
  • Per la vista OCI_LOG_LIST, select * from OCI_LOG_LIST mostrerà i dati solo per l'area di origine. Se hai bisogno di dati per un'altra area, dovrai utilizzare un predicato di uguaglianza REGION nella clausola WHERE.
  • Se i valori OCI_LOG_DATA, OCI_VCN_FLOWLOGS, OCI_LBLOG_ACCESS e OCI_LBLOG_ERRORS, select * from <view> fornisce un valore 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. per i predicati richiesti.
  • Il framework supporta l'esecuzione di query sui dati di log degli ultimi 7 giorni (dall'ora corrente) per eseguire query dalle viste supportate. Tutti i valori per i predicati START_TIME e END_TIME al di fuori di questo intervallo genereranno ORA-20000: start_time and end_time should be from current_timestamp to current_timestamp-7.
  • Se non si forniscono i predicati obbligatori elencati, verrà visualizzato un messaggio 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. Altre colonne possono essere utilizzate come predicati di qualsiasi tipo (=, IN). I predicati obbligatori possono essere utilizzati solo una volta in una query e non più volte con AND o NOT.
  • I valori per START_TIME e END_TIME devono essere specificati in formato DD-MM-YY HH24:MI:SS. Se non viene fornito in questo formato, la query non restituirà alcun dato.

Vista OCI_LOG_LIST

Visualizza una lista di tutti i log nel tenant. La vista non mostra i dati di log, ma fornisce i metadati relativi ai log in una tenancy. Questi metadati vengono utilizzati per specificare correttamente i valori dei parametri per altre viste di log. Se non sono presenti log in un gruppo di log, tale gruppo di log non verrà incluso in questa vista.

Colonna Tipo di dati Descrizione

REGION

VARCHAR2

Nome area OCI

COMPARTMENT_ID

VARCHAR2

OCID compartimento

LOG_GROUP_ID

VARCHAR2

OCID LOG_GROUP

LOG_GROUP_NAME

VARCHAR2

Nome gruppo di log.

LOG_ID

VARCHAR2

OCID LOG

LOG_NAME

VARCHAR2

Nome log

LOG_SERVICE

VARCHAR2

Servizio di log

Vista OCI_LOG_DATA

Vista comune che fornisce l'accesso a tutti i tipi di log supportati dal servizio di log OCI. Il contenuto del log si trova nella colonna DATA.

Colonna Tipo di dati Descrizione

DATE_TIME

TIMESTAMP

Uguale al campo oracle.ingestedtime

ID

VARCHAR2

Un UUID casuale per ogni voce di log

SOURCE

VARCHAR2

Nome risorsa che ha generato il messaggio di log

SPEC_VERSION

NUMBER

Versione della specifica CloudEvents utilizzata dal messaggio di log

LOG_TIME

TIMESTAMP

Ora generazione messaggio di log

TYPE

VARCHAR2

Tipo di messaggio log

COMPARTMENT_ID

VARCHAR2

OCID compartimento

INGESTED_TIME

TIMESTAMP

Ora di inclusione messaggio di log

LOG_GROUP_ID

VARCHAR2

OCID gruppo di log

LOG_ID

VARCHAR2

OCID log

TENANT_ID

VARCHAR2

OCID tenant del proprietario dell'oggetto di log

DATA

CLOB

Messaggio di log

ORACLE_DETAILS

CLOB

Metadati specifici di Oracle

Vista OCI_VCN_FLOWLOGS

Vista che fornisce dettagli sul traffico che passa attraverso la VCN dell'utente. Questo log consente agli utenti di eseguire l'audit del traffico e risolvere i problemi relativi alle liste di sicurezza. Ogni record del log di flusso riflette il traffico registrato in una direzione di una connessione tra due endpoint. Ad esempio, una singola connessione TCP, è possibile che nella finestra di acquisizione siano presenti due record: uno per il traffico in entrata e uno per il traffico in uscita.

Colonna Tipo di dati Descrizione

REGION

VARCHAR2

Nome area OCI

DATE_TIME

TIMESTAMP

Uguale al campo oracle.ingestedtime

ID

VARCHAR2

Un UUID casuale univoco per ogni voce di log

ACTION

VARCHAR2

Valori possibili di ACCEPT o REJECT

FLOW_ID

VARCHAR2

Hash di campi chiave (indirizzi di origine e destinazione, porte e protocollo)

STATUS

VARCHAR2

Valori possibili di OK, NODATA o SKIPDATA

END_TIME

TIMESTAMP

Ora fine finestra di acquisizione

PACKETS

NUMBER

Numero di pacchetti registrati nella finestra di acquisizione

VERSION

VARCHAR2

Numero schema record log di flusso

BYTES_OUT

NUMBER

Numero di byte registrati nella finestra di acquisizione

PROTOCOL

NUMBER

Numero protocollo IANA

START_TIME

TIMESTAMP

Ora inizio finestra di acquisizione

SOURCE_PORT

NUMBER

Numero porta IANA di origine

PROTOCOL_NAME

VARCHAR2

Nome protocollo IANA

SOURCE_ADDRESS

VARCHAR2

Indirizzo IP della fonte in notazione IPv4 o IPv6

DESTINATION_PORT

NUMBER

Numero porta IANA di destinazione

DESTINATION_ADDRESS

VARCHAR2

Indirizzo IP della destinazione in notazione IPv4 o IPv6

TIME

TIMESTAMP

Sinonimo di START_TIME

TYPE

VARCHAR2

Categoria di log

LOG_ID

VARCHAR2

OCID log

TENANT_ID

VARCHAR2

OCID tenant

VNIC_OCID

VARCHAR2

OCID VNIC

LOG_GROUP_ID

VARCHAR2

OCID gruppo di log

INGESTED_TIME

TIMESTAMP

Log ore inclusi da OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID compartimento gruppo di log

VNIC_SUBNET_OCID

VARCHAR2

OCID subnet VNIC

VNIC_COMPARTMENT_ID

VARCHAR2

OCID compartimento VNIC

SOURCE

VARCHAR2

Nome della risorsa che ha generato il messaggio di log

SPEC_VERSION

NUMBER

Versione della specifica CloudEvents utilizzata dal messaggio di log

Vista OCI_LBLOG_ACCESS

Vista che fornisce i log degli accessi del load balancer che acquisiscono informazioni dettagliate sulle richieste inviate a un load balancer. Ogni voce contiene l'ora in cui la richiesta è stata ricevuta, il client, gli indirizzi IP proxy HTTP intermedi e gli orari utilizzati dal load balancer e dal backend per elaborare la richiesta.

Colonna Tipo di dati Descrizione

REGION

VARCHAR2

Nome area OCI

DATE_TIME

TIMESTAMP

Uguale al campo oracle.ingestedtime

ID

VARCHAR2

Un UUID casuale univoco per ogni voce di log

BACKEND_ADDRESS

VARCHAR2

Indirizzo IP e numero di porta del server backend che ha elaborato la richiesta client

BACKEND_CONNECT_TIME

NUMBER

Tempo impiegato (in secondi, con precisione in millisecondi) per stabilire la connessione al server backend

BACKEND_PROCESSING_TIME

NUMBER

Tempo totale impiegato (in secondi, con precisione in millisecondi) dal load balancer per stabilire una connessione a un backend fino al completamento

BACKEND_STATUS_CODE

NUMBER

Codice di stato della risposta dalla destinazione

CLIENT_ADDRESS

VARCHAR2

Indirizzo IP e numero di porta del client richiedente

FORWARDED_FOR_ADDRESS

VARCHAR2

Indirizzo IP del client e proxy HTTP tra client e load balancer

HOST

VARCHAR2

Nome di dominio che risolve l'indirizzo IP assegnato al load balancer

LB_STATUS_CODE

NUMBER

Codice stato load balance

LISTENER_NAME

VARCHAR2

Listener che ha ricevuto la richiesta di traffico in entrata nell'indirizzo IP del load balancer

RECEIVED_BYTES

NUMBER

Dimensione totale della richiesta (in byte) ricevuta dal client

REQUEST

VARCHAR2

Richiesta ricevuta dal cliente

REQUEST_PROCESSING_TIME

NUMBER

Tempo totale richiesto (in secondi, con precisione in millisecondi) dal load balancer che riceve la richiesta dal client fino al completamento dell'invio della risposta al client da parte del load balancer.

ROUTING_RULES_ENGINE_ERRORS

NUMBER

Errore del motore delle regole di instradamento durante la valutazione dei criteri della richiesta con 0 (nessun errore) o 1 (errore). Se si verifica un errore, le richieste vengono inoltrate al backend predefinito collegato al listener.

ROUTING_RULES_MATCHED_RULE

VARCHAR2

Nome della regola del criterio di instradamento corrispondente per questa richiesta specifica

ROUTING_RULES_RULE_HITS

NUMBER

Numero di regole di instradamento valutate come vere per la richiesta

ROUTING_RULES_RULE_MISSES

NUMBER

Numero di regole di instradamento valutate come false per la richiesta

SENT_BYTES

NUMBER

Dimensione totale della richiesta (in byte) inviata al client

SSL_CIPHER

VARCHAR2

Cifra SSL negoziata tra il client e il load balancer

SSL_PROTOCOL

VARCHAR2

Protocollo SSL negoziato tra il client e il load balancer

TIMESTAMP

TIMESTAMP

Ora generazione voce di log

USER_AGENT

VARCHAR2

User agent utilizzato per inviare la richiesta al load balancer

TIME

TIMESTAMP

Ora generazione voce di log

TYPE

VARCHAR2

Categoria di log

LOG_ID

VARCHAR2

OCID log

TENANT_ID

VARCHAR2

OCID tenant

LOG_GROUP_ID

VARCHAR2

OCID gruppo di log

RESOURCE_ID

VARCHAR2

OCID risorsa

INGESTED_TIME

TIMESTAMP

Log ore inclusi da OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID compartimento gruppo di log

SOURCE

VARCHAR2

Nome della risorsa che ha generato il messaggio di log

SUBJECT

VARCHAR2

Oggetto del log

SPEC_VERSION

NUMBER

Versione della specifica CloudEvents utilizzata dal messaggio di log

Vista OCI_LBLOG_ERRORS

Vista che fornisce i log degli errori del load balancer, acquisendo informazioni dettagliate sulle richieste correlate alla risoluzione dei problemi e al monitoraggio. Ogni voce contiene informazioni quali l'ora di ricezione della richiesta, il tipo di errore e i dettagli aggiuntivi dell'errore specifico.

Colonna Tipo di dati Descrizione

REGION

VARCHAR2

Nome area OCI

DATE_TIME

TIMESTAMP

Uguale al campo oracle.ingestedtime

ID

VARCHAR2

Un UUID casuale univoco per ogni voce di log

ERROR_LOG_TYPE

VARCHAR2

Tipo di log

ERROR_LOG_ERROR_DETAILS

VARCHAR2

Descrizione dettagliata del messaggio di errore

DATA_TIMESTAMP

TIMESTAMP

Ora generazione voce di log

TIME

TIMESTAMP

Ora generazione voce di log

TYPE

VARCHAR2

Categoria di log

LOG_ID

VARCHAR2

OCID log

TENANT_ID

VARCHAR2

OCID tenant

LOG_GROUP_ID

VARCHAR2

OCID gruppo di log

RESOURCE_ID

VARCHAR2

OCID risorsa

INGESTED_TIME

TIMESTAMP

Log ore inclusi da OCI Logging

COMPARTMENT_ID

VARCHAR2

OCID compartimento gruppo di log

SOURCE

VARCHAR2

Nome della risorsa che ha generato il messaggio di log

SUBJECT

VARCHAR2

Oggetto del log

SPEC_VERSION

NUMBER

Versione della specifica CloudEvents utilizzata dal messaggio di log