Notre Oracle intégration de base de données collecte par défaut des mesures de performances clés sur la base de données, les tablespaces et la mémoire. Vous pouvez personnaliser votre configuration pour collecter encore plus de métriques, vous offrant ainsi une caractérisation détaillée des performances de la base de données.
Lisez la suite pour installer l’intégration et voir quelles données nous collectons.
Compatibilité et exigences
Notre intégration est compatible avec Oracle base de données des versions 11.2 à 23.
Avant d’installer l’intégration, assurez-vous que vous répondez aux exigences suivantes :
- Distribution Linux compatible avec l'infrastructure, à l'exception des versions RHEL/CentOS/OEL inférieures à 7.
- Installez l'agent d'infrastructure.
- Oracle Instant Client sur la boîte de l'agent.
- Base de données Oracle avec
ORACLE_HOME
configuré dans le répertoire correct pour l'utilisateur racine. - Base de données utilisateur Oracle avec les privilèges CONNECT et SELECT sur les vues globales requises.
- Base de données Oracle avec un fichier
listener.ora
configuré pour monitorer à partir d'une connexion à distance. Par défaut, la base de données Oracle écoute uniquement localhost.
Important
L'architecture ARM64 n'est pas prise en charge.
Installer et activer
Pour installer l’intégration de la base de données Oracle :
Installez l'agent d'infrastructure et remplacez la variable
INTEGRATION_FILE_NAME
parnri-oracledb
.Changer de répertoire vers le dossier d'intégration :
bash$cd /etc/newrelic-infra/integrations.dCopiez l’exemple de fichier de configuration :
bash$sudo cp oracledb-config.yml.sample oracledb-config.ymlModifiez le fichier
oracledb-config.yml
comme décrit dans les paramètres de configuration.
Notes supplémentaires :
- Advanced: Il est également possible d'installer l'intégration à partir d'un fichier tarball. Cela vous donne un contrôle total sur le processus d'installation et de configuration.
- On-host integrations do not automatically update. Pour de meilleurs résultats, mettez régulièrement à jour le package d'intégration et l'agent d'infrastructure.
Ce document vous a-t-il aidé lors de votre installation ?
Configuration
Activation de votre serveur de base de données Oracle
Dans la base de données Oracle, exécutez les instructions suivantes pour créer un nouvel utilisateur et attribuer des privilèges utilisateur. USERNAME et les valeurs similaires spécifiques à l'utilisateur doivent être remplacées.
Choisissez le type de base de données dont vous disposez. Pour obtenir de l'aide concernant les questions de maintenance utilisateur, consultez la documentationOracle ou contactez votre administrateur de système ou de base de données.
Accordez
CONNECT
privilèges à l'utilisateur :GRANT CONNECT TO USERNAME;Accordez
SELECT
privilèges à l'utilisateur sur les vues globales suivantes :cdb_data_files
cdb_pdbs
cdb_users
gv_$sysmetric
gv_$pgastat
gv_$instance
gv_$filestat
gv_$parameter
sys.dba_data_files
gv_$session
gv_$sesstat
gv_$statname
gv_$rowcache
gv_$sga
gv_$sysstat
v_$database
gv_$librarycache
gv_$sqlarea
gv_$system_event
dba_tablespaces
gv_$session_wait
gv_$rollstat
v_$instance
Exécutez les instructions SQL suivantes ensemble dans un script ou individuellement :
GRANT SELECT ON cdb_data_files TO USERNAME;GRANT SELECT ON cdb_pdbs TO USERNAME;GRANT SELECT ON cdb_users TO USERNAME;GRANT SELECT ON gv_$sysmetric TO USERNAME;GRANT SELECT ON gv_$pgastat TO USERNAME;GRANT SELECT ON gv_$instance TO USERNAME;GRANT SELECT ON gv_$filestat TO USERNAME;GRANT SELECT ON gv_$parameter TO USERNAME;GRANT SELECT ON sys.dba_data_files TO USERNAME;GRANT SELECT ON DBA_TABLESPACES TO USERNAME;GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS TO USERNAME;GRANT SELECT ON gv_$session TO USERNAME;GRANT SELECT ON gv_$sesstat TO USERNAME;GRANT SELECT ON gv_$statname TO USERNAME;GRANT SELECT ON gv_$rowcache TO USERNAME;GRANT SELECT ON gv_$sga TO USERNAME;GRANT SELECT ON gv_$sysstat TO USERNAME;GRANT SELECT ON v_$database TO USERNAME;GRANT SELECT ON gv_$librarycache TO USERNAME;GRANT SELECT ON gv_$sqlarea TO USERNAME;GRANT SELECT ON gv_$system_event TO USERNAME;GRANT SELECT ON dba_tablespaces TO USERNAME;GRANT SELECT ON gv_$session_wait TO USERNAME;GRANT SELECT ON gv_$rollstat TO USERNAME;GRANT SELECT ON v_$instance TO USERNAME;
Pour collecter les métriques PDB, accordez les privilèges
gv$con_sysmetric
en exécutant :GRANT SELECT ON gv$con_sysmetric TO USERNAME;
Configurer l'intégration
Il existe plusieurs façons de configurer l'intégration, selon la manière dont elle a été installée :
- Si activé via Amazon ECS : voir les services de monitoring exécutés sur ECS.
- Si installé sur l'hôte : modifiez la configuration dans le fichier de configuration YAML de l'intégration,
oracledb-config.yml
.
La configuration au format YAML d'une intégration est l'endroit où vous pouvez placer les informations de connexion requises et configurer la manière dont les données sont collectées. Les options que vous modifiez dépendent de votre configuration et de vos préférences.
Le fichier configuration contient des paramètres communs applicables à toutes les intégrations telles que interval
, timeout
, inventory_source
. Pour tout savoir sur ces paramètres courants, reportez-vous à notre document Format de configuration .
Important
Si vous utilisez toujours nos anciens fichiers configuration/définition, veuillez vous référer à ce document pour obtenir de l'aide.
Les paramètres spécifiques liés à Oracle DB sont définis à l'aide de la section env
du fichier de configuration. Ces paramètres contrôlent la connexion à votre Oracle DB instance ainsi que d'autres paramètres et fonctionnalités de sécurité. La liste des paramètres valides est décrite dans la section suivante de ce document.
Paramètres de l'instance de base de données Oracle
L'intégration Oracle DB collecte à la fois les informations Métriques(M) et Inventaire(I). Dans le tableau, utilisez la colonne Applies To pour les paramètres disponibles pour chaque collection :
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Paramètre | Description | Défaut | S'applique à |
---|---|---|---|
SERVICE_NAME | Le nom du service pour l'instance Oracle. | N/A | MI |
HOSTNAME | nom d'hôte ou IP où Oracle DB est exécuté. | 127.0.0.1 | MI |
PORT | Port sur lequel Oracle DB écoute. | 1521 | MI |
USERNAME | Nom d'utilisateur pour accéder au serveur Oracle DB. | N/A | MI |
PASSWORD | Mot de passe pour l'utilisateur donné. | N/A | MI |
CONNECTION_STRING | Une chaîne de connexion complète telle que celles trouvées dans | N/A | MI |
ORACLE_HOME | Chemin vers lequel se trouve | N/A | MI |
TABLESPACES | Un éventail JSON d'espaces table à collecter. S'il est omis, il collecte tous les tablespaces. S'il est vide, il ignore la collecte des métriques de l'espace table. | [] | M |
IS_SYS_DBA | Indique si l'utilisateur authentifié dispose des autorisations SysDBA. | false | M |
IS_SYS_OPER | Indique si l'utilisateur authentifié dispose des autorisations SysOper. | false | M |
EXTENDED_METRICS | Indique s'il faut collecter des métriques étendues. Vérifiez quelles sont les métriques étendues dans le tableau ci-dessous | false | M |
SKIP_METRICS_GROUPS | Les métriques collectées sont regroupées en fonction de la requête utilisée pour obtenir les données. Ces groupes métriques sont répertoriés ici et peuvent être ignorés de la collection en ajoutant le nom du groupe à | [] | M |
DISABLE_CONNECTION_POOL | Désactiver le pool de connexions. À utiliser uniquement si l'intégration rencontre des erreurs lors de la tentative d'établissement de nouvelles connexions à Oracle DB. | false | M |
MAX_OPEN_CONNECTIONS | Nombre maximal de connexions simultanées ouvertes par l'intégration. | 5 | M |
SYS_METRICS_SOURCE | Définissez-le sur | '' | M |
CUSTOM_METRICS_QUERY | Une requête SQL pour collecter des métriques personnalisées. Voir l'exemple ci-dessous. | N/A | M |
CUSTOM_METRICS_CONFIG | configuration YAML avec une ou plusieurs requêtes SQL pour collecter des métriques personnalisées. Voir l'exemple ci-dessous. | false | M |
METRICS | Définissez sur | false | |
INVENTORY | Définissez sur | false |
Les valeurs de ces paramètres peuvent être définies de plusieurs manières :
- Ajoutez la valeur directement au fichier de configuration. C'est la manière la plus courante.
- Remplacez les valeurs des variables d’environnement en utilisant la notation
{{}}
. Cela nécessite l'agent d'infrastructure 1.14.0+. Pour en savoir plus, consultez la rubrique « Plus d'informations sur les variables d'environnement de transfert de l'agent d'infrastructure ». - Utilisez la gestion des secrets pour protéger les informations sensibles, telles que les mots de passe, afin qu'elles ne soient pas exposées en texte brut dans le fichier de configuration. Pour plus d'informations, voir gestion des secrets.
Libellés et attribut personnalisé
Vous pouvez également décorer vos métriques avec des étiquettes. Les étiquettes vous permettent d'ajouter un attribut de paire valeur clé à vos métriques afin que vous puissiez interroger, filtrer ou regrouper vos métriques.
Même si notre fichier de configuration d'exemple par défaut inclut des exemples d'étiquettes, ils sont facultatifs. Vous pouvez en supprimer, en modifier ou en ajouter de nouveaux.
labels: env: production role: load_balancer
Exemple de configuration
Rechercher et utiliser des données
Pour trouver vos données d'intégration dans New Relic, accédez à one.newrelic.com > All capabilities > Infrastructure > Third-party services et sélectionnez l'un des liens de la base de données d'intégration Oracle .
Les données de la base de données Oracle sont attachées aux types d'événements suivants :
OracleDatabaseSample
OracleTablespaceSample
Pour en savoir plus sur la recherche et l’utilisation de vos données, consultez Comprendre les données d’intégration.
données métriques
La base de données d'intégration Oracle collecte l'attribut de données métriques suivant. Chaque nom de métrique est préfixé par un indicateur de catégorie et un point, tel que disk.
ou memory.
.
base de données métriques
Ces attributs peuvent être trouvés en interrogeant le type d'événement OracleDatabaseSample
.
métrique | Description | Étendu |
---|---|---|
| Sessions parallèles actives. | |
| Sessions sérielles actives. | |
| Sessions actives moyennes. | |
| Points de contrôle par seconde. | |
| Utilisation du processeur en arrière-plan par seconde. | |
| Temps d'arrière-plan par seconde. | |
| Changements de bloc DB par seconde. | |
| Modifications du bloc DB par transaction. | |
| Modifications du bloc DB par appel utilisateur. | |
| Bloc DB obtenu par seconde. | |
| Le bloc DB est obtenu par transaction. | |
| Le bloc DB est obtenu par appel utilisateur. | |
| Divisions de nœuds de branche par seconde. | |
| Les nœuds de branche se divisent par transaction. | |
| Modifications de lecture cohérentes par seconde. | |
| Modifications de lecture cohérentes par transaction. | |
| Lectures cohérentes obtenues par seconde. | |
| Lecture cohérente obtenue par transaction. | |
| Rapport temps CPU. | |
| Utilisation du processeur par seconde. | |
| Utilisation du processeur par transaction. | |
| Blocs CR créés par seconde. | |
| Blocs CR créés par transaction. | |
| Enregistrements d'annulation CR appliqués par seconde. | |
| Les enregistrements CR annulés sont appliqués par transaction. | |
| Nombre de connexions actuelles. | |
| Nombre de curseurs actuellement ouverts. | |
| Curseur taux d'accès au cache ratio. | |
| Temps de base de données par seconde. | |
| Points de contrôle DBWR par seconde. | |
| Blocages de mise en file d'attente par seconde. | |
| Mettre en file d'attente les blocages par transaction. | |
| Mettre en file d'attente requests par seconde. | |
| Mettre en file d'attente requests par transaction. | |
| Délais d'attente de mise en file d'attente par seconde. | |
| Délais d'attente de mise en file d'attente par transaction. | |
| Attentes en file d'attente par seconde. | |
| La mise en file d'attente attend par transaction. | |
| Exécutions par seconde. | |
| Exécutions par transaction. | |
| Exécutions par appel utilisateur. | |
| Analyses d'index complètes par seconde. | |
| Analyses d'index complètes par transaction. | |
| Bloc GC CR reçu par seconde. | |
| Bloc GC CR reçu par transaction. | |
| Bloc actuel GC reçu par seconde. | |
| Bloc actuel GC reçu par transaction. | |
| Temps moyen d'obtention du CR du cache global. | |
| Temps moyen d'obtention actuel du cache global. | |
| Nombre d'analyses dures par seconde. | |
| Nombre d'analyses dures par transaction. | |
| Utilisation du processeur de l'hôte par seconde. | |
| Utilisation du processeur de l'hôte (pourcentage). | |
| Divisions de nœuds feuilles par seconde. | |
| Les nœuds feuilles se divisent par transaction. | |
| bibliothèque taux d'accès au cache ratio. | |
| Taux d'échec du cache de la bibliothèque. | |
| Lectures logiques par seconde. | |
| Lectures logiques par transaction. | |
| Connexions par seconde. | |
| Connexions par transaction. | |
| Nombre d'analyses de table longues par seconde. | |
| Analyses de tables longues par transaction. | |
| Curseurs ouverts par seconde. | |
| Ouvrir les curseurs par transaction. | |
| Charge actuelle du système d'exploitation. | |
| Nombre d'échecs d'analyse par seconde. | |
| Analyser le nombre d'échecs par transaction. | |
| PGA taux d'accès au cache pourcentage. | |
| Pourcentage de limite de processus. | |
| Appels récursifs par seconde. | |
| Appels récursifs par transaction. | |
| Nombre d'écritures répétées par seconde. | |
| Réécrire les écritures par transaction. | |
| temps de réponse par transaction. | |
| Taux d'accès au cache ratio. | |
| Taux d'échec de cache de ligne. | |
| Lignes par tri. | |
| Nombre de sessions. | |
| Pourcentage de limite de session. | |
| Pourcentage gratuit de la piscine partagée. | |
| Taux d'analyse souple. | |
| Nombre total de tris par appel utilisateur. | |
| Temps de réponse du service SQL. | |
| Pourcentage d'utilisation du pool de flux. | |
| Nombre total d'analyses de table par appel utilisateur. | |
| Nombre total d'analyses d'index par seconde. | |
| Nombre total d'analyses d'index par transaction. | |
| Nombre total d'analyses par seconde. | |
| Nombre total d'analyses par transaction. | |
| Nombre total d'analyses de table par seconde. | |
| Nombre total d'analyses de table par transaction. | |
| Transactions par connexion. | |
| Appels utilisateur par seconde. | |
| Appels utilisateur par transaction. | |
| ratio d'appels utilisateur. | |
| Pourcentage d'engagements de l'utilisateur. | |
| Engagements utilisateur par seconde. | |
| Pourcentage de limite d'utilisateur. | |
| Annulations utilisateur par transaction. | |
| Annulations utilisateur par seconde. | |
| Enregistrements d'annulation de restauration utilisateur appliqués par seconde. | |
| Les enregistrements d'annulation de restauration utilisateur sont appliqués par transaction. | |
| Ratio de temps d'attente de la base de données. | |
| Appels utilisés capturés | |
| Exécuter sans ratio d'analyse | |
| Connexions par seconde | |
| Octets lus physiquement par seconde | |
| Requêtes d'E/S de lecture physique par seconde | |
| Lectures physiques par seconde | |
| Octets d'écritures physiques par seconde | |
| Écritures physiques par seconde | |
| Nombre de lectures de blocs. | |
| Nombre d'écritures de blocs. | |
| Lectures logiques par appel utilisateur. | |
| Les lectures physiques dirigent les lobes par seconde. | |
| Les écritures physiques génèrent des lobes directs par seconde. | |
| Nombre total d'octets par seconde en lecture physique. | |
| Lecture physique du nombre total I/O requests par seconde. | |
| Lectures physiques directes par seconde. | |
| Nombre total d'octets par seconde en écriture physique. | |
| d'écriture physique par seconde.I/O requests | |
| Écritures physiques directes par seconde. | |
| Nombre total d'écriture physique I/O requests par seconde. | |
| Nombre total de lectures physiques. | |
| Durée de lecture du fichier. | |
| Tri de disque par seconde. | |
| Tri du disque par transaction. | |
| Espace temporaire utilisé. | |
| Nombre total d'écritures physiques. | |
| Quantité de temps d'écriture du fichier. | |
| Nombre de comptes dont | |
| Nombre de requêtes de longue durée (> 60 s). | |
| Buffer taux d'accès au cache ratio. | |
| Blocs de cache globaux corrompus. | |
| Blocs de cache globaux perdus. | |
| Quantité actuelle de mémoire PGA allouée par l'instance. | |
| Taille maximale d'une zone de travail exécutée en mode automatique. | |
| Nombre d'octets de mémoire PGA dans tous les processus qui pourraient être libérés vers le système d'exploitation. | |
| Indique la quantité de mémoire PGA actuellement consommée par les zones de travail. Ce nombre peut être utilisé pour déterminer la quantité de mémoire consommée par d'autres consommateurs de la mémoire PGA (par exemple, PL/SQL ou Java). | |
| Taux de réussite de la réallocation. | |
| Refaire les octets générés par seconde. | |
| Refaire les octets générés par transaction. | |
| Ratio de tri de la mémoire. | |
| Mégaoctets I/O par seconde. | |
| I/O requests par seconde. | |
| Volume de trafic réseau par seconde. | |
| Les lectures physiques dirigent les lobs par transaction. | |
| Les écritures physiques dirigent les lobs par transaction. | |
| Lectures physiques directes par transaction. | |
| Lectures physiques par transaction. | |
| Écritures physiques directes par transaction. | |
| Écritures physiques par transaction. | |
| Transaction utilisateur par seconde. | |
| Nombre de redo fichier de log switch événement. | |
| Nombre de fichiers de log de redo switch événement nécessitant un archivage. | |
| Nombre de points de contrôle d'événement de changement de fichier de log de redo qui sont incomplets. | |
| Nombre d'attentes log de rétablissement. | |
| Nombre de segments de restauration obtenus. | |
| Ratio d'attente pour les segments de restauration. | |
| Nombre de segments de restauration en attente. | |
| Nombre d'attentes de tampon SGA occupées. | |
| Taille fixe SGA. | |
| Nombre de tampons libres SGA inspectés. | |
| Nombre d'attentes de tampon libre SGA. | |
| Taux de réussite pour le SGA. | |
| Taux de nouvelle tentative d'allocation pour le tampon log SGA. | |
| Réaliser le taux d'allocation pour le tampon log SGA. | |
| Nombre d'entrées Redo dans le tampon log SGA. | |
| L'espace tampon attend le tampon log SGA. | |
| Tampons de rétablissement SGA, en octets. | |
| Taux d'échec pour le cache du dictionnaire de pool partagé SGA (dict). | |
| Taux de réussite pour le cache de la bibliothèque de pool partagé SGA. | |
| Taux de rechargement pour le cache de la bibliothèque de pool partagé SGA. | |
| Mémoire cacheable SGA par instruction, en octets. | |
| Mémoire cacheable SGA par utilisateur, en octets. | |
| Mémoire totale dans la zone utilisateur Global (UGA). | |
| Trie l'utilisation du disque, en octets. | |
| Trie l'utilisation de la mémoire, en octets. |
Métriques de l'espace de table
La base de données d'intégration Oracle collecte les métriques de tablespace suivantes. Ces attributs peuvent être trouvés en interrogeant le type d'événement OracleTablespaceSample
. Veuillez noter que les métriques d'utilisation de l'espace table ne sont pas disponibles pour la base de données de secours en lecture seule - pour en savoir plus sur cette limitation, consultez la base de connaissances Oracle ici.
métrique | Description | Étendu |
---|---|---|
| Booléen pour l'état hors ligne de l'espace table. | |
| Le nombre de fichiers de données PDB qui sont hors ligne. | |
| Le nombre de fichiers de données CDB qui sont hors ligne. | |
| Le nombre de fichiers de données PDB dans un état non inscriptible. | |
| Quantité d'espace table consommée en octets. | |
| Espace table réservé total en octets. | |
| Rapport entre l'espace table utilisé et l'espace table total. |
Données d'inventaire
L'intégration de la base de données Oracle capture les paramètres configuration de la base de données Oracle . Les données sont disponibles sur la page Inventaire, sous la source config/oracledb . Pour en savoir plus sur les données d’inventaire, consultez Comprendre les données d’intégration.
L'intégration capture les données pour les paramètres de configuration de la base de données Oracle suivants :
Dépannage
Conseils de dépannage :
Vérifiez le code source
Cette intégration est un logiciel open source. Cela signifie que vous pouvez parcourir son code source et envoyer des améliorations, ou créer votre propre fork et le construire.