Avant de commencer

Ce tutoriel de 20 minutes 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 l'interrogation SQL que vous fournissez.

Contexte

Effectuez 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 journaux, la création d'une entité de base de données autonome, le téléchargement des fichiers de portefeuille, l'enregistrement des données d'identification, l'enregistrement des informations sur le portefeuille et enfin l'association de la source de journaux à l'entité de base de données autonome pour commencer à collecter les journaux.

Ce dont vous avez besoin

  • Configurer des politiques de service pour Oracle Cloud Logging Analytics. Voir Activer l'accès à Logging Analytics et à ses ressources et Politiques IAM préalables dans la documentation sur Oracle Cloud Infrastructure.
  • Créez les politiques IAM pour configurer la collecte continue des journaux. Voir Autoriser la collecte continue des journaux à l'aide des agents de gestion dans la documentation sur Oracle Cloud Infrastructure.
  • Utiliser un groupe de journaux existant ou créer au moins un groupe de journaux pour stocker les journaux que vous collectez à partir de votre base de données autonome. Voir Créer des groupes de journaux pour stocker vos journaux dans la documentation sur Oracle Cloud Infrastructure.
  • Familiarisez-vous avec les instructions SQL Query Guidelines pour écrire les interrogations SQL permettant d'extraire les données de journal. Voir Directives relatives aux interrogations SQL dans la documentation sur Oracle Cloud Infrastructure.
  • Assurez-vous d'avoir accès aux compartiments dans lesquels résident vos bases de données autonomes dans Oracle Cloud Infrastructure.
  • Facultativement, vous pouvez configurer le tableau de bord de gestion pour créer et utiliser des tableaux de bord, qui sont des outils de visualisation de données qui fournissent un aperçu rapide de l'état et de la performance de votre infrastructure et de vos applications informatiques, et qui aident à identifier les valeurs anormales et à prendre des mesures correctives. Voir Configurer le tableau de bord de gestion dans la documentation sur Oracle Cloud Infrastructure.
  • Pour que l'agent de gestion collecte les journaux de l'entité de base de données autonome, vous devez fournir les données d'identification pour accéder à la base de données autonome. Pour en savoir plus sur les données d'identification qui doivent être enregistrées auprès de l'agent de gestion, voir Données d'identification sources de l'agent de gestion : DBTCPSCreds dans la documentation sur Oracle Cloud Infrastructure.
  • Vous devrez fournir le nom du 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, voir Noms de service de base de données prédéfinis pour Autonomous Database dans la documentation sur Oracle Database.
  • Installez des agents de gestion sur n'importe quel hôte pouvant avoir une connectivité JDBC à ATP-S ou ADW-W. Pour les étapes d'établissement de la connectivité JDBC avec ATP et ADW, voir Connectivité Java avec Autonomous Database (ATP ou ADW) à l'aide de 19c et JDBC 18.3.

    Déployer le plugiciel Logging Analytics lors de l'installation de l'agent. Assurez-vous également d'effectuer les préalables au déploiement des agents de gestion. Voir Agent de gestion : Présentation dans la documentation sur Oracle Cloud Infrastructure.

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

    Service.plugin.logan.download=true

    Si vous voulez activer le plugiciel d'agent de gestion dans Oracle Cloud Agent, assurez-vous que la taille du tas JVM est d'au moins 512 Mo.

Télécharger les fichiers du portefeuille

L'agent de gestion requiert JKS (Java Key Store) ou des portefeuilles Oracle pour se connecter à ATP ou ADW. La connectivité de l'agent de gestion à une base de données 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 plugiciel activé avec Oracle Cloud Agent.

  1. Connectez-vous à Oracle Cloud avec vos données d'identification pour le nuage > Naviguez jusqu'à la page d'accueil de votre base de données autonome.

  2. Cliquez sur l'onglet Connexion à la base de données > 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 : Les fichiers de configuration réseau stockent les descripteurs de connexion et la configuration côté client SQL*Net.
    • cwallet.ora et ewallet.p12 : portefeuille d'authentification unique à ouverture automatique et fichier PKCS12. Le fichier PKCS12 est protégé par le mot de passe du portefeuille fourni dans l'interface utilisateur.
    • keystore.jks et truststore.jks : Magasin de certificats SSL et magasin de clés JKS protégé par le passeport du 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. Elle doit se trouver dans le même chemin 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é a le format dbName_predefinedServiceName.

Créer 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 pour activer la collecte de journaux à partir de celle-ci.

  1. Ouvrez le menu de navigation et cliquez sur Observabilité et gestion. Sous Logging Analytics, cliquez sur Administration. La page Aperçu de l'administration s'ouvre.

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

    La page Entités s'ouvre. Assurez-vous que le sélecteur de compartiment à gauche indique que vous êtes 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 enregistrer les détails de la base de données auprès de l'agent de gestion.

  3. Sélectionnez 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 votre hôte qui dispose d'une connectivité JDBC à ATP-S ou ADW-W.
  5. Facultativement, dans la section ID ressource en nuage, fournissez l'OCID de votre instance de base de données autonome.
  6. Sous Propriétés, spécifiez 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é a le format dbName_predefinedServiceName.

  7. Cliquez sur Créer.

