Instalar & configurar o NRDOT para monitoramento do Oracle com Autonomous Database

Obtenha insights abrangentes sobre o desempenho do seu Oracle Autonomous Database (ADB) com monitoramento de banco de dados, análise de consulta e métricas de integridade do sistema usando o coletor New Relic Distribution of OpenTelemetry (NRDOT).

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

Antes de começar, certifique-se de ter o seguinte:

Uma chave de licençada New Relic válida
Arquitetura suportada: Linux com AMD64 e ARM64
Conectividade de rede para o endpoint OTLP da New Relic
Oracle Database 19c ou posterior

Instalar o NRDOT Collector

Selecione o método de distribuição de instalação adequado para o seu ambiente Linux:

Para sistemas Debian/Ubuntu, execute:
bash
```
$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_amd64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb
```

Para sistemas RHEL/CentOS/OEL, execute:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_x86_64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Para sistemas Debian/Ubuntu, execute:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_arm64.deb" --output nrdot-collector.deb && sudo dpkg -i nrdot-collector.deb

Para sistemas RHEL/CentOS/OEL, execute:

bash

$NRDOT_VERSION=$(curl -s https://api.github.com/repos/newrelic/nrdot-collector-releases/releases/latest | grep '"tag_name":' | awk -F'"' '{print $4}') && curl -L "https://github.com/newrelic/nrdot-collector-releases/releases/download/${NRDOT_VERSION}/nrdot-collector_${NRDOT_VERSION}_linux_aarch64.rpm" --output nrdot-collector.rpm && sudo rpm -ivh nrdot-collector.rpm

Configurar usuário do banco de dados

Crie um usuário de monitoramento com os privilégios necessários para a sua instância de banco de dados ADB Oracle. Execute as seguintes instruções como SYS dentro do seu ADB de destino para criar um usuário de monitoramento local:

CREATE USER <YOUR_DB_USERNAME> IDENTIFIED BY "<YOUR_DB_PASSWORD>";
GRANT CREATE SESSION TO <YOUR_DB_USERNAME>;

Conceder privilégios de monitoramento para o banco de dados autônomo

Execute estes comandos como administrador dentro do seu ADB. Isso dá à ferramenta de monitoramento o acesso básico necessário para coletar métricas, rastrear eventos e encontrar suas instâncias de banco de dados.

GRANT SELECT ON SYS.V_$INSTANCE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$DATABASE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$CONTAINERS TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$DATAFILE   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$PDBS       TO <YOUR_DB_USERNAME>; 
GRANT SELECT ON SYS.V_$SYSSTAT                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SYSMETRIC                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SESSION                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$RESOURCE_LIMIT             TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$OSSTAT                     TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SGAINFO                    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$ROWCACHE                   TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$PARAMETER                  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_TABLESPACE_USAGE_METRICS  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_TABLESPACES               TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_DATA_FILES                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_FREE_SPACE                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_RECYCLEBIN                TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SQL            TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SQL_PLAN_STATISTICS_ALL       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$LOCK           TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$SESSION_EVENT  TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_PROCEDURES    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.DBA_OBJECTS       TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$PROCESS        TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.V_$TRANSACTION    TO <YOUR_DB_USERNAME>;
GRANT SELECT ON SYS.CDB_SERVICES      TO <YOUR_DB_USERNAME>;

Configurar o NRDOT Collector

Configure o NRDOT Collector com as suas configurações específicas do ADB. Crie um arquivo de configuração (por exemplo, adb-config.yaml) com o seguinte conteúdo:

configuração completa

Esta configuração captura métricas essenciais de baseline. Para ver o catálogo completo de métricas, consulte a referência de configuração.

Nome de usuário do banco de dados

Senha do banco de dados

Nome do host do Oracle ADB

Porta do Oracle ADB

Nome do serviço

Endpoint New Relic OTLP

Chave de licença da New Relic

adb-config.yaml

1
receivers:
2
  nroracledb/adb:
3
  datasource: "oracle://newrelic:YOUR_PASSWORD@adb.example.oraclecloud.com:1522/YOUR_SERVICE_NAME?ssl=true&ssl%20verify=true"
4
  collection_interval: 15s
5
events:
6
   db.server.query_sample:
7
     enabled: true
8
   db.server.top_query:
9
     enabled: true
10
   db.server.session.wait_sample:
11
     enabled: true
12
   db.server.top_procedure:
13
     enabled: true
14
   db.server.query_plan:
15
     enabled: true
16

17
top_query_collection:
18
   max_query_sample_count: 1000
19
   top_query_count: 200
20
   collection_interval: 60s
21
   allowed_comment_keys:
22
     - nr_service_guid
23

24
query_sample_collection:
25
   max_rows_per_query: 100
26
   allowed_comment_keys:
27
     - nr_service_guid
28

29
session_wait_event_collection:
30
   max_rows_per_query: 100
31

32
top_procedure_collection:
33
   max_procedure_sample_count: 1000
34
   top_procedure_count: 250
35
   collection_interval: 60s
36

37
  # Metrics configuration - This baseline configuration captures essential metrics. To enable advanced monitoring and extended telemetry, refer to the full configuration documentation
38
metrics:
39
   oracledb.buffer_cache.utilization:
40
     enabled: true
41
     attributes:
42
       - oracle.db.pdb
43
   oracledb.consistent_gets:
44
     enabled: true
45
     attributes:
46
       - oracle.db.pdb
47
   oracledb.cpu_time:
48
     enabled: true
49
     attributes:
50
       - oracle.db.pdb
51
   oracledb.database.cpu.utilization:
52
     enabled: true
53
     attributes:
54
       - oracle.db.pdb
55
   oracledb.database.wait.utilization:
56
     enabled: true
57
     attributes:
58
       - oracle.db.pdb
59
   oracledb.db_block_gets:
60
     enabled: true
61
     attributes:
62
       - oracle.db.pdb
63
   oracledb.enqueue_deadlocks:
64
     enabled: true
65
     attributes:
66
       - oracle.db.pdb
67
   oracledb.execution.utilization:
68
     enabled: true
69
     attributes:
70
       - oracledb.parse.type
71
       - oracle.db.pdb
72
   oracledb.executions:
73
     enabled: true
74
     attributes:
75
       - oracle.db.pdb
76
   oracledb.hard_parses:
77
     enabled: true
78
     attributes:
79
       - oracle.db.pdb
80
   oracledb.host.cpu.utilization:
81
     enabled: true
82
     attributes:
83
       - oracle.db.pdb
84
   oracledb.library_cache.utilization:
85
     enabled: true
86
     attributes:
87
       - oracle.db.pdb
88
   oracledb.logical_reads:
89
     enabled: true
90
     attributes:
91
       - oracle.db.pdb
92
   oracledb.logons:
93
     enabled: true
94
     attributes:
95
       - oracle.db.pdb
96
   oracledb.parse.rate:
97
     enabled: true
98
     attributes:
99
       - oracledb.parse.result
100
       - oracle.db.pdb
101
   oracledb.parse_calls:
102
     enabled: true
103
     attributes:
104
       - oracle.db.pdb
105
   oracledb.pga_memory:
106
     enabled: true
107
     attributes:
108
       - oracle.db.pdb
109
   oracledb.physical_io.requests:
110
     enabled: true
111
     attributes:
112
       - disk.io.direction
113
       - disk.io.block_size
114
       - oracle.db.pdb
115
   oracledb.physical_reads:
116
     enabled: true
117
     attributes:
118
       - oracle.db.pdb
119
   oracledb.physical_writes:
120
     enabled: true
121
     attributes:
122
       - oracle.db.pdb
123
   oracledb.processes.usage:
124
     enabled: true
125
   oracledb.sessions.usage:
126
     enabled: true
127
     attributes:
128
       - session_type
129
       - session_status
130
       - oracle.db.pdb
131
   oracledb.sga.usage:
132
     enabled: true
133
     attributes:
134
       - oracledb.sga.component.name
135
   oracledb.shared_pool.utilization:
136
     enabled: true
137
     attributes:
138
       - oracle.db.pdb
139
   oracledb.sql_service.response.duration:
140
     enabled: true
141
     attributes:
142
       - oracle.db.pdb
143
   oracledb.sqlnet.io.transferred:
144
     enabled: true
145
     attributes:
146
       - network.io.direction
147
       - destination.type
148
       - oracle.db.pdb
149
   oracledb.tablespace_size.usage:
150
     enabled: true
151
     attributes:
152
       - tablespace_name
153
       - oracle.db.pdb
154
   oracledb.transactions.usage:
155
     enabled: true
156
   oracledb.user_commits:
157
     enabled: true
158
     attributes:
159
       - oracle.db.pdb
160
   oracledb.user_rollbacks:
161
     enabled: true
162
     attributes:
163
       - oracle.db.pdb
164

165
  # Resource attributes attached to all metrics/logs (all enabled by default)
166
resource_attributes:
167
   oracle.db.edition:
168
     enabled: true
169
exporters:
170
  otlp/newrelic:
171
  endpoint: https://otlp.nr-data.net:4318
172
headers:
173
   api-key: YOUR_LICENSE_KEY
174
  compression: gzip
175
retry_on_failure:
176
   enabled: true
177
   initial_interval: 5s
178
   max_interval: 30s
179
   max_elapsed_time: 300s
180
sending_queue:
181
   enabled: true
182
   sizer: bytes
183
   queue_size: 100_000_000
184
   num_consumers: 10
185
   batch:
186
     sizer: bytes
187
     max_size: 1_000_000
188
     min_size: 0
189
     flush_timeout: 5s
190
service:
191
pipelines:
192
  metrics/oracledb:
193
   receivers: [nroracledb/adb]
194
   exporters: [otlp/newrelic]
195
  logs/oracledb:
196
   receivers: [nroracledb/adb]
197
   exporters: [otlp/newrelic]

Dica

Você também pode:

Configurar múltiplos receptores: para monitorar várias instâncias de banco de dados Oracle a partir de um coletor.
Configure o SQL Query Receiver: para coletar métricas personalizadas do seu banco de dados Oracle.
Vincule seu banco de dados Oracle ao APM: para correlacionar o desempenho do aplicativo com as operações de banco de dados. Isso permite visualizar exatamente quais aplicativos estão gerando workloads específicas de banco de dados.
Configurar o gerenciamento de segredos: para gerenciar com segurança informações confidenciais, como credenciais de banco de dados. Isso ajuda a aprimorar a segurança do seu ambiente de monitoramento ao evitar a inserção direta de dados sensíveis nos arquivos de configuração.

Reiniciar o NRDOT Collector

Após configurar o coletor, reinicie o serviço NRDOT Collector para aplicar as alterações:

bash

$sudo systemctl restart nrdot-collector

Para verificar se o coletor está funcionando corretamente, verifique o status do serviço:

bash

$sudo systemctl status nrdot-collector

Dica

Sempre reinicie o Collector NRDOT após fazer alterações de configuração para garantir que as novas configurações entrem em vigor.

Encontre e use seus dados

Assim que seus dados estiverem sendo coletados, você poderá acessar o monitoramento abrangente do banco de dados Oracle por meio da interface do New Relic.

Para encontrar sua entidade de banco de dados Oracle no New Relic:

Vá para https://one.newrelic.com > All Capabilities > Databases.
Defina os critérios de pesquisa como instrumentation.provider = opentelemetry.
Selecione seu banco de dados Oracle ADB na lista de entidades.

Resolução de problemas

Saiba como solucionar problemas na sua configuração de monitoramento do Oracle ADB no New Relic.

Referência de métricas

Saiba mais sobre as métricas disponíveis coletadas pelo NRDOT Collector.

Instrumentação do RDS

Saiba como configurar seu banco de dados Oracle para monitoramento do RDS no New Relic.

Esta tradução de máquina é fornecida para sua comodidade.

Instalar & configurar o NRDOT para monitoramento do Oracle com Autonomous Database

Instalação guiada

Pré-requisitos

Instalar o NRDOT Collector

Para arquitetura AMD64

Para arquitetura ARM64

Configurar usuário do banco de dados

Conceder privilégios de monitoramento para o banco de dados autônomo

Configurar o NRDOT Collector

configuração completa

Dica

Reiniciar o NRDOT Collector

Dica

Encontre e use seus dados

Resolução de problemas

Referência de métricas

Instrumentação do RDS

Esta tradução de máquina é fornecida para sua comodidade.

Instalar & configurar o NRDOT para monitoramento do Oracle com Autonomous Database

Instalação guiada

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Instalar o NRDOT Collector

Para arquitetura ARM64

Configurar usuário do banco de dados

Conceder privilégios de monitoramento para o banco de dados autônomo

Configurar o NRDOT Collector

configuração completa

Dica

Reiniciar o NRDOT Collector

Dica

Encontre e use seus dados

Artigos relacionados

Resolução de problemas

Referência de métricas

Instrumentação do RDS

Pré-requisitos