Inclusion de journaux personnalisés à partir du service OCI Streaming à l'aide d'un connecteur de service
Si vous souhaitez analyser et dériver des informations à partir de vos données de diffusion en continu personnalisées volumineuses dans le service OCI Streaming à l'aide d'Oracle Log Analytics, procédez comme suit pour ingérer les journaux de diffusion en continu.
Etapes de collecte des journaux personnalisés à partir d'OCI Streaming à l'aide du connecteur de service :
-
Donnez le droit d'accéder aux journaux et de les collecter à partir du service OCI Streaming. Reportez-vous à Autoriser la collecte de journaux à partir du service OCI Streaming.
-
Identifiez ou créez le compartiment et le groupe de journaux Log Analytics dans lesquels les journaux doivent être collectés.
-
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
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 être au format unique, Regex, 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.
-
-
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 choisir parmi les sources de journal définies par Oracle disponibles. Reportez-vous à Sources définies par l'Oracle.
-
Créez un connecteur de service pour établir une connexion entre OCI Streaming et Oracle Log Analytics afin d'acheminer vos journaux personnalisés. Indiquez
Logging Analytics
comme cible et ajoutez une nouvelle source correspondant à vos journaux personnalisés Streaming.Pour obtenir des é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 Log Analytics.
Pour arrêter la collecte de vos journaux personnalisés à partir d'OCI Streaming, suivez les étapes similaires à Arrêter la collecte de journaux à partir du connecteur de service. Toutefois, le connecteur de service indiqué dans les étapes doit être celui que vous avez créé avec OCI Streaming en tant que source et Oracle Log Analytics en tant que destination des journaux.
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 Log Analytics.
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
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.
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 dans OCI Streaming. -
Service_Connector_Compartment_OCID
: OCID de compartiment du connecteur du service.