Documentazione di Oracle Cloud Infrastructure

Log personalizzati

I log personalizzati sono log che contengono informazioni di diagnostica di applicazioni personalizzate, di altri provider cloud o di un ambiente in locale.

I log personalizzati possono essere inclusi nei modi riportati di seguito.

  • Utilizzando PutLogs per includere direttamente i log personalizzati. Per ulteriori informazioni, consulta le API di inclusione di log e le API REST. Vedere anche Ingestione dei log personalizzati per un payload delle voci di log di esempio che può essere utilizzato con PutLogs.

  • Mediante la configurazione dell'agente di monitoraggio unificato. Per istruzioni, vedere Installazione dell'agente.

    Nota

    Quando si gestiscono i plugin dell'agente Oracle Cloud, l'agente di monitoraggio unificato viene definito "Monitoraggio dei log personalizzati".

I log personalizzati possono essere visualizzati nella pagina Istanza di computazione di Oracle Cloud Infrastructure e avere una risorsa Log associata. Possono essere visualizzati anche nella pagina Cerca di log, nella pagina Log o in una pagina di dettaglio Gruppi di log associata. I log personalizzati sono supportati anche nelle istanze Bare Metal.

Nota

Puoi anche visualizzare la velocità con cui vengono accettati e inclusi i log personalizzati utilizzando il servizio Oracle Cloud Infrastructure Monitoring. Per ulteriori informazioni, vedere Visualizzazione della percentuale di accettazione dei log personalizzati.

L'agente di monitoraggio unificato può essere installato su molti computer e estrae i registri dalle directory locali, dove le applicazioni o i sistemi emettono registri. L'agente può anche analizzare automaticamente i log. Tutto questo viene configurato in Configurazioni agente. È possibile creare una configurazione agente separatamente, quindi associarvi un log personalizzato oppure creare un log personalizzato e successivamente crearne la configurazione agente.

Una configurazione agente è il meccanismo centrale per definire:
  • Host da cui si desidera ottenere i log.
  • Log specifici desiderati dagli host.
  • Parser aggiuntivi.
  • Destinazione log personalizzata.

La creazione di un log personalizzato è un processo in due fasi, in cui si crea prima l'oggetto di log personalizzato e quindi la configurazione dell'agente associato. Per ulteriori informazioni sulla creazione di log personalizzati e configurazioni agente, vedere Creazione di un log e Panoramica sulla gestione degli agenti per ulteriori informazioni sull'impostazione e la gestione dell'agente.

Nota

Affinché l'agente venga eseguito correttamente, assicurarsi che le impostazioni del firewall consentano i seguenti endpoint URI:
  • https://auth.<your region>.oraclecloud.com
  • https://ingestion.logging.<your region>.oci.oraclecloud.com.

Metadati di log personalizzati e spese di storage

I metadati di log personalizzati vengono aggiunti durante l'inclusione in due posizioni per ottimizzare i costi di storage:

  • Al livello di richiesta
  • A livello di riga di log

Una richiesta è una raccolta di righe di log e la richiesta può includere una o più righe di log. Queste richieste possono includere un batch di linee di log incluse, quindi possono verificarsi chiamate successive per includere ulteriori linee di log. Una richiesta può anche avere una quantità diversa di righe di log, a seconda di come i clienti inviano i dati. Ai clienti viene addebitato un solo addebito per i metadati a livello di richiesta. Poiché in una richiesta vengono incluse righe di log aggiuntive, a questo livello non vengono addebitati costi aggiuntivi. I metadati della richiesta si applicano a tutte le righe di log di una richiesta a livello di richiesta, invece di aggiungere ulteriori metadati a ogni riga di log, il che consente di risparmiare sui costi di storage.

Di seguito sono riportati alcuni esempi di metadati a livello di richiesta.

{
"oracle":{
"compartmentid":"ocid1.compartment.oc1..<unique_id>",
"ingestedtime":"2022-05-23T18:00:04.073Z",
"loggroupid":"ocid1.loggroup.oc1.iad.<unique_id>",
"logid":"ocid1.log.oc1.iad.<unique_id>",
"tenantid":"ocid1.tenancy.oc1..<unique_id>"
},
"source":"<customer_data>",
"specversion":"1.0",
"subject":"<customer_data>",
"type":"<customer_data>"
}

La dimensione minima dei metadati della richiesta è di 500 byte, ma la quantità può variare a seconda della dimensione dei dati del cliente nei campi source, subject e type. La dimensione totale dei metadati può variare a seconda dei dati specifici del cliente in questi campi.

A livello di linea di log, che contiene il payload di log effettivo, per ogni riga di log vengono aggiunti i metadati 100 byte riportati di seguito.

{
"data":{
<log payload>
},
"id":"fb1f6b06-4ed5-4133-a1d0-ad2ffc3addc6",
"time":"2022-05-23T11:54:30.532Z",
}

I valori id e time sono obbligatori e indicano l'evento di log corrispondente, insieme all'ora di creazione.

Ad esempio, se i dati vuoti nei campi source, subject e type, se l'agente di monitoraggio unificato di Oracle Cloud Infrastructure Logging ha ricevuto una richiesta con 100 righe di log, in cui ogni riga di log aveva una dimensione di 1 KB, la dimensione totale dei metadati aggiunti è di circa 10,5 KB per il seguente calcolo:
  • Livello di richiesta: 500 byte
  • Livello riga di log: 100 (numero di righe di log in una richiesta) * 100 byte (ogni metadati della riga di log) = 10 KB

La quantità totale di righe di log inviate in questo esempio di richiesta è 100 * 1 KB = 100 KB. Dopo l'aggiunta dei metadati, la dimensione di storage di log risultante è di 110,5 KB.