Puede instalar y configurar el monitoreo de la base de datos de Oracle en Kubernetes mediante el chart de Helm oracle-otel. Opcionalmente, el chart también puede ejecutar un trabajo de configuración que crea el usuario de la base de datos de monitoreo.
Instalación guiada
Para instalar a través de la UI de New Relic en su lugar, vaya a one.newrelic.com > Integrations & Agents > Oracle (Database 360). Esta página solo cubre la instalación manual.
Requisitos previos
- Una clave de licencia de New Relic válida.
- Helm 3.0 o posterior, y
kubectlconfigurado para acceder al clúster de Kubernetes. - Conectividad de red desde el clúster de Kubernetes al host y al puerto de escucha de la base de datos de Oracle.
- Ya sea un usuario de base de datos de monitoreo que ya haya creado, o credenciales de administrador de base de datos de Oracle (usuario maestro de RDS,
SYSoADMIN) para que el trabajo de configuración del chart pueda crear uno. Consulte Configurar las credenciales de monitoreo a continuación.
Cree el namespace
Cree el namespace en el que realizará la instalación. Debe existir antes de crear cualquier secreto en el siguiente paso, ya que helm install --create-namespace solo crea el namespace durante el paso de instalación final:
$kubectl create namespace newrelicSugerencia
Establézcalo como el namespace predeterminado para el contexto kubectl actual para que no necesite pasar -n en cada comando a continuación:
$kubectl config set-context --current --namespace=newrelicConfigurar las credenciales de monitoreo
Decida si desea que el trabajo de configuración del chart cree el usuario de monitoreo de la base de datos Oracle por usted y, de no ser así, cómo proporcionará sus credenciales:
Configurar los valores de Helm
Establezca oracle.topology para que coincida con su entorno:
Valor | Descripción |
|---|---|
| CDB multiinquilino en el host. Se monitorean todas las PDB bajo esta CDB. |
| PDB única en el host. |
| Oracle Database en AWS RDS. |
| Base de datos Oracle Autonomous. |
Utilice el values.yaml que coincida con el método de credenciales que eligió en el paso anterior:
Parámetro | Descripción |
|---|---|
| Su clave de licencia de New Relic. |
| El extremo OTLP/gRPC de su región, como un
simple sin esquema:
(EE. UU.) o
(UE). Para obtener más información, consulte la documentación de los extremos OTLP de New Relic . |
| El host de la base de datos Oracle (o extremo RDS) y el puerto del listener, accesibles desde el clúster. |
| El nombre del servicio CDB, PDB, RDS o ADB para la conexión del recolector. |
/
| Una imagen de Oracle Instant Client +
utilizada por el trabajo de configuración. No hay un valor predeterminado: extraer de
requiere aceptar primero los términos de licencia de Oracle, por lo que debe proporcionar su propia imagen. Solo es necesario para las credenciales basadas en secretos, donde el trabajo de configuración está habilitado. |
Sugerencia
Consulte el archivo values.yaml del chart para ver todas las opciones de configuración disponibles.
(Opcional) Monitorear múltiples instancias desde un release
En lugar de oracle.*, configure oracleMulti.enabled: true para monitorear varias instancias de base de datos Oracle desde un solo pod recolector en un lanzamiento. Los dos modos son mutuamente excluyentes: no configure oracle.endpoint y oracleMulti.enabled: true en el mismo lanzamiento. Cada instancia en un lanzamiento debe compartir el mismo oracleMulti.topology (cdb, pdb, rds o adb): no se admite mezclar topologías, por ejemplo, una instancia de RDS y una CDB autohospedada, en un solo lanzamiento; en su lugar, use un lanzamiento independiente para cada topología.
El modo multiinstancia no tiene una ruta de nombre de usuario/contraseña en texto plano: cada instancia necesita su propio secreto de Kubernetes con credenciales de monitoreo. Decida si también desea que el trabajo de configuración cree cada usuario de monitoreo:
Parámetro | Descripción |
|---|---|
| Establezca en
para monitorear varias instancias desde un lanzamiento en lugar de
. Por defecto es
. |
|
,
,
o
(mismo significado que
), compartido por cada instancia en esta versión. |
| Intervalo de extracción predeterminado para cada entrada. El valor predeterminado es
. Sobrescríbalo para una instancia específica con el propio
de esa entrada. |
| Lista de instancias para monitorear. Cada entrada requiere un
,
(
),
y
únicos; agregue
por entrada solo cuando
sea
. |
Sugerencia
A diferencia de los otros charts de Helm de NRDOT, Oracle le permite sobrescribir collectionInterval por instancia. Todas las demás configuraciones de extracción se siguen aplicando de forma idéntica a cada instancia. Utilice additionalReceiverConfig para cualquier otra cosa que deba ser diferente. El trabajo de configuración se ejecuta una vez por instancia (<release>-setup-<name>) en lugar de una vez por versión.
Instale el chart de Helm
Agregue el repositorio Helm de New Relic:
bash$helm repo add newrelic https://helm-charts.newrelic.com$helm repo updateInstale el chart utilizando su archivo
values.yaml:bash$helm upgrade --install oracle-otel newrelic/oracle-otel \>-n newrelic \>--create-namespace \>-f values.yaml
Verifique la instalación
Compruebe que el trabajo de configuración se haya completado y que el pod del recolector se esté ejecutando:
bash$kubectl get jobs,pods -n newrelic --watchEjecute esta consulta en el generador de consultas para confirmar que los datos están llegando:
SELECT count(*) FROM MetricWHERE metricName LIKE 'oracledb.%'AND instrumentation.provider = 'opentelemetry'SINCE 10 minutes ago
Para encontrar su entidad de base de datos Oracle en New Relic, consulte Buscar y usar sus datos.