Includi log personalizzati dal servizio di log OCI utilizzando il connettore servizio

Se si dispone di log personalizzati nel servizio OCI Logging che si desidera includere in Oracle Log Analytics ai fini degli approfondimenti di analitica e log, completare i passi elencati qui.

Per ulteriori informazioni sull'inclusione dei log da altri servizi OCI utilizzando il connettore del servizio, vedere Inserisci log da altri servizi OCI utilizzando il connettore servizio.

Passi per raccogliere i log personalizzati formano il servizio OCI Logging utilizzando il connettore del servizio:

1. Fornire l'autorizzazione per accedere e raccogliere i log dal servizio OCI Logging. Vedere Consenti raccolta di log dal servizio di log OCI.

2. Identificare o creare il compartimento e il gruppo di log di Log Analytics in cui devono essere raccolti i log.

3. Nel record di log nel servizio di log OCI, prendere nota del tipo di evento corrispondente alla chiave type, ad esempio com.oraclecloud.logging.custom.kube_system_namespace. Il valore della chiave verrà utilizzato in un secondo momento per creare l'origine log. Di seguito è riportato un esempio di record di log del servizio OCI Logging.

   {
     "datetime": 1652152576897,
     "logContent": {
       "data": {
         "message": "2022-05-10T03:16:16.161346406+00:00 stderr F time=\"2022-05-10T03:16:16Z\" level=error msg=\"tkw network request proxied\" error=EOF",
         "tailed_path": "/var/log/pods/kube-system_proxymux-client-aaaa/proxymux-client/0.log"
       },
       "id": "id112233",
       "oracle": {
         "compartmentid": "ocid1.compartment.oc1..a....",
         "ingestedtime": "2022-05-10T03:17:25.628Z",
         "instanceid": "ocid1.instance.oc1.phx.a....",
         "loggroupid": "ocid1.loggroup.oc1.phx.a....",
         "logid": "ocid1.log.oc1.phx.a....",
         "tenantid": "ocid1.tenancy.oc1..a...."
       },
       "source": "oke-source",
       "specversion": "1.0",
       "subject": "/var/log/pods/kube-system_proxymux-client-aaaa/proxymux-client/0.log",
       "time": "2022-05-10T03:16:16.897Z",
       "type": "com.oraclecloud.logging.custom.kube_system_namespace"
     }
   }

   Nell'esempio precedente del tipo di evento, com.oraclecloud.logging.custom. è costante per i log personalizzati. La parte rimanente del valore, ad esempio kube_system_namespace, varia a seconda del tipo di log.

4. Creare un parser JSON per analizzare i log personalizzati.

   Nota
   
   Assicurarsi che il parser sia di tipo JSON per includere i log dal connettore del servizio. Altri formati di parser non sono supportati.

   Per il contenuto del log di esempio mostrato sopra, Log Analytics riceve solo il valore dell'attributo logContent, come mostrato di seguito:

   {
       "data": {
         "message": "2022-05-10T03:16:16.161346406+00:00 stderr F time=\"2022-05-10T03:16:16Z\" level=error msg=\"tkw network request proxied\" error=EOF",
         "tailed_path": "/var/log/pods/kube-system_proxymux-client-aaaa/proxymux-client/0.log"
       },
       "id": "id112233",
       "oracle": {
         "compartmentid": "ocid1.compartment.oc1..a....",
         "ingestedtime": "2022-05-10T03:17:25.628Z",
         "instanceid": "ocid1.instance.oc1.phx.a....",
         "loggroupid": "ocid1.loggroup.oc1.phx.a....",
         "logid": "ocid1.log.oc1.phx.a....",
         "tenantid": "ocid1.tenancy.oc1..a...."
       },
       "source": "oke-source",
       "specversion": "1.0",
       "subject": "/var/log/pods/kube-system_proxymux-client-aaaa/proxymux-client/0.log",
       "time": "2022-05-10T03:16:16.897Z",
       "type": "com.oraclecloud.logging.custom.kube_system_namespace"
     }

   Pertanto, il parser JSON deve essere creato utilizzando una versione ridotta del contenuto del log di esempio. Vedere Creare un parser.

5. Creare un'origine log con il nome uguale al valore della chiave type. Se il valore indicato in precedenza è com.oraclecloud.logging.custom.kube_system_namespace, anche il nome origine deve essere lo stesso. Durante la creazione dell'origine log, specificare il parser creato nel passo precedente. Vedere Crea un'origine.

   Se non si crea un'origine definita dall'utente il cui nome corrisponde al valore della chiave tipo nei log, i log vengono elaborati utilizzando i log schema unificato OCI di origine definiti da Oracle. This source uses the Oracle-defined parser OCI Unified Schema Log Format to parse the fields Time, Type, OCI Resource Name, Collection Time, Compartment ID, Logging Log Group OCID, Logging Log OCID, Tenant, Logging Record ID, CloudEvents Spec Version, and Message.

6. Creare un nuovo connettore servizio o utilizzare un connettore servizio esistente che stabilisce una connessione tra OCI Logging e Oracle Log Analytics per instradare i log personalizzati. Specificare Logging Analytics come destinazione e aggiungere una nuova connessione di origine corrispondente ai log personalizzati di log. Prendere nota del compartimento del gruppo di log di log, del gruppo di log di log e dei dettagli dei log personalizzati di log.

   Per i passi dettagliati per creare il connettore di servizio, vedere passo 2 in Impostazione del connettore di servizio per l'inclusione dei log.

   Nella sezione Configura task è possibile impostare un task di filtro dei log e specificare la proprietà da utilizzare per l'applicazione di filtri. Consulta la Documentazione di Oracle Cloud Infrastructure - Manage Service Connectors.

   In caso di più log personalizzati, è possibile utilizzare lo stesso connettore di servizio e aggiungere altri task di filtro di log.

Una volta stabilita la connessione con OCI Logging, i log personalizzati inizieranno a fluire in Oracle Log Analytics. Per cercare i log personalizzati in Esplora log, è possibile eseguire una query sul nome dell'origine log. Ad esempio:

'Log Source' = com.oraclecloud.logging.custom.kube_system_namespace | stats count as logrecords by 'Log Source'

Per interrompere la raccolta dei log personalizzati da OCI Logging, vedere Interrompi raccolta dei log dal connettore servizio.