Inclusion de journaux à partir d'autres services OCI à l'aide du connecteur de service

En fonction du type des journaux de service à inclure, vous devez créer des stratégies permettant à Oracle Log Analytics d'obtenir les informations sur les ressources et d'en créer une entité pour chaque ressource.

Une fois la stratégie créée, l'entité créée est automatiquement associée à tous les journaux collectés à partir de cette ressource. Si la stratégie n'est pas créée, les journaux restent inclus, mais l'entité n'est pas créée.

Les droits d'accès suivants permettent de télécharger des journaux vers Oracle Log Analytics à partir du connecteur de service. Vous êtes invité à ajouter ces instructions de stratégie lorsque vous créez le connecteur de service via la console OCI. Vous pouvez également créer manuellement la stratégie qui inclut les instructions de stratégie suivantes :

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

Dans les instructions de stratégie ci-dessus,

• Log_Group_Compartment_OCID : OCID de compartiment du groupe des journaux dans Oracle Log Analytics dans lequel les journaux doivent être stockés.

• Log_Group_OCID : OCID du groupe des journaux dans Oracle Log Analytics dans lequel les journaux doivent être stockés.

• Service_Connector_Compartment_OCID : OCID de compartiment du hub de connecteur de service.

Oracle Log Analytics crée une entité représentant la ressource OCI sous-jacente lorsque de nouveaux journaux sont reçus via le connecteur de service. Pour obtenir les informations nécessaires à partir de la ressource OCI, vous devez fournir à Oracle Log Analytics un accès minimal de read à la ressource OCI. Par exemple, pour lire des informations sur un bucket dans Object Storage, vous pouvez écrire l'une des stratégies suivantes :

Instruction de stratégie avec la ressource OCI READ PRIVILEGE :

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

OU

Instruction de stratégie avec le verbe de lecture pour OCI RESOURCE :

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

Les instructions de stratégie ci-dessus limitent l'accès read à un compartiment. Pour étendre l'accès à l'ensemble de la location, vous pouvez modifier l'instruction de stratégie en conséquence.

Les ressources OCI suivantes sont prises en charge dans Oracle Log Analytics pour la collecte de journaux via le connecteur de service. Vous pouvez créer la stratégie à l'aide du verbe de lecture pour la ressource OCI ou utiliser le privilège de lecture pour la ressource comme illustré ci-dessus.

Avant de configurer le connecteur de service pour l'inclusion des journaux, assurez-vous que le compartiment et le groupe de journaux sont identifiés pour les journaux à inclure.

Dans l'exemple suivant, la procédure explique comment collecter les journaux de service de réseau cloud virtuel à partir du service Oracle Cloud Infrastructure Logging :

1. Il s'agit d'une suggestion d'étape pour vous montrer comment activer les journaux dans le service Oracle Cloud Infrastructure Logging.

   Ouvrez le service Oracle Cloud Infrastructure Logging et accédez à Journaux.

   Cliquez sur Activer le journal de ressource pour activer les journaux de service de réseau cloud virtuel. La boîte de dialogue apparaît.

   1. Sélectionnez le compartiment de ressource.
   2. Sélectionnez le service, par exemple, Virtual Cloud Network (subnets).
   3. Sélectionnez la ressource, par exemple la ressource de réseau cloud virtuel.
   4. Sous Configurer le journal, sélectionnez la catégorie du journal, par exemple Flow Logs, et le nom du journal.
   5. Sous Emplacement du journal, sélectionnez le compartiment et l'ensemble de journaux servant de références à Oracle Log Analytics pour les journaux.

   Cliquez sur Activer le journal.

2. Configurez le connecteur du service en indiquant le service source des journaux, et la cible en tant que cible Oracle Log Analytics. Vous pouvez le configurer à partir du service source intégré à Oracle Cloud Infrastructure Service Connector Hub, par exemple le service Oracle Cloud Infrastructure Logging, ou directement à partir d'Oracle Cloud Infrastructure Service Connector Hub.

   Ouvrez le service Oracle Cloud Infrastructure Logging, accédez à Connecteur de service et cliquez sur Créer un connecteur.

   Sinon, accédez au service Oracle Cloud Infrastructure Service Connector Hub, puis cliquez sur Créer un connecteur de service.

   La page Créer un connecteur de service apparaît.

   1. Entrez le nom du connecteur et une description.
   2. Sélectionnez le compartiment de ressource dans lequel la ressource de connecteur doit être créée.
   3. Sous Configurer un connecteur de service, indiquez Logging en tant que service source et Logging Analytics en tant que service cible.
   4. Sous Configurer une connexion source, indiquez les détails des journaux à collecter à partir du service, par exemple les journaux de service de réseau cloud virtuel.

      Sélectionnez le nom du compartiment, le groupe de journaux auquel les journaux appartiennent et le nom des journaux configurés à l'étape 1.

   Vous pouvez configurer le même connecteur de service pour collecter davantage de journaux. Cliquez sur Autre journal et répétez l'étape 2-d.

   Vous pouvez éventuellement créer des filtres sous Configurer une tâche.

   Cliquez sur Créer un connecteur.

Une fois le connecteur de service créé, vous pouvez vérifier que les journaux sélectionnés sont disponibles dans Oracle Log Analytics.

Source_Tenant est le locataire du service source, tel qu'Oracle Cloud Infrastructure Logging, à partir duquel les journaux sont collectés. Target_Tenant est le locataire dans lequel le connecteur de service est créé. Le connecteur de service est configuré avec Oracle Log Analytics comme cible pour les journaux collectés à partir du service source. Nous partons du principe que le concentrateur de connecteurs de service et Oracle Log Analytics sont disponibles sur le même locataire cible.

Définissez les stratégies suivantes pour configurer la collecte de journal à partir d'une location différente de la location dans laquelle le connecteur du service est créé.

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>" }'

Si vous avez configuré un connecteur de service pour collecter en continu les journaux d'OCI Logging vers Oracle Log Analytics, vous pouvez arrêter la collecte de journaux en désactivant le connecteur ou en le supprimant.

Si vous devez arrêter temporairement la collection de journaux tout en conservant la configuration du connecteur afin de pouvoir redémarrer la collection de journaux ultérieurement, Désactivez le connecteur.

Si vous souhaitez arrêter définitivement la collection de journaux à partir du connecteur de service, supprimez le connecteur.

1. Identifier le connecteur de service configuré pour la collecte de journaux : accédez au service Connector Hub et répertoriez les connecteurs de votre compartiment. Reportez-vous à Liste des connecteurs.

   Cliquez sur le nom du connecteur pour afficher les détails et la configuration du connecteur. Identifiez le connecteur de service approprié configuré pour votre collection de journaux.

2. Arrêter la collecte de journaux : selon vos besoins, cliquez sur Désactiver ou sur Supprimer. Reportez-vous à Désactivation d'un connecteur et Suppression d'un connecteur.

   Cela arrête le flux de données du service OCI spécifique vers Oracle Log Analytics.

Si vous avez désactivé le connecteur et que vous souhaitez redémarrer la collecte de journaux, réactivez ce connecteur. Reportez-vous à Activation d'un connecteur.