Avant de commencer

Ce tutoriel de 20 minutes vous explique comment configurer l'environnement dans Logging Analytics pour collecter des données à partir des tables ou des vues d'Oracle Autonomous Database. Logging Analytics collecte les données des tables ou des vues en se connectant à la base de données et en exécutant la requête SQL que vous fournissez.

Contexte

Suivez les étapes décrites dans ce tutoriel pour collecter des données à partir des tables ou des vues de votre entité de base de données autonome, telles que la création de la source de journal, la création d'une entité de base de données autonome, le téléchargement des fichiers de portefeuille, l'inscription des informations d'identification, l'inscription des informations de portefeuille et enfin l'association de la source de journal à l'entité de base de données autonome pour commencer à collecter les journaux.

De quoi avez-vous besoin ?

  • Configurez des stratégies de service pour Oracle Cloud Logging Analytics. Reportez-vous à Activation de l'accès à Logging Analytics et à ses ressources et à Stratégies IAM requises dans la documentation Oracle Cloud Infrastructure.
  • Créez les stratégies IAM pour configurer la collecte de journaux continue. Reportez-vous à Autoriser la collecte continue de journaux à l'aide des agents de gestion dans la documentation Oracle Cloud Infrastructure.
  • Utilisez un groupe de journaux existant ou créez au moins un groupe de journaux pour stocker les journaux que vous collectez à partir de votre base de données autonome. Reportez-vous à Création de groupes de journaux pour stocker vos journaux dans la documentation Oracle Cloud Infrastructure.
  • Familiarisez-vous avec les instructions de requête SQL pour écrire les requêtes SQL permettant d'extraire les données de journal. Reportez-vous à Instructions relatives aux requêtes SQL dans la documentation Oracle Cloud Infrastructure.
  • Assurez-vous que vous avez accès aux compartiments dans lesquels vos bases de données autonomes résident dans Oracle Cloud Infrastructure.
  • Vous pouvez éventuellement configurer le tableau de bord de gestion pour créer et utiliser des tableaux de bord, qui sont des outils de visualisation des données fournissant un aperçu rapide de l'état et des performances de votre infrastructure informatique et de vos applications, et aidant à identifier les valeurs aberrantes et à effectuer des actions correctives. Reportez-vous à Configuration du tableau de bord de gestion dans la documentation Oracle Cloud Infrastructure.
  • Pour que l'agent de gestion collecte les journaux à partir de l'entité de base de données autonome, vous devez fournir les informations d'identification permettant d'accéder à la base de données autonome. Pour en savoir plus sur les informations d'identification qui doivent être inscrites auprès de l'agent de gestion, reportez-vous à Informations d'identification de source d'agent de gestion : DBTCPSCreds dans la documentation Oracle Cloud Infrastructure.
  • Vous devrez fournir le nom de service lors de la création de l'entité de base de données autonome. Pour plus d'informations sur les noms de service prédéfinis pour les bases de données autonomes, reportez-vous à Noms de service de base de données prédéfinis pour Autonomous Database dans la documentation Oracle Database.
  • Installez les agents de gestion sur n'importe quel hôte pouvant disposer d'une connectivité JDBC à ATP-S ou ADW-W. Pour connaître les étapes d'établissement de la connectivité JDBC avec ATP et ADW, reportez-vous à Connectivité Java avec Autonomous Database (ATP ou ADW) à l'aide de 19c et de JDBC 18.3.

    Déployez le module d'extension Logging Analytics lors de l'installation de l'agent. Veillez également à effectuer les prérequis pour le déploiement des agents de gestion. Reportez-vous à Présentation de Management Agent dans la documentation Oracle Cloud Infrastructure.

    Dans le cadre du processus d'installation, vous devez créer un fichier de réponses dans lequel vous devez inclure la ligne suivante concernant l'activation du module d'extension Logging Analytics :

    Service.plugin.logan.download=true

    Si vous voulez activer le module d'extension d'agent de gestion dans l'agent Oracle Cloud, assurez-vous que la taille de portion de mémoire de la JVM est d'au moins 512 Mo.

Téléchargement des fichiers de portefeuille

