Ingérer des journaux personnalisés à partir du service de diffusion en continu pour OCI à l'aide du connecteur de service

Si vous voulez analyser et dériver des données clés à partir de vos données de diffusion en continu personnalisées à volume élevé dans le service de diffusion en continu pour OCI à l'aide d'Oracle Log Analytics, effectuez les étapes suivantes pour ingérer les journaux de diffusion en continu.

Étapes de collecte des journaux personnalisés à partir du service de diffusion en continu pour OCI à l'aide du connecteur de service :

  1. Fournissez une autorisation pour accéder aux journaux du service de diffusion en continu pour OCI et les collecter. Voir Autoriser la collecte des journaux à partir du service de diffusion en continu pour OCI.

  2. Identifiez ou créez le compartiment et le groupe de journaux Log Analytics où les journaux doivent être collectés.

  3. Créez un analyseur pour analyser vos journaux personnalisés. Utilisez l'exemple de contenu de journal de vos données de diffusion en continu pour identifier les champs. Voir Créer un analyseur.

    Note

    Log Analytics prend en charge les analyseurs des formats Regex, XML et JSON. Vérifiez les points suivants :

    • Les données de journal d'un flux doivent avoir un seul format, Expression rationnelle, XML ou JSON et ne pas avoir plusieurs formats.

    • L'analyseur identifié pour un flux doit avoir le même format que les données de journal de ce flux.

  4. Créez une source de journaux qui convient le mieux à vos journaux personnalisés et incluez l'analyseur que vous avez créé à l'étape précédente. Voir Créer une source.

    Vous pouvez également effectuer une sélection à partir des sources de journaux définies par Oracle disponibles. Voir Source définie par Oracle.

  5. Créez un connecteur de service pour établir une connexion entre le service de diffusion en continu pour OCI et Oracle Log Analytics afin d'acheminer vos journaux personnalisés. Spécifiez Logging Analytics comme cible et ajoutez une nouvelle source correspondant à vos journaux personnalisés de diffusion en continu.

    Pour des étapes détaillées pour créer le connecteur de service à l'aide de la console, de l'API ou de l'interface de ligne de commande, voir Documentation sur le centre de connecteurs de service OCI.

Une fois la connexion établie avec le service de diffusion en continu pour OCI, les journaux personnalisés commencent à circuler dans Oracle Log Analytics.

Pour arrêter la collecte des journaux personnalisés à partir du service de diffusion en continu pour OCI, suivez des étapes similaires à Arrêter la collecte des journaux à partir du connecteur de service. Toutefois, le connecteur de service référencé dans les étapes doit être celui que vous avez créé avec le service de diffusion en continu pour OCI en tant que source et Oracle Log Analytics en tant que destination des journaux.

Autoriser la collecte des journaux à partir du service de diffusion en continu pour OCI

Créez des politiques pour permettre aux utilisateurs de collecter les journaux à partir du service de diffusion en continu pour OCI et de les ingérer dans Oracle Log Analytics.

Les autorisations suivantes permettent de charger des journaux dans Oracle Log Analytics à partir du connecteur de service. Vous êtes invité à ajouter ces énoncés de politique lorsque vous créez le connecteur de service au moyen de la console OCI. Vous pouvez également créer manuellement la politique qui inclut les énoncés suivants :

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

Dans les énoncés de politique ci-dessus,

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

  • Log_Group_OCID : OCID du groupe de journaux dans Oracle Log Analytics où les journaux doivent être stockés.

  • Service_Connector_Compartment_OCID : OCID du compartiment du centre de connecteurs de service.

Les autorisations suivantes permettent de collecter des journaux à partir du service de diffusion en continu pour OCI. Vous êtes invité à ajouter ces énoncés de politique lorsque vous créez le connecteur de service au moyen de la console OCI. Vous pouvez également créer manuellement la politique qui inclut les énoncés suivants :

allow any-user to {STREAM_READ, STREAM_CONSUME} in compartment id <Source_Stream_Compartment_OCID> where all {request.principal.type='serviceconnector', target.stream.id='<Stream_OCID>', request.principal.compartment.id='<Service_Connector_Compartment_OCID>'}

Dans les énoncés de politique ci-dessus,

  • Source_Stream_Compartment_OCID : OCID du compartiment des données de flux dans le service de diffusion en continu pour OCI.

  • Stream_OCID : OCID du flux dans le service de diffusion en continu pour OCI.

  • Service_Connector_Compartment_OCID : OCID du compartiment du connecteur de service.