Includi log da altri servizi OCI mediante connettore servizio

In base al tipo di log del servizio che si desidera includere, è necessario creare criteri per consentire a Oracle Log Analytics di ottenere le informazioni sulle risorse e creare un'entità per ogni risorsa.

Dopo aver creato il criterio, l'entità creata verrà associata automaticamente a tutti i log raccolti da tale risorsa. Se il criterio non viene creato, i log vengono comunque inclusi ma l'entità non viene creata.

Le autorizzazioni seguenti consentono di caricare i log in Oracle Log Analytics dal connettore del servizio. Viene richiesto di aggiungere queste istruzioni dei criteri quando si crea il connettore del servizio tramite OCI Console. In alternativa, è possibile creare manualmente il criterio che include le istruzioni dei criteri seguenti:

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <userGroup> to MANAGE serviceconnectors in tenancy
allow group <userGroup> to READ logging-family in tenancy

Nelle suddette istruzioni,

• Log_Group_Compartment_OCID: l'OCID del compartimento del gruppo di log in Oracle Log Analytics in cui devono essere memorizzati i log.

• Log_Group_OCID: l'OCID del gruppo di log in Oracle Log Analytics in cui devono essere memorizzati i log.

• Service_Connector_Compartment_OCID: OCID compartimento dell'hub connettore servizio.

Oracle Log Analytics crea un'entità che rappresenta la risorsa OCI di base quando vengono ricevuti nuovi log tramite il connettore del servizio. Per ottenere le informazioni necessarie dalla risorsa OCI, è necessario fornire a Oracle Log Analytics un accesso minimo di read alla risorsa OCI. Ad esempio, per leggere le informazioni su un bucket nello storage degli oggetti, puoi scrivere uno dei criteri seguenti:

Dichiarazione dei criteri con READ PRIVILEGE della risorsa OCI:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to {BUCKET_READ} in compartment <specify_compartment>

O

Istruzione criterio con il verbo read per OCI RESOURCE:

allow resource loganalyticsvrp LogAnalyticsVirtualResource to read buckets in compartment <specify_compartment>

Le istruzioni dei criteri riportate sopra limitano l'accesso read a un compartimento. Per estendere l'accesso all'intera tenancy, è possibile modificare l'istruzione dei criteri di conseguenza.

Le risorse OCI riportate di seguito sono supportate in Oracle Log Analytics per la raccolta dei log tramite il connettore del servizio. È possibile creare il criterio utilizzando il verbo di lettura per la risorsa OCI o utilizzare il privilegio di lettura per la risorsa come illustrato sopra.

Prima di impostare il connettore del servizio per includere i log, assicurarsi che il compartimento e il gruppo di log siano identificati per i log che si desidera includere.

Nell'esempio riportato di seguito, i passi mostrano come raccogliere i log del servizio VCN dal servizio Oracle Cloud Infrastructure Logging.

1. Questo è un passaggio suggestivo per mostrarti come abilitare i log nel servizio Oracle Cloud Infrastructure Logging.

   Vai al servizio Oracle Cloud Infrastructure Log e vai a Log.

   Fare clic su Abilita log risorse per abilitare i log del servizio VCN. Viene aperta la finestra di dialogo.

   1. Selezionare il compartimento risorsa.
   2. Selezionare il servizio, ad esempio Virtual Cloud Network (subnets).
   3. Selezionare la risorsa, ad esempio la risorsa VCN.
   4. In Configura log selezionare la categoria di log, ad esempio Flow Logs, e il nome del log.
   5. In Posizione log selezionare il compartimento e il gruppo di log da cui Oracle Log Analytics farà riferimento ai log.

   Fare clic su Abilita log.

2. Impostare il connettore del servizio specificando il servizio di origine dei log e la destinazione come Oracle Log Analytics. Puoi impostarlo dal servizio di origine integrato con Oracle Cloud Infrastructure Service Connector Hub, ad esempio il servizio Oracle Cloud Infrastructure Logging, o direttamente da Oracle Cloud Infrastructure Service Connector Hub.

   Andare al servizio Oracle Cloud Infrastructure Log, andare a Service Connectors e fare clic su Crea connettore.

   In alternativa, andare al servizio Oracle Cloud Infrastructure Service Connector Hub e fare clic su Crea connettore servizio.

   Viene visualizzata la pagina Crea connettore servizio.

   1. Immettere un nome per il connettore e fornire una descrizione.
   2. Selezionare il compartimento risorsa in cui deve essere creata la risorsa connettore.
   3. In Configura connettore servizio specificare Logging come servizio Origine e Logging Analytics come servizio Destinazione.
   4. In Configura connessione di origine, fornire i dettagli dei log da raccogliere dal servizio, ad esempio i log del servizio VCN.

      Selezionare il nome del compartimento, il gruppo di log a cui appartengono i log e il nome dei log configurati nel passo 1.

   È possibile configurare lo stesso connettore di servizio per raccogliere più log. Fare clic su Altro log e ripetere il passo 2-d.

   Facoltativamente, è possibile creare filtri in Configura task.

   Fare clic su Crea connettore.