L'agent de gestion requiert un fichier de clés Java (JKS) ou des portefeuilles Oracle pour se connecter à ATP ou ADW. La connectivité de l'agent de gestion à une instance Oracle Autonomous Database nécessite l'utilisation de portefeuilles Oracle. Assurez-vous que l'utilisateur de l'agent dispose d'un accès en lecture aux fichiers de portefeuille.

Sur les hôtes basés sur Unix, l'utilisateur de l'agent qui installe l'agent de gestion est mgmt_agent pour l'agent de gestion autonome installé manuellement et oracle-cloud-agent lorsque l'agent de gestion est un module d'extension activé avec l'agent Oracle Cloud.

  1. Connectez-vous à Oracle Cloud avec vos informations d'identification cloud > Accédez à la page d'accueil de votre base de données autonome.

  2. Cliquez sur l'onglet Connexion de base de données, puis téléchargez le fichier ZIP de portefeuille wallet_<dbname>.zip.

  3. Décompressez le fichier ZIP dans un répertoire en toute sécurité afin que seuls les utilisateurs autorisés y aient accès. Le contenu du fichier ZIP est décrit ci-dessous :

    • tnsnames.ora et sqlnet.ora : fichiers de configuration réseau stockant les scripts de connexion et la configuration côté client SQL*Net.
    • cwallet.ora et ewallet.p12 : portefeuille SSO auto-ouvert et fichier PKCS12. Le fichier PKCS12 est protégé par le mot de passe de portefeuille fourni dans l'interface utilisateur.
    • keystore.jks et truststore.jks : truststore et fichier de clés JKS protégés par le passeport de portefeuille fourni lors du téléchargement du portefeuille.
    • ojdbc.properties : contient la propriété de connexion liée au portefeuille requise pour la connexion JDBC. Ce fichier doit se trouver au même emplacement que tnsnames.ora.

Les noms de service prédéfinis sont disponibles dans le fichier tnsnames.ora que vous avez téléchargé. La valeur de la propriété est au format dbName_predefinedServiceName.

Création de l'entité Autonomous Database

Créez l'entité de base de données autonome pour référencer votre instance de base de données et activer la collecte de journal à partir de celle-ci.

  1. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Logging Analytics, cliquez sur Administration. La page Présentation de l'administration apparaît.

    Les ressources d'administration sont répertoriées dans le panneau de navigation de gauche sous Resources. Cliquez sur Entités.

    La page Entités s'ouvre. Assurez-vous que le sélecteur de compartiment sur la gauche indique que vous vous trouvez dans le compartiment souhaité pour cette nouvelle entité. Cliquez sur Créer.

  2. Sous le menu Type d'entité, sélectionnez Autonomous Transaction Processing ou Autonomous Data Warehouse.
    Créer une entité de base de données autonome
    Description de l'illustration Create_Entity.png

    Indiquez un nom pour l'entité et notez-le pour référence ultérieure. Vous en aurez besoin pour inscrire les détails de la base de données auprès de l'agent de gestion.

  3. Sélectionnez le compartiment de l'agent de gestion dans lequel l'agent est installé.
  4. Dans le menu Agent de gestion, sélectionnez l'agent de gestion installé sur l'hôte qui dispose d'une connectivité JDBC à ATP-S ou ADW-W.
  5. Dans la section ID de ressource cloud, indiquez éventuellement l'OCID de votre instance de base de données autonome.
  6. Sous Propriétés, indiquez la valeur de la propriété service_name.

    Les noms de service prédéfinis sont disponibles dans le fichier tnsnames.ora que vous avez téléchargé à l'étape précédente. La valeur de la propriété est au format dbName_predefinedServiceName.

  7. Cliquez sur Créer.

Inscription des informations d'identification de base de données et des détails de portefeuille auprès de l'agent de gestion

