Documentazione di Oracle Cloud Infrastructure

Viste interfaccia 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 elementi all'interno della funzionalità aggiunta per includere i log personalizzati. I log non vengono memorizzati in Autonomous Database. I log vengono invece recuperati dinamicamente 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, oltre alla possibilità di ottenere i dati di log in formato relazionale o JSON e arricchire l'analitica unendoli ad altri dati che potrebbero avere in Autonomous Database.
  • OCI_LOG_LIST Vista
    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 vi sono log in un gruppo di log, tale gruppo non verrà incluso in questa vista.
  • OCI_LOG_DATA Vista
    La 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 Visualizza
    la vista che fornisce dettagli sul traffico che passa attraverso la VCN dell'utente. Questo log consente agli utenti di controllare il traffico e risolvere i problemi relativi alle liste di sicurezza. Ogni record di log di flusso riflette il traffico registrato in una direzione di una connessione tra due endpoint. Ad esempio, una singola connessione TCP potrebbe contenere due record nella finestra di acquisizione: uno per il traffico in entrata e uno per il traffico in uscita.
  • OCI_LBLOG_ACCESS Vista
    La vista che fornisce i log di accesso al load balancer acquisendo informazioni dettagliate sulle richieste inviate a un load balancer. Ogni voce contiene l'ora di ricezione della richiesta, il client, gli indirizzi IP proxy HTTP intermedi e gli orari utilizzati dal load balancer e dal backend per elaborare la richiesta.
  • OCI_LBLOG_ERRORS Visualizza
    la vista che fornisce log degli errori del load balancer che acquisiscono 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 ulteriori dettagli 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 offre un metodo di accesso utile, oltre alla possibilità di ottenere i dati di log in formato relazionale o JSON e arricchire l'analitica unendoli ad altri dati che potrebbero avere in Autonomous Database.

Il servizio di log Oracle fornisce l'accesso ai log dalle risorse 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 ciascun servizio Oracle. Per ulteriori informazioni sul servizio di log e sui servizi OCI supportati, vedere Panoramica di Oracle Cloud Infrastructure Logging.

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

Per utilizzare queste viste, è necessario effettuare le operazioni riportate di seguito.
  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 delle 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 seguenti regole 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 del predicato sono i seguenti:
Nota

La vista 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 sono relativi agli ultimi 5 minuti in GMT.
  • END_TIME (Facoltativo) - Se non viene fornito alcun valore, i valori restituiti sono relativi agli ultimi 5 minuti in GMT.
  • SEARCH_CRITERIA (Facoltativo) - Se non viene fornito alcun valore, verrà restituito un valore nullo.

Poiché possono esistere diversi tipi di log 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 limitazioni:
  • La vista comune OCI_LOG_DATA supporta tutti i tipi di log, pertanto sono sufficienti COMPARTMENT_ID, LOG_GROUP_ID e REGION. 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 sono necessari dati per un'altra area, sarà necessario utilizzare un predicato di uguaglianza REGION nella clausola WHERE.
  • Se 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., fornire i valori predicato 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. Qualsiasi valore dei predicati START_TIME e END_TIME al di fuori di questo intervallo restituirà 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 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. Altre colonne possono essere utilizzate come predicati di qualsiasi tipo (=, IN). I predicati obbligatori possono essere utilizzati una sola volta in una query e non possono essere utilizzati più volte con AND o NOT.
  • I valori per START_TIME e END_TIME devono essere forniti in formato DD-MM-YY HH24:MI:SS. Se non fornito in questo formato, la query non restituirà alcun dato.

OCI_LOG_LIST Visualizza

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 vi sono log in un gruppo di log, tale gruppo non verrà incluso in questa vista.

A colonne 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

OCI_LOG_DATA Visualizza

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.

A colonne 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 della risorsa che ha generato il messaggio di log

SPEC_VERSION

NUMBER

Versione della specifica CloudEvents utilizzata da questo messaggio di log

LOG_TIME

TIMESTAMP

Ora di generazione dei messaggi di log

TYPE

VARCHAR2

Tipo di messaggio di log

COMPARTMENT_ID

VARCHAR2

OCID compartimento

INGESTED_TIME

TIMESTAMP

Ora inclusione messaggi 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

OCI_VCN_FLOWLOGS Visualizza

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

A colonne 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 dei campi chiave (indirizzi di origine e destinazione, porte e protocollo)

STATUS

VARCHAR2

Valori possibili: OK, NODATA o SKIPDATA

END_TIME

TIMESTAMP

Ora di 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 di inizio finestra di acquisizione

SOURCE_PORT

NUMBER

Numero porta IANA di origine

PROTOCOL_NAME

VARCHAR2

Nome protocollo IANA

SOURCE_ADDRESS

VARCHAR2

Indirizzo IP dell'origine nella notazione IPv4 o IPv6

DESTINATION_PORT

NUMBER

Numero porta IANA di destinazione

DESTINATION_ADDRESS

VARCHAR2

Indirizzo IP della destinazione nella notazione IPv4 o IPv6

TIME

TIMESTAMP

Uguale a 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 incluso 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 da questo messaggio di log

OCI_LBLOG_ACCESS Visualizza

Vista che fornisce i log di accesso del load balancer acquisendo informazioni dettagliate sulle richieste inviate a un load balancer. Ogni voce contiene l'ora di ricezione della richiesta, il client, gli indirizzi IP proxy HTTP intermedi e gli orari utilizzati dal load balancer e dal backend per elaborare la richiesta.

A colonne 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 suo 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 il client e il load balancer

HOST

VARCHAR2

Nome di dominio che viene risolto nell'indirizzo IP assegnato al load balancer

LB_STATUS_CODE

NUMBER

Codice stato load balancer

LISTENER_NAME

VARCHAR2

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

RECEIVED_BYTES

NUMBER

Dimensione totale della richiesta (in byte) ricevuta dal client

REQUEST

VARCHAR2

Riga di richiesta ricevuta dal client

REQUEST_PROCESSING_TIME

NUMBER

Tempo totale impiegato (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 modulo di gestione delle regole di instradamento durante la valutazione dei criteri della richiesta con 0 (nessun errore) o 1 (errore). Se si è verificato un errore, le richieste vengono inoltrate al backend predefinito collegato al listener.

ROUTING_RULES_MATCHED_RULE

VARCHAR2

Nome della regola dei criteri di instradamento corrispondente a questa richiesta specifica

ROUTING_RULES_RULE_HITS

NUMBER

Numero di regole di instradamento valutate su true per la richiesta

ROUTING_RULES_RULE_MISSES

NUMBER

Numero di regole di instradamento valutate su 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 inserimento log

USER_AGENT

VARCHAR2

User agent utilizzato per inviare la richiesta al load balancer

TIME

TIMESTAMP

Ora generazione inserimento 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 incluso 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 registro

SPEC_VERSION

NUMBER

Versione della specifica CloudEvents utilizzata da questo messaggio di log

OCI_LBLOG_ERRORS Visualizza

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 ulteriori dettagli dell'errore specifico.

A colonne 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 inserimento log

TIME

TIMESTAMP

Ora generazione inserimento 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 incluso 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 registro

SPEC_VERSION

NUMBER

Versione della specifica CloudEvents utilizzata da questo messaggio di log