Surveillance d' Oracle Real Application Clusters
Une fois l'agent hôte d' Instana s installé, le capteur RAC (Real Application Clusters) d' Oracle est automatiquement installé, mais vous devez configurer ce capteur RAC d' Oracle comme indiqué dans la section « Configuration ». Vous pouvez ensuite consulter les indicateurs liés à RAC ( Oracle ) dans l'interface utilisateur d' Instana.
Informations complémentaires
Systèmes d'exploitation pris en charge
Le capteur RAC d' Oracle prend en charge le système d'exploitation sur tous les hôtes sur lesquels l'agent d' Instana est exécuté. Vous pouvez consulter la section « Systèmes d'exploitation pris en charge » de chaque agent hôte, par exemple « Systèmes d'exploitation pris en charge pour Unix ».
Versions prises en charge
Voir les versions prises en charge suivantes pour les métriques et les données de configuration:
- Oracle Database 19c
- Oracle Database 21c
Seule la surveillance à distance est prise en charge pour le détecteur Oracle RAC.
À la découverte de l' Oracle RAC
Utilisez l'option de configuration à distance pour détecter et surveiller les bases de données RAC d' Oracle qui s'exécutent sur des hôtes sur lesquels l'agent Instana ne peut pas être installé.
Configuration
Octroi de droits d'accès aux bases de données
Pour connecter le détecteur à Oracle RAC et surveiller les métriques et la configuration, vous devez disposer du droit read pour les tables suivantes:
#Create a role
create ROLE INSTANAROLE;
#Note: For Oracle Container Database (CDB), common roles must follow the naming convention C##<role_name>
#Example for CDB: create ROLE C##INSTANAROLE;#Grant privileges to this role for following tables and views
GV_$SESSION, GV_$BGPROCESS, GV_$ACTIVE_SESSION_HISTORY, GV_$SYSSTAT, GV_$SGASTAT, GV_$LIBRARYCACHE, GV_$LATCH, GV_$ROWCACHE, GV_$RESOURCE_LIMIT, GV_$STATNAME, GV_$SESSTAT, GV_$PROCESS, GV_$SQLAREA, GV_$PARAMETER, GV_$SQL, V_$VERSION, GV_$SYS_TIME_MODEL, GV_$SYSTEM_WAIT_CLASS, GV_$INSTANCE, GV_$LOCK, DBA_HIST_SQLTEXT, DBA_HIST_SQLSTAT, DBA_HIST_SNAPSHOT,DBA_HIST_ACTIVE_SESS_HISTORY, DBA_USERS, DBA_OBJECTS, DBA_TABLESPACE_USAGE_METRICS, DBA_DATA_FILES, DBA_TEMP_FILES
eg. GRANT SELECT ON GV_$SESSION to INSTANAROLE;
#Assign this role to a user. Configure the same user in the configuration yaml file. For more information, see the [sensor configuration](#sensor-configuration) section.
GRANT INSTANAROLE to <user>;
#The following tables/views require the Oracle Diagnostic Pack license.
V$ACTIVE_SESSION_HISTORY, DBA_HIST_SNAPSHOT, DBA_HIST_SQLSTAT, DBA_HIST_SQLTEXT, DBA_HIST_ACTIVE_SESS_HISTORY
Configuration du capteur RAC d' Oracle
Pour surveiller RAC d' Oracle, vous devez indiquer à l'agent hôte les informations d'identification nécessaires pour accéder aux données de surveillance, via le fichier de configuration de l'agent :
Activation de la surveillance RAC d' Oracle
Pour activer la surveillance d' Oracle RAC, vous devez définir l'indicateur enableRacMonitoring sur true.
com.instana.plugin.oracledb:
remote: # we support listing multiple Oracle RACs here!
- host: '<ORCL_HOST>' # SCAN_HOSTNAME or SCAN_IP'
port: '<ORCL_PORT>'
user: '<ORCL_USER>' # default is 'sys as sysdba'
password: '<ORCL_PASSWORD>'
databaseServiceName: '<ORCL_DB_SERVICE_NAME>' # for Oracle RAC, SID is not required only ServiceName
availabilityZone: 'Oracle-RAC-AZ' # default is 'Oracle-RAC-AZ
poll_rate: 1
enableRacMonitoring: true # default is false. For Oracle RAC set this to true.
enableUniqueIdentifier: false # Default is false. Set to true only if you are monitoring multiple databases with identical SID/service names. Keep false for standard configurations
Le taux d'interrogation définit la fréquence à laquelle le détecteur interroge les métriques Oracle RAC, en secondes. The default is 1 second.
Sur la mappe d'infrastructure, l'instance Oracle RAC distante apparaît sous la forme d'une zone distincte avec le nom spécifié dans la clé availabilityZone du fichier configuration.yaml . Pour localiser l'instance, saisissez entity.type:oracleDB dans la barre de recherche de Dynamic Focus d' Instana.
Configuration d'une interrogation personnalisée
Le tableau suivant affiche les métriques pour lesquelles vous pouvez configurer un maximum de trois taux d'interrogation personnalisés différents de zéro. Les mesures dont le taux d'interrogation est égal ou inférieur à zéro sont désactivées par défaut. Pour désactiver une métrique, supprimez l'entrée correspondante du fichier de configuration *instanaAgentDir*/etc/instana/configuration.yaml.
| Nom | Description |
|---|---|
| REQUISES_TIME_TOP_ELAPSE_ | Liste des premières requêtes de temps écoulé. |
| SQL_ID_CONSOMME_PLUS_DE_CPU | Liste des instructions SQL qui consomment plus d'UC. |
| SESSIONS_AVANT_UTILISATEUR | Affiche les sessions d'avant-plan actives. |
| TOP_10_SQL_HIGH_IO_LAST_1_HR | Liste des dix premières instructions SQL avec des entrées-sorties élevées au cours de la dernière heure. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». |
| SESSION TOP_TEN_CPU_CONSUMING_SESSION | Liste des sessions qui consomment le plus d'UC. |
| TOP_CPU_CONSUMING_SESSION_LAST_10_MIN | Liste des principales unités centrales qui consomment des sessions au cours des 10 dernières minutes. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». |
| SESSIONS_BLOCAGE_EN_COURS | Permet d'afficher des informations sur les sessions de blocage. |
| RATIO cache_bibliothèque_hit_ratio | Ce rapport indique le nombre de demandes d'épinglage qui génèrent des hits d'épinglage. |
| ACTIVE_SESSIONS_RUNNING_MORE_THAN_600_SECS | Toutes les sessions actives qui s'exécutent pendant plus de 10 minutes dans la base de données Oracle . |
| HISTORAL_SESSION_ACTIVE | Activité de session échantillonnée dans la base de données. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». |
| TOP_10_SQL_HIGH_IO_LAST_24_HR | Liste des dix premières instructions SQL avec des entrées-sorties élevées au cours des dernières 24 heures. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». |
| TOP_CPU_QUERIES_LAST_24_HRS | Liste des principales requêtes consommant de l'UC au cours des dernières 24 heures. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». |
| QUERIES_N'UTILISANT_PAS_DE_VARIABLES_DE_LIEN | Liste des requêtes qui n'utilisent pas la variable bind dans le code. |
Important : pour les autres indicateurs RAC d' Oracle s (répertoriés dans le tableau des indicateurs de performances ), Instana utilise une fréquence d'interrogation par défaut de 1‑second. Ce taux ne peut être configuré qu'au niveau du groupe. Vous pouvez augmenter la fréquence d'interrogation pour l'ensemble du groupe de métriques « 1‑second », mais vous ne pouvez pas définir une fréquence différente pour chaque métrique individuelle au sein de ce groupe.
Voir la configuration suivante pour l'interrogation personnalisée:
com.instana.plugin.oracledb:
remote: # Instana supports listing of multiple Oracle RACs.
- host: '<ORCL_HOST>' # SCAN_HOSTNAME or SCAN_IP'
port: '<ORCL_PORT>'
user: '<ORCL_USER>' # default is 'sys as sysdba'
password: '<ORCL_PASSWORD>'
databaseServiceName: '<ORCL_DB_SERVICE_NAME>' # for Oracle RAC, SID is not required, requires only ServiceName
availabilityZone: 'Oracle-RAC-AZ' # default is 'Oracle-RAC-AZ
poll_rate: 1
enableRacMonitoring: true
enableUniqueIdentifier: false # Default is false. Set to true only if you are monitoring multiple databases with identical SID/service names. Keep false for standard configurations
customPolling:
- poll_rate: 30
metrics:
- TOP_CPU_CONSUMING_SESSION_LAST_10_MIN
- ACTIVE_SESSIONS_RUNNING_MORE_THAN_600_SECS
- LIBRARY_CACHE_HIT_RATIO
- CURRENT_BLOCKING_SESSIONS
- poll_rate: 60
metrics:
- TOP_ELAPSED_TIME_QUERIES
- TOP_TEN_CPU_CONSUMING_SESSION
- SQL_ID_CONSUMING_MORE_CPU
- USER_FOREGROUND_SESSIONS
- TOP_10_SQL_HIGH_IO_LAST_1_HR
- ACTIVE_SESSION_HISTORY
- poll_rate: 3600
metrics:
- TOP_10_SQL_HIGH_IO_LAST_24_HR
- TOP_CPU_QUERIES_LAST_24_HRS
- QUERIES_NOT_USING_BINDING_VARIABLES
Affichage des mesures
Pour afficher les métriques, procédez comme suit:
- Sélectionnez « Infrastructure » dans la barre latérale de l'interface utilisateur d' Instana.
- Cliquez sur un hôte surveillé spécifique. Vous pouvez voir un tableau de bord hôte avec toutes les métriques collectées et les processus surveillés.
Le détecteur Oracle surveille et collecte les données suivantes:
Données de configuration
Le détecteur Oracle collecte les données de configuration suivantes:
| Élément de configuration | Description |
|---|---|
| Version | Oracle numéro de version de la base de données |
| SID | Identifiant système (SID) : nom unique de l'instance de base de données d' Oracle |
| Noms de service | Noms de services réseau utilisés pour se connecter à la base de données |
| Heure de début | Horodatage du démarrage de l'instance de base de données |
| Nombre d'UC | Nombre de processeurs disponibles pour l'instance de base de données |
| Nbre max. de sessions | Nombre maximal de sessions simultanées autorisées |
| Taille de blocs de base de données | Taille des blocs de la base de données |
| Port | TCP numéro de port sur lequel le listener de la base de données Oracle accepte les connexions (par défaut : 1521) |
| Nombre d'instances | Nombre d'instances actives dans le cluster RAC d' Oracle |
Métriques de performance
| Métrique | Description | Granularité |
|---|---|---|
| Nombre de processus en cours d'exécution | Nombre de processus en cours d'exécution. | 1 seconde |
| Utilisation limite des processus | Utilisation de la ressource de processus. Le processus est affiché en pourcentage. | 1 seconde |
| Sessions actives (plus de 10 minutes) | Toutes les sessions actives dans la base de données Oracle pendant plus de 10 minutes. | 30 secondes |
| Utilisation maximale du processus | Consommation maximale du processus après le démarrage de la dernière instance. | 1 seconde |
| Utilisation en cours du processus | Nombre de processus utilisés. | 1 seconde |
| Traiter l'allocation initiale | Allocation initiale du processus. Cette allocation est égale à la valeur indiquée pour le processus dans le fichier de paramètres d'initialisation. | 1 seconde |
| Valeur de limite de processus | Valeur de limite maximale d'un processus. La valeur du processus doit rester dans cette limite. | 1 seconde |
| Utilisation limite des processus | Pourcentage de tous les processus en cours par rapport à la limite définie. | 1 seconde |
| DB Time per Second | Temps écoulé consacré à l'exécution des appels de niveau utilisateur de la base de données. | 1 seconde |
| DB CPU Time | Temps UC consacré à l'exécution des appels de niveau utilisateur de la base de données. | 1 seconde |
| SQL Execute Time | Temps écoulé pendant lequel les instructions de requête SQL sont exécutées. | 1 seconde |
| Parse Time | Temps écoulé consacré à l'analyse syntaxique des instructions de requête SQL. Il inclut à la fois le temps d'analyse souple et le temps d'analyse difficile. | 1 seconde |
| Taux de temps UC de la base de données | Quantité d'UC utilisée dans la base de données par la durée totale de la base de données. | 1 seconde |
| Temps d'attente par seconde | Temps d'attente par seconde pour les entrées-sorties utilisateur, les autres, les entrées-sorties système, les accès concurrents, le planificateur, l'application, la validation, la configuration, l'administration, le réseau et la mise en file d'attente. | 1 seconde |
| Taux de réussite en mémoire cache de la bibliothèque (réussites d'épinglage) | Ce rapport indique le nombre de demandes d'épinglage qui génèrent des hits d'épinglage. | 30 secondes |
| Mémoire totale SGA | Mémoire totale dans la zone globale du système (SGA) en Mo. | 1 seconde |
| Mémoire utilisée SGA | Mémoire utilisée par la zone SGA en Mo. | 1 seconde |
| Mémoire disponible SGA | Mémoire disponible dans la zone SGA en Mo. | 1 seconde |
| Nom du pool SGA | Nom de pool de la zone globale du système (SGA). | 1 seconde |
| Mémoire totale du pool SGA | Mémoire totale dans le pool de la zone SGA en Mo. | 1 seconde |
| Mémoire utilisée du pool SGA | Mémoire utilisée dans le pool de la zone SGA en Mo. | 1 seconde |
| Nombre d'exécutions SQL | Nombre total de requêtes SQL exécutées. | 1 seconde |
| Temps moyen d'exécution SQL | Temps d'exécution SQL moyen. | 1 seconde |
| Nombre d'analyses syntaxiques SQL | Nombre d'analyses en dur et total. | 1 seconde |
| Taux d'analyse syntaxique SQL | Rapport des exécutions SQL effectuées avec une analyse syntaxique souple et sans analyse syntaxique. | 1 seconde |
| Appels utilisateur | Nombre d'appels, de validations et d'annulations. | 1 seconde |
| Taux de réussite en mémoire cache | Pourcentage de pages trouvées dans le cache de la mémoire tampon sans avoir à lire à partir du disque. | 1 seconde |
| Lectures de sessions physiques et logiques | Nombre de lectures physiques et logiques. | 1 seconde |
| Sessions | Nombre de sessions utilisateur (actives et inactives) et nombre de sessions d'arrière-plan. | 1 seconde |
| Utilisation des espaces table | Utilisation de l'espace table (permanent, temporaire et annulation) en Go, utilisation de l'espace table en pourcentage, taille maximale de l'espace table et indicateur auto-extensible. | 1 seconde |
| Instances RAC actives | Nombre d'instances actives dans un RAC. Cet indicateur n'est pas disponible dans le tableau de bord intégré. Vous pouvez toutefois créer un tableau de bord personnalisé ou configurer des événements ou des alertes en utilisant cet indicateur pour déclencher des notifications lorsque le nombre d'instances actives passe en dessous d'un seuil défini. | 1 seconde |
| Premières requêtes d'UC (dernières 24 heures) | Liste des principales requêtes d'UC au cours des dernières 24 heures avec le temps UC en millisecondes, le nombre de lectures de disque et la durée totale pendant laquelle la requête est exécutée. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». | 1 heure |
| Requêtes n'utilisant pas de variable de liaison | Liste des requêtes qui n'utilisent pas la variable bind dans le code avec le nombre de copies de requête, le nombre d'exécutions de requête et la mémoire totale consommée par les requêtes SQL en Mo. | 1 heure |
| Premières requêtes de temps écoulé | Liste des principales requêtes de temps écoulé avec ID SQL, requête SQL et temps d'exécution en minutes. | 60 secondes |
| Historique des sessions actives (dernière heure) | Activité de session échantillonnée dans la base de données au cours de la dernière heure avec l'ID SQL, le pourcentage de charge et le nombre de sessions. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». | 60 secondes |
| Dix premières sessions de consommation d'UC | Liste des dix premières sessions consommatrices d'UC avec ID de session, numéro de série, temps UC en minutes et nom de programme du système d'exploitation. | 60 secondes |
| Premières sessions de consommation d'UC (10 dernières minutes) | Liste des sessions les plus consommatrices d'UC au cours des 10 dernières minutes avec l'ID de session, le numéro de série et la durée totale pendant laquelle la requête est exécutée. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». | 30 secondes |
| Dix premières instructions SQL avec E-S élevées (1 dernière erreur) | Liste des dix premières requêtes SQL avec des entrées-sorties élevées au cours de la dernière heure avec un ID SQL, un nom d'utilisateur et un temps d'attente total en millisecondes. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». | 60 secondes |
| Sessions bloquantes en cours | Informations sur les sessions de blocage. | 30 secondes |
| Sessions d'avant-plan | Sessions d'avant-plan actives. | 60 secondes |
| SQL consommant plus d'UC | Liste des requêtes SQL qui utilisent plus d'UC. | 60 secondes |
| Dix premières instructions SQL avec 24 dernières heures d'E-S élevées | Liste des dix premières requêtes SQL avec des entrées-sorties élevées au cours des dernières 24 heures. Cet indicateur nécessite la licence du pack de diagnostic « Oracle » pour les vues spécifiées dans la section «Octroi des autorisations de base de données ». | 1 heure |
Signatures d'intégrité
Pour chaque capteur, une base de connaissances organisée de signatures de santé est évaluée en continu par rapport aux métriques entrantes et est utilisée pour signaler des problèmes ou des incidents qui ont un impact sur l'utilisateur.
Les événements intégrés déclenchent des problèmes ou des incidents en fonction de signatures de santé défaillantes sur des entités, tandis que les événements personnalisés déclenchent des problèmes ou des incidents en fonction des seuils d'une métrique spécifique à une entité donnée. Pour plus d'informations sur les événements intégrés du capteur « OracleDB », consultez la référence des événements intégrés.