Pour que l'agent de gestion collecte les journaux à partir de l'entité de base de données autonome, vous devez fournir les informations d'identification permettant d'accéder à la base de données autonome. Procédez comme suit pour ajouter les informations d'identification ou mettre à jour les informations d'identification existantes. Inscrivez également les détails du portefeuille auprès de l'agent.

  1. Collectez les informations suivantes à propos de la base de données :
    • Database_Entity_Name : nom d'entité indiqué précédemment lors de la création de l'entité ATP/ADW.
    • Database_User_Name : nom utilisateur de base de données
    • Database_Password : mot de passe de base de données
    • Rôle de l'utilisateur de base de données (facultatif)
  2. Collectez les informations suivantes sur les fichiers de portefeuille :
    • SSL_Truststore_Location : emplacement de truststore SSL
    • SSL_Truststore_Password : mot de passe du truststore SSL
    • SSL_Keystore_Location : emplacement du fichier de clés SSL
    • SSL_Keystore_Password : mot de passe du fichier de clés SSL
  3. Créez un fichier JSON avec les informations de votre base de données : 
     { "source": "lacollector.la_database_sql", "name": "LCAgentDBCreds.<Database_Entity_Name>", "type": "DBTCPSCreds", "usage": "LOGANALYTICS", "disabled": "false", "properties":[ {"name":"DBUserName","value":"<Database_User_Name>"}, {"name":"DBPassword","value":"<Database_Password>"}, {"name":"ssl_trustStoreType","value":"JKS"}, {"name":"ssl_trustStoreLocation","value":"<SSL_Truststore_Location>"}, {"name":"ssl_trustStorePassword","value":"<SSL_Truststore_Password>"}, {"name":"ssl_keyStoreType","value":"JKS"}, {"name":"ssl_keyStoreLocation","value":"<SSL_Keystore_Location>"}, {"name":"ssl_keyStorePassword","value":"<SSL_Keystore_Password>"}, {"name":"ssl_server_cert_dn","value":"yes"}] }

    Mettez à jour les champs ssl_trustStoreLocation et ssl_keyStoreLocation avec des chemins de fichier absolus incluant des noms de fichier. Exemple : 

    {"name": "ssl_trustStoreLocation", "value": "/usr/local/wallet/truststore.jks"}, {"name": "ssl_keyStoreLocation", "value": "/usr/local/wallet/keystore.jks"}

    Pour les chemins Windows, utilisez la barre oblique inverse \ et pour les chemins de type UNIX, utilisez la barre oblique / dans le JSON.

  4. Pour inscrire les informations d'identification de base de données et les détails du portefeuille auprès de l'agent de gestion, connectez-vous à l'hôte de l'agent de gestion et exécutez la commande suivante en indiquant le chemin du fichier JSON que vous avez créé à l'étape précédente :

    • Sur un hôte de type UNIX :

      cat <path_to_JSON_file> | sh /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s logan

      Exemple :

      cat /net/example.com/scratch/imp/my_atp/Wallet_ATP/my_logan_creds.json | sh /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s logan

      Remarques :

      Pour les agents de gestion exécutés sur des instances de calcul à l'aide du module d'extension d'agent Oracle Cloud, le script credential_mgmt.sh se trouve sous /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin.

    • Sur l'hôte Windows :

      type <path_to_JSON_file> | <path_to_credential_mgmt.bat> -o upsertCredentials -s logan

      Exemple :

      type C:\Oracle\my_logan_creds.json | C:\Oracle\mgmt_agent\agent_inst\bin\credential_mgmt.bat -o upsertCredentials -s logan

Octroi de privilèges à l'utilisateur de l'agent de gestion pour la lecture de fichiers de portefeuille

Assurez-vous que l'utilisateur de l'agent de gestion dispose des privilèges appropriés pour lire les fichiers de portefeuille. Fournissez les droits d'accès READ et EXECUTE au répertoire du portefeuille, ainsi que les droits d'accès READ aux fichiers de portefeuille. Par exemple, vous pouvez utiliser des commandes. Reportez-vous à Octroi de l'accès en lecture aux journaux à l'utilisateur d'agent sur l'hôte dans la documentation Logging Analytics.

