Você pode instalar e configurar o monitoramento do banco de dados Oracle no Kubernetes usando o chart do Helm oracle-otel. Opcionalmente, o chart também pode executar um job de configuração que cria o usuário do banco de dados de monitoramento para você.
Instalação guiada
Para instalar pela interface da New Relic, acesse one.newrelic.com > Integrations & Agents > Oracle (Database 360). Esta página aborda apenas a instalação manual.
Pré-requisitos
- Uma chave de licença do New Relic válida.
- Helm 3.0 ou posterior, e
kubectlconfigurado para acessar seu cluster do Kubernetes. - Conectividade de rede do seu cluster do Kubernetes para o host e a porta do listener do banco de dados Oracle.
- Ou um usuário do banco de dados de monitoramento que você já criou, ou credenciais de administrador do banco de dados Oracle (usuário mestre do RDS,
SYSouADMIN) para que o job de configuração do chart possa criar um para você. Consulte Configure as credenciais de monitoramento abaixo.
Crie o namespace
Crie o namespace onde a instalação será realizada. Ele deve existir antes da criação de qualquer secret na próxima etapa, já que helm install --create-namespace cria o namespace apenas durante a etapa final de instalação:
$kubectl create namespace newrelicDica
Defina-o como o namespace padrão para o seu contexto kubectl atual para que não seja necessário passar -n em todos os comandos abaixo:
$kubectl config set-context --current --namespace=newrelicConfigure as credenciais de monitoramento
Decida se deseja que o job de configuração do chart crie o usuário de monitoramento do banco de dados Oracle para você e, caso contrário, como fornecerá suas credenciais:
Configure os valores do Helm
Defina oracle.topology para corresponder ao seu ambiente:
Valor | Descrição |
|---|---|
| CDB multitenant no host. Todos os PDBs sob este CDB são monitorados. |
| No host, PDB único. |
| Oracle Database no AWS RDS. |
| Banco de dados autônomo Oracle. |
Use o values.yaml que corresponde ao método de credencial escolhido na etapa anterior:
Parâmetro | Descrição |
|---|---|
| Sua chave de licença New Relic. |
| O endpoint OTLP/gRPC da sua região, como um
simples sem esquema:
(EUA) ou
(UE). Para mais informações, consulte a documentação dos endpoints OTLP da New Relic . |
| Seu host do banco de dados Oracle (ou endpoint do RDS) e a porta do listener, acessíveis a partir do cluster. |
| O nome do seu serviço CDB, PDB, RDS ou ADB para a conexão do coletor. |
/
| Uma imagem do Oracle Instant Client +
usada pelo job de configuração. Não há padrão: fazer o pull de
requer aceitar os termos de licença da Oracle primeiro, portanto, você deve fornecer sua própria imagem. Necessário apenas para credenciais baseadas em segredos, em que o job de configuração está habilitado. |
Dica
Consulte o values.yaml do chart para ver todas as opções de configuração disponíveis.
(Opcional) Monitorar várias instâncias a partir de um release
Em vez de oracle.*, defina oracleMulti.enabled: true para monitorar várias instâncias do banco de dados Oracle a partir de um único pod de coletor em um release. Os dois modos são mutuamente exclusivos: não defina oracle.endpoint e oracleMulti.enabled: true no mesmo release. Cada instância em um release deve compartilhar o mesmo oracleMulti.topology (cdb, pdb, rds ou adb): a mistura de topologias, por exemplo, uma instância do RDS e um CDB auto-hospedado, não é suportada em um release; em vez disso, use um release separado para cada topologia.
O modo multi-instância não possui um caminho de nome de usuário/senha em texto simples: cada instância precisa de seu próprio secret do Kubernetes com credenciais de monitoramento. Decida se você também deseja que o job de configuração crie cada usuário de monitoramento para você:
Parâmetro | Descrição |
|---|---|
| Defina como
para monitorar várias instâncias de uma versão em vez de
. O padrão é
. |
|
,
,
ou
(mesmo significado de
), compartilhado por cada instância nesta versão. |
| Intervalo de scrape padrão para cada entrada. O padrão é
. Substitua-o para uma instância específica com o próprio
dessa entrada. |
| Lista de instâncias para monitorar. Cada entrada requer
,
(
),
e
exclusivos; adicione
por entrada apenas quando
for
. |
Dica
Ao contrário dos outros charts do Helm do NRDOT, o Oracle permite substituir collectionInterval por instância. Todas as outras configurações de scrape ainda se aplicam de forma idêntica a cada instância. Use additionalReceiverConfig para qualquer outra coisa que precise ser diferente. O job de configuração é executado uma vez por instância (<release>-setup-<name>) em vez de uma vez por release.
Instale o Helm chart
Adicione o repositório Helm da New Relic:
bash$helm repo add newrelic https://helm-charts.newrelic.com$helm repo updateInstale o chart usando seu arquivo
values.yaml:bash$helm upgrade --install oracle-otel newrelic/oracle-otel \>-n newrelic \>--create-namespace \>-f values.yaml
Verifique a instalação
Verifique se o job de configuração foi concluído e se o pod do coletor está em execução:
bash$kubectl get jobs,pods -n newrelic --watchExecute esta consulta no criador de consulta para confirmar se os dados estão chegando:
SELECT count(*) FROM MetricWHERE metricName LIKE 'oracledb.%'AND instrumentation.provider = 'opentelemetry'SINCE 10 minutes ago
Para encontrar sua entidade de banco de dados Oracle no New Relic, consulte Encontrar e usar seus dados.