Nuestra integración de base de datos de Oracle recopila métricas clave de rendimiento en base de datos, espacios de tabla y memoria de forma predeterminada. Puede personalizar su configuración para recopilar aún más métricas, brindándole una caracterización detallada del rendimiento de la base de datos.
Continúe leyendo para instalar la integración y ver qué datos recopilamos.
Compatibilidad y requisitos
Nuestra integración es compatible con Oracle base de datos desde las versiones 11.2 a la 21.
Antes de instalar la integración, asegúrese de cumplir con los siguientes requisitos:
Distribución Linux compatible con infraestructura, excepto versiones RHEL/CentOS/OEL inferiores a 7.
Oracle Instant Client en el cuadro del agente.
Base de datos de Oracle con
ORACLE_HOME
configurado en el directorio correcto para el usuario raíz.Usuario de la base de datos Oracle con privilegios
Base de datos de Oracle con un archivo
listener.ora
configurado para monitor desde una conexión remota. De forma predeterminada, Oracle base de datos solo escucha a localhost.
Importante
La arquitectura ARM64 no es compatible.
Instalar y activar
Para instalar la integración de la base de datos Oracle:
Instale el agente de infraestructura y reemplace la variable
INTEGRATION_FILE_NAME
connri-oracledb
.Cambiar directorio a la carpeta de integración:
bash$cd /etc/newrelic-infra/integrations.dCopie el archivo de configuración de muestra:
bash$sudo cp oracledb-config.yml.sample oracledb-config.ymlEdite el archivo
oracledb-config.yml
como se describe en los ajustes de configuración.
Notas adicionales:
Advanced:
También es posible instalar la integración desde un archivo tarball. Esto le brinda control total sobre el proceso de instalación y configuración.
On-host integrations do not automatically update.
Para obtener mejores resultados, actualice periódicamente el paquete de integración y el agente de infraestructura.
¿Te ha ayudado este documento con la instalación?
Configuración
Habilitando su servidor Oracle DB
En la base de datos Oracle, ejecute las siguientes instrucciones para crear un nuevo usuario y asignar privilegios de usuario. Se deben reemplazar USERNAME y valores similares específicos del usuario.
Elija qué tipo de base de datos tiene. Para obtener ayuda con las preguntas de mantenimiento del usuario, consulte los documentos de Oracle o comuníquese con el administrador de su sistema o base de datos.
Otorgue
CONNECT
privilegios al usuario:GRANT CONNECT TO USERNAME;Otorgue privilegios
SELECT
al usuario en las siguientes vistas globales: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
Ejecute las siguientes sentencias SQL juntas en un script o individualmente:
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;
Para recopilar PDB métrica, otorgue privilegios
gv$con_sysmetric
ejecutando:GRANT SELECT ON gv$con_sysmetric TO USERNAME;
Configurar la integración
Hay varias formas de configurar la integración, dependiendo de cómo se instaló:
- Si está habilitado a través de Amazon ECS: consulte Servicios de monitorización que se ejecutan en ECS.
- Si está instalado en el host: edite la configuración en el archivo de configuración YAML de la integración,
oracledb-config.yml
.
La configuración de formato YAML de una integración es donde puede colocar las credenciales de inicio de sesión requeridas y configurar cómo se recopilan los datos. Las opciones que cambie dependen de su configuración y preferencia.
El archivo de configuración tiene configuraciones comunes aplicables a todas las integraciones como interval
, timeout
, inventory_source
. Para leer todo sobre estas configuraciones comunes, consulte nuestro documento Formato de configuración .
Importante
Si todavía utiliza nuestros archivos de configuración/definición legacy , consulte este documento para obtener ayuda.
Las configuraciones específicas relacionadas con Oracle DB se definen usando la sección env
del archivo de configuración. Estas configuraciones controlan la conexión a su instancia de base de datos Oracle, así como otras configuraciones y características de seguridad. La lista de configuraciones válidas se describe en la siguiente sección de este documento.
Configuración de instancia de base de datos de Oracle
La integración de Oracle DB recopila información métrica (M) e inventario (I). En la tabla, utilice la columna Applies To para las configuraciones disponibles para cada colección:
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Configuración | Descripción | Por defecto | Se aplica a |
---|---|---|---|
SERVICE_NAME | El nombre del servicio para la instancia de Oracle. | N/A | M/I |
HOSTNAME | Nombre de host o IP donde se ejecuta Oracle DB. | 127.0.0.1 | M/I |
PORT | Puerto en el que escucha Oracle DB. | 1521 | M/I |
USERNAME | Nombre de usuario para acceder al servidor de base de datos Oracle. | N/A | M/I |
PASSWORD | Contraseña para el usuario dado. | N/A | M/I |
CONNECTION_STRING | Una cadena de conexión completa como las que se encuentran en | N/A | M/I |
ORACLE_HOME | Ruta hacia donde está | N/A | M/I |
TABLESPACES | Una matriz JSON de espacios de tabla para recopilar. Si se omite, recopila todos los espacios de tabla. Si está vacío, se salta la colección métrica del tablespace. | [] | M |
IS_SYS_DBA | Indica si el usuario que se autentica tiene permisos SysDBA. | false | M |
IS_SYS_OPER | Indica si el usuario que se autentica tiene permisos SysOper. | false | M |
EXTENDED_METRICS | Indica si se debe recoger métrica extendida. Consulta cuáles tienen extensión métrica en la siguiente tabla | false | M |
SKIP_METRICS_GROUPS | Las métricas recopiladas se agrupan según la consulta utilizada para obtener los datos. Estos grupos métricos se enumeran aquí y se pueden omitir de la colección agregando el nombre del grupo a | [] | M |
DISABLE_CONNECTION_POOL | Deshabilite la agrupación de conexiones. Úselo solo si la integración genera errores al intentar establecer nuevas conexiones a Oracle DB. | false | M |
MAX_OPEN_CONNECTIONS | Número máximo de conexiones simultáneas abiertas por la integración. | 5 | M |
SYS_METRICS_SOURCE | Configúrelo en | '' | M |
CUSTOM_METRICS_QUERY | Una consulta SQL para recopilar métrica personalizada. Vea el ejemplo a continuación. | N/A | M |
CUSTOM_METRICS_CONFIG | Configuración YAML con una o más consultas SQL para recopilar métrica personalizada. Vea el ejemplo a continuación. | false | M |
METRICS | Establezca en | false | |
INVENTORY | Configúrelo en | false |
Los valores para estas configuraciones se pueden definir de varias maneras:
- Agregue el valor directamente al archivo de configuración. Esta es la forma más común.
- Reemplace los valores de las variables de entorno utilizando la notación
{{}}
. Esto requiere el agente de infraestructura 1.14.0+. Para obtener más información sobre esto, consulte más sobre las variables de entorno de paso a través del agente de infraestructura. - Utilice la administración de secretos para proteger la información confidencial, como las contraseñas, de modo que no quede expuesta en texto sin formato en el archivo de configuración. Para obtener más información, consulte gestión de secretos.
Etiquetas y atributos personalizados
También puedes decorar tu métrica con etiquetas. Las etiquetas le permiten agregar valor par principal atributo a su métrica para que pueda consultar, filtrar o agrupar su métrica.
Aunque nuestro archivo de configuración de muestra predeterminado incluye ejemplos de etiquetas, son opcionales. Puede eliminar, modificar o agregar otros nuevos.
labels: env: production role: load_balancer
Configuración de ejemplo
Buscar y utilizar datos
Para encontrar sus datos de integración en New Relic, vaya a one.newrelic.com > All capabilities > Infrastructure > Third-party services y seleccione uno de los enlaces de integración de la base de datos de Oracle.
Los datos de la base de datos de Oracle se adjuntan a los siguientes tipos de eventos:
OracleDatabaseSample
OracleTablespaceSample
Para obtener más información sobre cómo encontrar y utilizar sus datos, consulte Comprender los datos de integración.
Datos métricos
La integración de la base de datos de Oracle recopila el siguiente atributo de datos métricos. Cada nombre de métrica tiene como prefijo un indicador de categoría y un punto, como disk.
o memory.
.
Base de datos métrica
Estos atributos se pueden encontrar consultando el tipo de evento OracleDatabaseSample
.
Métrica | Descripción | Extendido |
---|---|---|
| Sesiones paralelas activas. | |
| Sesiones seriales activas. | |
| Sesiones activas promedio. | |
| Puntos de control por segundo. | |
| Uso de CPU en segundo plano por segundo. | |
| Tiempo de fondo por segundo. | |
| Cambios de bloque de base de datos por segundo. | |
| Cambios en el bloque de base de datos por transacción. | |
| Cambios de bloque de base de datos por llamada de usuario. | |
| El bloque DB se obtiene por segundo. | |
| El bloque DB se obtiene por transacción. | |
| El bloque DB se obtiene por llamada del usuario. | |
| El nodo de rama se divide por segundo. | |
| El nodo de sucursal se divide por transacción. | |
| Cambios de lectura consistentes por segundo. | |
| Cambios de lectura consistentes por transacción. | |
| Obtiene lecturas consistentes por segundo. | |
| Obtiene lecturas consistentes por transacción. | |
| Relación de tiempo de CPU. | |
| Uso de CPU por segundo. | |
| Uso de CPU por transacción. | |
| Bloques CR creados por segundo. | |
| Bloques CR creados por transacción. | |
| CR deshacer registros aplicados por segundo. | |
| CR deshacer registros aplicados por transacción. | |
| Los inicios de sesión actuales cuentan. | |
| Los cursores abiertos actuales cuentan. | |
| Cursor activado de relación caché. | |
| Tiempo de base de datos por segundo. | |
| Puntos de control DBWR por segundo. | |
| Poner en cola interbloqueos por segundo. | |
| Poner en cola los puntos muertos por transacción. | |
| Solicitudes en cola por segundo. | |
| Poner en cola solicitudes por transacción. | |
| Tiempos de espera de puesta en cola por segundo. | |
| Tiempos de espera de puesta en cola por transacción. | |
| Esperas en cola por segundo. | |
| Esperas en cola por transacción. | |
| Ejecuciones por segundo. | |
| Ejecuciones por transacción. | |
| Ejecuciones por llamada de usuario. | |
| Escaneos de índice completo por segundo. | |
| Escaneos de índice completo por transacción. | |
| Bloque GC CR recibido por segundo. | |
| Bloque GC CR recibido por transacción. | |
| Bloque actual del GC recibido por segundo. | |
| Bloque actual de GC recibido por transacción. | |
| Tiempo de obtención de CR promedio de caché global. | |
| Tiempo de obtención actual promedio de caché global. | |
| Recuento de análisis duro por segundo. | |
| Recuento de análisis duro por transacción. | |
| Uso de CPU del host por segundo. | |
| Utilización de CPU del host (porcentaje). | |
| El nodo hoja se divide por segundo. | |
| El nodo hoja se divide por transacción. | |
| Biblioteca acierto de caché ratio. | |
| Proporción de errores de caché de la biblioteca. | |
| Lecturas lógicas por segundo. | |
| Lecturas lógicas por transacción. | |
| Inicios de sesión por segundo. | |
| Inicios de sesión por transacción. | |
| Escaneos de tablas largos por segundo. | |
| Escaneos largos de tablas por transacción. | |
| Abrir cursores por segundo. | |
| Abrir cursores por transacción. | |
| Carga actual del sistema operativo. | |
| Recuento de errores de análisis por segundo. | |
| Analizar el recuento de errores por transacción. | |
| PGA acierto de porcentaje de caché. | |
| Porcentaje límite de proceso. | |
| Llamadas recursivas por segundo. | |
| Llamadas recursivas por transacción. | |
| Rehacer escrituras por segundo. | |
| Rehacer escrituras por transacción. | |
| Tiempo de respuesta por transacción. | |
| Row acierto de caché ratio. | |
| Proporción de errores de caché de filas. | |
| Filas por clasificación. | |
| Recuento de sesiones. | |
| Porcentaje de límite de sesión. | |
| Porcentaje gratuito del grupo compartido. | |
| Relación de análisis suave. | |
| Clasificación total por llamada de usuario. | |
| Tiempo de respuesta del servicio SQL. | |
| Porcentaje de uso del grupo de transmisiones. | |
| Escaneos totales de tablas por llamada de usuario. | |
| Escaneos de índice totales por segundo. | |
| Escaneos de índice totales por transacción. | |
| Recuento total de análisis por segundo. | |
| Recuento total de análisis por transacción. | |
| Escaneos totales de tablas por segundo. | |
| Escaneos totales de tablas por transacción. | |
| Transacción por inicio de sesión. | |
| Llamadas de usuario por segundo. | |
| Llamadas de usuario por transacción. | |
| Ratio de llamadas de usuarios. | |
| Porcentaje de compromisos del usuario. | |
| El usuario confirma por segundo. | |
| Porcentaje límite de usuarios. | |
| Rollbacks de usuario por transacción. | |
| Reversiones de usuario por segundo. | |
| La reversión del usuario deshace registros aplicados por segundo. | |
| La reversión del usuario deshace los registros aplicados por transacción. | |
| Relación de tiempo de espera de la base de datos. | |
| Llamadas utilizadas capturadas | |
| Ejecutar sin relación de análisis | |
| Inicios de sesión por segundo | |
| Bytes de lectura física por segundo | |
| Solicitudes de E/S de lectura física por segundo | |
| Lecturas físicas por segundo | |
| Bytes de escritura física por segundo | |
| Escrituras físicas por segundo | |
| Número de lecturas de bloque. | |
| Número de escrituras en bloque. | |
| Lecturas lógicas por llamada de usuario. | |
| Lecturas físicas de globos directos por segundo. | |
| Escritura física globos directos por segundo. | |
| Bytes totales de lectura física por segundo. | |
| Solicitudes de I/O totales de lectura física por segundo. | |
| Lecturas físicas directas por segundo. | |
| Total de bytes por segundo de escritura física. | |
| Solicitudes de I/O de escritura física por segundo. | |
| Escrituras físicas directas por segundo. | |
| Solicitudes de I/O totales de escritura física por segundo. | |
| Número total de lecturas físicas. | |
| Cantidad de tiempo de lectura del archivo. | |
| Clasificación de discos por segundo. | |
| Clasificación de discos por transacción. | |
| Espacio temporal utilizado. | |
| Número total de escrituras físicas. | |
| Cantidad de tiempo de escritura del archivo. | |
| Número de cuentas cuyo | |
| Número de consultas de larga duración (>60 años). | |
| Buffer acierto de caché ratio. | |
| Bloques de caché global dañados. | |
| Se perdieron bloques de caché global. | |
| Cantidad actual de memoria PGA asignada por la instancia. | |
| Tamaño máximo de un área de trabajo ejecutada en modo automático. | |
| Número de bytes de memoria PGA en todos los procesos que podrían liberarse al sistema operativo. | |
| Indica cuánta memoria PGA consumen actualmente las áreas de trabajo. Este número se puede utilizar para determinar cuánta memoria consume otro consumidor de la memoria PGA (por ejemplo, PL/SQL o Java). | |
| Rehacer la proporción de aciertos de la asignación. | |
| Rehacer bytes generados por segundo. | |
| Rehacer bytes generados por transacción. | |
| Relación de tipos de memoria. | |
| Megabytes de I/O por segundo. | |
| Solicitudes de I/O por segundo. | |
| Volumen de tráfico de red por segundo. | |
| Lecturas físicas de globos directos por transacción. | |
| Escrituras físicas globos directos por transacción. | |
| Lecturas físicas directas por transacción. | |
| Lecturas físicas por transacción. | |
| Escrituras físicas directas por transacción. | |
| Escrituras físicas por transacción. | |
| Transacción de usuario por segundo. | |
| Número de evento de cambio de registro de rehacer archivo. | |
| Número de eventos de cambio de registro de rehacer archivo que necesitan archivarse. | |
| Número de puntos de control de eventos de cambio de archivo de registro de rehacer que están incompletos. | |
| Número de esperas log de rehacer. | |
| Se obtiene el número de segmentos de reversión. | |
| Relación de esperas para segmentos de reversión. | |
| Número de segmentos de reversión en espera. | |
| Número de esperas ocupadas del búfer SGA. | |
| Tamaño fijo SGA. | |
| Número de buffers libres de SGA inspeccionados. | |
| Número de esperas de búfer libres de SGA. | |
| Proporción de aciertos para el SGA. | |
| Proporción de reintentos de asignaciones para el búfer log SGA. | |
| Rehacer la proporción de asignación para el búfer log SGA. | |
| Número de entradas de Rehacer en el búfer log SGA. | |
| El espacio del búfer espera el búfer log SGA. | |
| Búfers de rehacer SGA, en bytes. | |
| Proporción de errores para la caché del diccionario (dict) del grupo compartido de SGA. | |
| Proporción de aciertos para la caché de la biblioteca del grupo compartido SGA. | |
| Relación de recarga para la caché de la biblioteca del grupo compartido SGA. | |
| Memoria cacheable SGA por declaración, en bytes. | |
| Memoria caché SGA por usuario, en bytes. | |
| Memoria total en el Área Global de usuario (UGA). | |
| Ordena el uso del disco, en bytes. | |
| Ordena el uso de la memoria, en bytes. |
Espacio de mesa métrica
La integración de la base de datos de Oracle recopila el siguiente tablespace métrico. Estos atributos se pueden encontrar consultando el tipo de evento OracleTablespaceSample
. Tenga en cuenta que las métricas de uso del espacio de tabla no están disponibles para la base de datos en espera de solo lectura; lea más sobre esta limitación en la base de conocimiento de Oracle aquí.
Métrica | Descripción | Extendido |
---|---|---|
| Booleano para el estado fuera de línea del espacio de tabla. | |
| La cantidad de archivos de datos PDB que están fuera de línea. | |
| La cantidad de archivos de datos CDB que están fuera de línea. | |
| El número de archivos de datos PDB en un estado de no escritura. | |
| Cantidad consumida de espacio de tabla en bytes. | |
| Espacio de tabla reservado total en bytes. | |
| Relación entre el espacio de tabla utilizado y el total. |
Datos de inventario
La integración de la base de datos de Oracle captura el parámetro de configuración de la base de datos de Oracle. Los datos están disponibles en la página Inventario, en la fuente config/oracledb . Para obtener más información sobre los datos de inventario, consulte Comprender los datos de integración.
La integración captura datos para el siguiente parámetro de configuración de base de datos de Oracle:
Resolución de problemas
Consejos para la resolución de problemas:
Comprueba el código fuente
Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.