Dopo aver creato il connettore del servizio, è possibile verificare che i log selezionati siano disponibili in Oracle Log Analytics.

Lascia che Source_Tenant sia il tenant del servizio di origine, ad esempio Oracle Cloud Infrastructure Logging, da cui vengono raccolti i log. Lascia che Target_Tenant sia il tenant in cui viene creato il connettore del servizio. Il connettore del servizio viene configurato con Oracle Log Analytics come destinazione per i log raccolti dal servizio di origine. Si presuppone che l'hub connettore servizio e Oracle Log Analytics siano disponibili sullo stesso tenant di destinazione.

Impostare i criteri riportati di seguito per configurare la raccolta di log da una tenancy diversa dalla tenancy in cui viene creato il connettore del servizio.

define tenancy <Target_Tenant> as <Target_Tenant_OCID>
define group <Common_User_Group> as <Common_User_Group_OCID>
admit any-user of tenancy <Target_Tenant> to read logging-family IN TENANCY WHERE ALL {request.principal.type = 'serviceconnector'}
admit group <Common_User_Group> of tenancy <Target_Tenant> to read logging-family IN TENANCY

admit group <Common_User_Group> of tenancy <Target_Tenant> to read audit-events in TENANCY
admit any-user of tenancy <Target_Tenant> to read audit-events IN tenancy WHERE ALL {request.principal.type = 'serviceconnector'}

define tenancy <Source_Tenant> as <Source_Tenant_OCID>
endorse any-user to read logging-family IN tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}
endorse group <Common_User_Group> to read logging-family IN tenancy <Source_Tenant>

endorse group <Common_User_Group> to read audit-events in tenancy <Source_Tenant>
endorse any-user to read audit-events in tenancy <Source_Tenant> WHERE ALL {request.principal.type = 'serviceconnector'}

allow any-user to {LOG_ANALYTICS_LOG_GROUP_UPLOAD_LOGS} in compartment id <Log_Group_Compartment_OCID> where all {request.principal.type = 'serviceconnector', target.loganalytics-log-group.id = '<Log_Group_OCID>', request.principal.compartment.id = '<Service_Connector_Compartment_OCID>'}
allow group <Common_User_Group> to MANAGE serviceconnectors in tenancy

oci --profile <Target_Profile> sch service-connector create 
    --display-name XTenancyConnector 
    --compartment-id <Connector_Compartment_OCID> 
    --source '{ "kind": "logging", "logSources": 
        [ { "compartmentId": "<Logging_LogGroup_Compartment_OCID>", 
            "logGroupId": "<Logging_LogGroup_OCID>" } ] }' 
    --target '{ "kind": "loggingAnalytics", "logGroupId": "<LogAnalytics_LogGroup_OCID>" }'

Se è stato impostato un connettore servizio per raccogliere continuamente i log da OCI Logging a Oracle Log Analytics, è possibile arrestare la raccolta di log disattivando il connettore o eliminandolo.

Se è necessario arrestare temporaneamente la raccolta di log ma conservare la configurazione del connettore in modo da poter riavviare la raccolta di log in un secondo momento, Disattivare il connettore.

Se si desidera arrestare definitivamente la raccolta di log dal connettore del servizio, eliminare il connettore.

1. Identificare il connettore servizio impostato per la raccolta dei log: passare al servizio Hub connettore ed elencare i connettori nel compartimento. Vedere Elenca connettori.

   Fare clic sul nome del connettore per visualizzare i dettagli e la configurazione del connettore. Identificare il connettore di servizio corretto impostato per la raccolta di log.

2. Arresta raccolta log: a seconda delle esigenze, fare clic su Disattiva o su Elimina. Vedere Disattivazione di un Connettore e Eliminazione di un Connettore.

   In questo modo si arresta il flusso di dati dal servizio OCI specifico a Oracle Log Analytics.

Se il connettore è stato disattivato e si desidera riavviare la raccolta log, riattivarlo. Vedere Attivazione di un connettore.