Création d'une source pour le type d'entité Autonomous Database

  1. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Logging Analytics, cliquez sur Administration. La page Présentation de l'administration apparaît.

    Les ressources d'administration sont répertoriées dans le panneau de navigation de gauche sous Resources. Cliquez sur Sources.

    La page Sources apparaît. Cliquez sur Créer une source.

  2. Dans le champ Nom, saisissez le nom de la source.

    Ajoutez éventuellement une description.

  3. Dans la liste Type de source, sélectionnez Base de données.
  4. Sous le menu Type d'entité, sélectionnez Autonomous Transaction Processing ou Autonomous Data Warehouse.
    Créer une source de base de données autonome
    Description de l'illustration Create_Source.png
  5. Cliquez sur l'onglet Requêtes de base de données et indiquez les instructions SQL basées sur lesquelles Oracle Cloud Logging Analytics collecte les journaux de base de données autonome :
    • Entrez l'instruction SQL dans le champ Requête SQL.

      Vous pouvez exécuter les requêtes SQL en dehors de Logging Analytics pour vérifier d'abord les résultats.

    • Cliquez sur Configurer et mettez en correspondance les colonnes de table SQL avec les noms de champ qui seront affichés dans les enregistrements de journal réels.
    • Indiquez une colonne de séquence. La valeur de ce champ doit déterminer l'ordre des enregistrements insérés dans la table. Il doit s'agir d'une valeur incrémentielle unique.

    Remarques :

    • Le premier champ mis en correspondance avec le type de données Timestamp est utilisé comme horodatage de l'enregistrement de journal. Si aucun champ de ce type n'est présent, l'heure de collecte est utilisée comme heure de l'enregistrement de journal.
    • Lorsque les journaux sont collectés pour la première fois après la création de la source de journal (collecte des journaux historiques) :

      Si un champ de la requête SQL est mis en correspondance avec le champ Time , la valeur de ce champ est utilisée comme référence pour télécharger les enregistrements de journal des 30 derniers jours.

      Si aucun des champs de la requête SQL n'est mis en correspondance avec le champ Time, un maximum de 10 000 000 d'enregistrements est téléchargé.

    Cliquez ensuite sur Terminé.

    Pour ajouter plusieurs requêtes SQL, cliquez sur Ajouter et répétez cette étape.

  6. Sélectionnez Activé pour chacune des requêtes SQL, puis cliquez sur Enregistrer.

La page de liste des sources s'ouvre et affiche toutes les sources définies par Oracle et personnalisées, y compris celle que vous venez de créer.

Association de la source de journal à une entité Autonomous Database

  1. Dans la page de liste des sources, identifiez la source que vous avez créée à l'étape précédente. Cliquez sur le nom de la source. La page des détails de la source apparaît.
  2. Sur la gauche de la page de détails de la source, sous Portée de la ressource, sélectionnez le compartiment. Vous limitez ainsi les entités visibles en fonction du compartiment sélectionné.
  3. Sous Ressources, cliquez sur Entités non associées pour visualiser les entités pouvant être associées à cette source. Sélectionnez l'entité que vous avez créée précédemment pour l'associer à cette source et cliquez sur Ajouter une association.
    Associez une entité de base de données autonome et une source
    Description de l'image Associate_Source_Entity.png

    La boîte de dialogue Ajouter une association apparaît.

  4. Sélectionnez le compartiment contenant le groupe de journaux dans lequel les données de journal doivent être placées après leur collecte et leur indexation.
  5. Sélectionnez le groupe de journaux que vous avez créé précédemment lors de la configuration.
  6. Cliquez sur Soumettre.

L'entité sélectionnée est déplacée vers la section Entités associées dans laquelle le statut de l'association est affiché. En cas d'échec de la tâche d'association source-entité, cliquez sur Réessayer l'association.

Les instructions de collecte sont envoyées à l'agent qui surveille cette entité tel que défini précédemment et la collecte de journal démarre. Accédez à la section avertissements de collecte d'agent pour visualiser les avertissements de collecte de journal. La liste des avertissements correspond à toutes les entités associées à la source.

Si vous rencontrez des problèmes avec l'agent de gestion qui collecte les données, assurez-vous que le nom utilisateur que vous avez fourni dans la banque d'informations d'identification dispose d'un accès READ aux tables ou aux vues interrogées. Attendez quelques minutes pour visualiser les journaux dans l'explorateur de journaux. Une fois que l'agent a collecté les journaux historiques, seuls les journaux plus récents sont collectés.

En savoir plus

Les sections suivantes de la documentation Oracle Cloud Infrastructure sont disponibles :