Documentation Oracle Cloud Infrastructure

Inclusion de journaux personnalisés à partir du service OCI Streaming à l'aide d'un connecteur de service

Si vous voulez analyser et obtenir des informations à partir de vos données de transmission en continu personnalisées volumineuses dans le service OCI Streaming à l'aide d'Oracle Logging Analytics, procédez comme suit pour ingérer les journaux de transmission en continu.

Etapes de collecte de journaux personnalisés à partir d'OCI Streaming à l'aide du connecteur de service :

  1. Autorisez l'accès aux journaux et leur collecte à partir du service OCI Streaming. Reportez-vous à Autoriser la collecte de journaux à partir du service OCI Streaming.

  2. Identifiez ou créez le compartiment et le groupe de journaux Logging Analytics dans lesquels 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 transmission en continu pour identifier les champs. Reportez-vous à Création d'un analyseur.

    Remarque

    Logging Analytics prend en charge les analyseurs des formats Expression régulière, XML et JSON. Vérifiez les points suivants :

    • Les données de journal d'un flux de données doivent être au format unique, Expression régulière, XML ou JSON et ne doivent 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 journal qui convient le mieux à vos journaux personnalisés et incluez l'analyseur que vous avez créé à l'étape précédente. Reportez-vous à Création d'une source.

    Vous pouvez également effectuer une sélection parmi les sources de journal définies par Oracle disponibles. Reportez-vous à Sources définies par Oracle.

  5. Créez un connecteur de service pour établir une connexion entre OCI Streaming et Oracle Logging Analytics afin d'acheminer vos journaux personnalisés. Indiquez la cible en tant qu'analyse de journalisation et ajoutez une nouvelle source correspondant à vos journaux personnalisés de diffusion en continu.

    Pour obtenir les étapes détaillées de création du connecteur de service à l'aide de la console, de l'API ou de l'interface de ligne de commande, reportez-vous à Documentation OCI Service Connector Hub.

Une fois la connexion établie avec OCI Streaming, les journaux personnalisés commencent à circuler dans Oracle Logging Analytics.

Autoriser la collecte de journaux à partir du service OCI Streaming

Créez des stratégies pour permettre aux utilisateurs de collecter les journaux à partir d'OCI Streaming et de les inclure dans Oracle Logging Analytics.

Les droits d'accès suivants permettent de télécharger des journaux vers Oracle Logging 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

Dans les instructions de stratégie ci-dessus,

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

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

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

Les droits d'accès suivants permettent de collecter des journaux à partir du service OCI Streaming. 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 {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 instructions de stratégie ci-dessus,

  • Source_Stream_Compartment_OCID : OCID de compartiment des données de flux dans OCI Streaming.

  • Stream_OCID : OCID du flux de données dans OCI Streaming.

  • Service_Connector_Compartment_OCID : OCID de compartiment du connecteur de service.