Enregistrer les données d'identification de base de données et les détails du portefeuille avec l'agent de gestion

Pour que l'agent de gestion collecte les journaux de l'entité de base de données autonome, vous devez fournir les données d'identification pour accéder à la base de données autonome. Utilisez les étapes suivantes pour ajouter les données d'identification ou mettre à jour les données d'identification existantes. Enregistrez également les détails du portefeuille auprès de l'agent.

  1. Collectez les informations suivantes sur la base de données :
    • Database_Entity_Name : Nom d'entité que vous avez spécifié précédemment lors de la création de l'entité ATP/ADW
    • Database_User_Name : Nom de l'utilisateur de la base de données
    • Database_Password : Mot de passe de la 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 du magasin de certificats SSL
    • SSL_Truststore_Password : Mot de passe du magasin de certificats SSL
    • SSL_Keystore_Location : Emplacement du magasin de clés SSL
    • SSL_Keystore_Password : Mot de passe du magasin 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. Par 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 \ et pour les chemins de type UNIX, utilisez la barre oblique / dans le fichier JSON.

  4. Pour enregistrer les données d'identification de la 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 spécifiant le chemin d'accès au 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

      Par 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

      Note :

      Pour les agents d'exécution sur des instances de calcul à l'aide du plugiciel Oracle Cloud Agent, le script credential_mgmt.sh se trouve dans /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

      Par exemple :

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

Privilèges permettant à l'utilisateur de l'agent de gestion de lire les fichiers du portefeuille

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

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

  1. Ouvrez le menu de navigation et cliquez sur Observabilité et gestion. Sous Logging Analytics, cliquez sur Administration. La page Aperçu de l'administration s'ouvre.

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

    La page Sources s'ouvre. Cliquez sur Créer une source.

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

    Au besoin, ajoutez 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 Interrogations de base de données et spécifiez les énoncés SQL basés sur lesquels Oracle Cloud Logging Analytics collecte les journaux de base de données autonome :
    • Entrez l'énoncé SQL dans le champ Interrogation SQL.

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

    • Cliquez sur Configurer et mappez les colonnes de la table SQL aux noms de champ qui seront affichés dans les enregistrements de journal réels.
    • Spécifiez une colonne de séquence. La valeur de ce champ doit déterminer la séquence des enregistrements insérés dans la table. Elle doit avoir une valeur incrémentielle unique.

    Note :

    • Le premier champ mappé avec un type de données Timestamp est utilisé comme horloge 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 du journal.
    • Lorsque les journaux sont collectés pour la première fois après la création de la source de journaux (collecte de journaux historique) :

      Si un champ de l'interrogation SQL est mappé au champ Time, la valeur de ce champ est utilisée comme référence pour charger les enregistrements de journal des 30 derniers jours.

      Si aucun des champs de l'interrogation SQL n'est mappé au champ Time, un maximum de 10 000 000 enregistrements sont chargés.

    Cliquez sur Terminé.

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

  6. Sélectionnez Activé pour chacune des interrogations 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.

Associer la source de journaux à l'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 s'affiche.
  2. À gauche de la page Détails de la source, sous Portée de la ressource, sélectionnez le compartiment. Vous limiterez les entités visibles en fonction du compartiment que vous avez sélectionné.
  3. Sous Ressources, cliquez sur Entités non associées pour voir 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.
    Entité et source de base de données autonome Assoca
    Description de l'illustration Associate_Source_Entity.png

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

  4. Sélectionnez le compartiment qui contient le groupe de journaux dans lequel les données de journal doivent être situé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 maintenant déplacée vers la section Entités associées où le statut de l'association est affiché. Si la tâche d'association source-entité a échoué, cliquez sur Réessayer une association.

Les instructions de collecte seront envoyées à l'agent qui surveille cette entité comme défini précédemment et la collecte de journaux commencera. Allez à la section avertissements de collecte d'agent pour voir les avertissements relatifs à la collecte de journaux. Notez que la liste des avertissements correspond à toutes les entités d'association pour cette source.

Si vous rencontrez des problèmes avec l'agent de gestion qui collecte les données, assurez-vous que le nom d'utilisateur fourni dans le magasin de données d'identification dispose de l'accès READ aux tables ou aux vues en cours d'interrogation. Attendez quelques minutes pour afficher les journaux dans l'explorateur de journaux. Une fois les journaux historiques collectés par l'agent, vous ne verrez plus que les nouveaux journaux collectés.

En savoir plus

Les sections suivantes de la documentation sur Oracle Cloud Infrastructure :