Panoramica formato log
Dettagli per il formato Oracle Cloud Infrastructure Logging di livello superiore.
- Busta unificata
- Metadati specifici di Oracle (oracle.*)
- Contenuto della riga di log (dati)
Formato busta esterna
Tutti i messaggi inviati al front-end di inclusione utilizzano il formato esterno dell'envelope e modificano solo il corpo del messaggio in base al tipo di log. Il formato dell'envelope esterno è conforme alla specifica CloudEvents v1.0, con campi di estensione definiti a scopo di log. Nella tabella seguente viene descritto questo formato.
| Nome | Richiesto | Posizione | Digitare | descrizione; |
|---|---|---|---|---|
| Versione specifica | Sì | Corpo: specversion | Stringa | Versione della specifica CloudEvents a cui è conforme questo messaggio. |
| ID | Sì | Corpo: ID | Stringa | Un identificativo unico di origine per questo messaggio. I messaggi duplicati possono avere lo stesso ID. I consumatori possono presumere che gli eventi con gli stessi ID siano univoci. |
| Digitare | Sì | Corpo: tipo | Stringa | Il tipo del messaggio. I consumatori utilizzano type e specversion per determinare come interpretare il corpo. Modello: com.oraclecloud.{service}.{resource-type}.{category}. Ad esempio: com.oraclecloud.compute.instance.terminated |
| Origine | Sì | Corpo: fonte | URI-riferimento |
L'origine del messaggio. Quando viene emesso da un servizio, si riferisce al nome della risorsa che ha generato il messaggio, ad esempio il nome del bucket di storage degli oggetti, Nome istanza. Se emesso da un agente, in base all'origine/input utilizzato per leggere gli eventi. Ad esempio, il nome dell'istanza (non l'OCID) o il nome host dell'asset in un ambiente in locale. |
| Oggetto | No | Corpo: oggetto | Stringa |
Una risorsa secondaria specifica che ha generato l'evento, se applicabile all'origine. Ciò è utile per le origini con risorse secondarie. Esempi:
|
| Tempo | No | Corpo: tempo | Indicatore orario | Ora di generazione del messaggio. Se presente, deve aderire al formato specificato in RFC 3339. Se non viene fornito, viene utilizzato l'orologio da parete dell'host di inclusione che riceve la richiesta. |
| Schema dati | No | Corpo: dataschema | Stringa | La versione dello schema per il campo data. Questo non è richiesto e, se non fornito, si presume che sia la versione iniziale. |
| Tipo di contenuto dati | No | Corpo: tipo di dati | Stringa | Formato in cui è codificato il corpo del messaggio. Se non specificato, l'impostazione predefinita è JSON (equivalente a datacontenttype: application/json). |
| Corpo messaggio | Sì | Corpo: dati | Object | Corpo del messaggio codificato nel formato definito da datacontenttype. Se datacontenttype non è specificato, dovrebbe essere JSON (equivalente a datacontenttype: application/json). |
| Metadati di Oracle Cloud | Sì | Corpo: oracle | Object | Più metadati specifici di Oracle vengono forniti in una mappa di attributi al livello superiore dell'envelope. È conforme alla specifica CloudEvents v1 Attribute Extensions. Per gli attributi di metadati supportati di Oracle Cloud Infrastructure, vedere la tabella riportata di seguito. |
Attributi metadati Oracle
I seguenti attributi sono supportati nel campo di estensione oci del formato messaggio. La denominazione di questi attributi è conforme alla CloudEvents v1 Convenzione di denominazione degli attributi, ovvero si tratta di identificatori alfanumerici minuscoli con una lunghezza inferiore a 20 caratteri.
| Nome | Obbligatorio per inclusione | Arricchito per il recupero | Digitare | descrizione; |
|---|---|---|---|---|
| logid | Sì | - | Stringa | OCID dell'oggetto log a cui è stato inviato il messaggio. |
| loggroupid | No | Sì | Stringa | L'OCID del gruppo di log in cui risiede l'oggetto. |
| tenantid | No | Sì | Stringa | OCID del tenant proprietario dell'oggetto log. |
| compartmentid | No | Sì | Stringa | OCID del compartimento in cui risiedeva l'oggetto di log al momento dell'inclusione del messaggio. |