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. Ciò è conforme alla specifica CloudEvents v1 Attribute Extensions. Vedere la tabella riportata di seguito per gli attributi dei metadati di Oracle Cloud Infrastructure supportati. |
Attributi metadati Oracle
I seguenti attributi sono supportati nel campo dell'estensione oci del formato messaggio. La denominazione di questi attributi è conforme alla CloudEvents v1 Attribute Naming Convention, ovvero si tratta di identificativi alfanumerici minuscoli lunghi meno di 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. |