Nossa integração com o Oracle banco de dados coleta métricas importantes de desempenho em banco de dados, tablespaces e memória por padrão. Você pode personalizar sua configuração para coletar ainda mais métricas, fornecendo uma caracterização detalhada do desempenho do banco de dados.
Continue lendo para instalar a integração e ver quais dados coletamos.
Compatibilidade e requisitos
Nossa integração é compatível com Oracle Database das versões 11.2 a 23.
Antes de instalar a integração, certifique-se de atender aos seguintes requisitos:
- Distribuição Linux compatível com infraestrutura, exceto versões RHEL/CentOS/OEL inferiores a 7.
- Instale o agente de infraestrutura.
- Oracle Instant Client na caixa do agente.
- Oracle banco de dados com
ORACLE_HOME
configurado no diretório correto para o usuário root. - Usuário do banco de dados Oracle com privilégios CONNECT e SELECT nas visualizações globais necessárias.
- Oracle banco de dados com um arquivo
listener.ora
configurado para monitor a partir de uma conexão remota. Por padrão, o Oracle banco de dados escuta apenas localhost.
Importante
A arquitetura ARM64 não é suportada.
Instalar e ativar
Para instalar a integração Oracle banco de dados:
Instale o agente de infraestrutura e substitua a variável
INTEGRATION_FILE_NAME
pornri-oracledb
.Mude o diretório para a pasta integração:
bash$cd /etc/newrelic-infra/integrations.dCopie o arquivo de configuração de amostra:
bash$sudo cp oracledb-config.yml.sample oracledb-config.ymlEdite o arquivo
oracledb-config.yml
conforme descrito nas definições de configuração.
Notas Adicionais:
- Advanced: Também é possível instalar a integração a partir de um arquivo tarball. Isso lhe dá controle total sobre o processo de instalação e configuração.
- On-host integrations do not automatically update. Para obter melhores resultados, atualize regularmente o pacote de integração e o agente de infraestrutura.
Este documento ajudou você na instalação?
Configuração
Habilitando seu servidor de banco de dados Oracle
No banco de dados Oracle, execute as instruções a seguir para criar um novo usuário e atribuir privilégios de usuário. USERNAME e valores semelhantes específicos do usuário devem ser substituídos.
Escolha que tipo de banco de dados você possui. Para obter assistência com dúvidas de manutenção do usuário, consulte a documentação da Oracle ou entre em contato com o administrador do sistema ou do banco de dados.
Conceda privilégios
CONNECT
ao usuário:GRANT CONNECT TO USERNAME;Conceda privilégios
SELECT
ao usuário nas seguintes visualizações globais: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
Execute as seguintes instruções SQL juntas em um script ou 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 coletar a métrica do PDB, conceda privilégios gv$con_sysmetric
executando:
GRANT SELECT ON gv$con_sysmetric TO USERNAME;
Configurar a integração
Existem diversas formas de configurar a integração, dependendo de como ela foi instalada:
- Se habilitado via Amazon ECS: consulte Monitorar serviços em execução no ECS.
- Se instalado no host: edite a configuração no arquivo de configuração YAML da integração,
oracledb-config.yml
.
A configuração no formato YAML de uma integração é onde você pode colocar as credenciais de login necessárias e configurar como os dados são coletados. Quais opções você altera dependem de sua configuração e preferência.
O arquivo de configuração possui configurações comuns aplicáveis a todas as integrações como interval
, timeout
, inventory_source
. Para ler tudo sobre essas configurações comuns, consulte nosso documento Formato de configuração .
Importante
Se você ainda estiver usando nossos arquivos de configuração/definição legados, consulte este documento para obter ajuda.
As configurações específicas relacionadas ao banco de dados Oracle são definidas usando a seção env
do arquivo de configuração. Essas configurações controlam a conexão com sua instância de banco de dados Oracle, bem como outras configurações e recursos de segurança. A lista de configurações válidas é descrita na próxima seção deste documento.
Configurações da instância de banco de dados Oracle
A integração do banco de dados Oracle coleta informações de métrica(M) e de inventário(I). Na tabela, use a coluna Applies To para as configurações disponíveis para cada coleção:
' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' ' '
Contexto | Descrição | Padrão | Aplica-se a |
---|---|---|---|
SERVICE_NAME | O nome do serviço da instância Oracle. | N/A | MI |
HOSTNAME | Nome do host ou IP onde o banco de dados Oracle está rodando. | 127.0.0.1 | MI |
PORT | Porta na qual o banco de dados Oracle está escutando. | 1521 | MI |
USERNAME | Nome de usuário para acessar o servidor Oracle DB. | N/A | MI |
PASSWORD | Senha do usuário fornecido. | N/A | MI |
CONNECTION_STRING | Uma string de conexão completa, como as encontradas em | N/A | MI |
ORACLE_HOME | Caminho para onde | N/A | MI |
TABLESPACES | Uma matriz JSON de tablespaces a serem coletados. Se omitido, ele coleta todos os tablespaces. Se vazio, ignora a coleta de métricas do tablespace. | [] | M |
IS_SYS_DBA | Indica se o usuário autenticador possui permissões SysDBA. | false | M |
IS_SYS_OPER | Indica se o usuário autenticador possui permissões SysOper. | false | M |
EXTENDED_METRICS | Indica se a métrica estendida deve ser coletada. Confira quais são métricas estendidas na tabela abaixo | false | M |
SKIP_METRICS_GROUPS | As métricas coletadas são agrupadas dependendo da consulta utilizada para obtenção dos dados. Esses grupos métricos estão listados aqui e podem ser ignorados da coleção adicionando o nome do grupo a | [] | M |
DISABLE_CONNECTION_POOL | Desative o pool de conexões. Use somente se a integração estiver apresentando erros ao tentar estabelecer novas conexões com o banco de dados Oracle. | false | M |
MAX_OPEN_CONNECTIONS | Número máximo de conexões simultâneas abertas pela integração. | 5 | M |
SYS_METRICS_SOURCE | Defina-o como | '' | M |
CUSTOM_METRICS_QUERY | Uma consulta SQL para coleta de métrica personalizada. Veja o exemplo abaixo. | N/A | M |
CUSTOM_METRICS_CONFIG | Configuração YAML com uma ou mais consultas SQL para coleta de métricas personalizadas. Veja o exemplo abaixo. | false | M |
METRICS | Defina como | false | |
INVENTORY | Defina como | false |
Os valores para estas configurações podem ser definidos de diversas maneiras:
- Adicione o valor diretamente ao arquivo de configuração. Esta é a forma mais comum.
- Substitua os valores das variáveis de ambiente usando a notação
{{}}
. Isso requer o agente de infraestrutura 1.14.0+. Para saber mais sobre isso, consulte mais sobre variáveis de ambiente de passagem do agente de infraestrutura. - Use o gerenciamento de segredos para proteger informações confidenciais, como senhas, para que não sejam expostas em texto simples no arquivo de configuração. Para obter mais informações, consulte gerenciamento de segredos.
Etiquetas e atributo personalizado
Você também pode decorar sua métrica com etiquetas. Os rótulos permitem adicionar atributo de par de valor principal à sua métrica para que você possa consultar, filtrar ou agrupar sua métrica.
Embora nosso arquivo de configuração de amostra padrão inclua exemplos de rótulos, eles são opcionais. Você pode remover, modificar ou adicionar novos.
labels: env: production role: load_balancer
Exemplo de configuração
Encontre e use dados
Para encontrar seus dados de integração no New Relic, acesse one.newrelic.com > All capabilities > Infrastructure > Third-party services e selecione um dos links de integração do Oracle banco de dados.
Os dados do banco de dados Oracle são anexados aos seguintes tipos de eventos:
OracleDatabaseSample
OracleTablespaceSample
Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.
Dados métricos
A integração do Oracle banco de dados coleta os seguintes atributos de dados métricos. Cada nome de métrica é prefixado com um indicador de categoria e um ponto, como disk.
ou memory.
.
Métrica de banco de dados
Esses atributos podem ser encontrados consultando o tipo de evento OracleDatabaseSample
.
Métrica | Descrição | Estendido |
---|---|---|
| Sessões paralelas ativas. | |
| Sessões seriais ativas. | |
| Média de sessões ativas. | |
| Pontos de verificação por segundo. | |
| Uso de CPU em segundo plano por segundo. | |
| Tempo de fundo por segundo. | |
| Alterações de bloco de banco de dados por segundo. | |
| Alterações no bloco do banco de dados por transação. | |
| Alterações no bloco de banco de dados por chamada de usuário. | |
| O bloco DB é obtido por segundo. | |
| Bloco de banco de dados obtido por transação. | |
| O bloco DB é obtido por chamada do usuário. | |
| O nó da ramificação se divide por segundo. | |
| O nó da filial é dividido por transação. | |
| Mudanças de leitura consistentes por segundo. | |
| Mudanças de leitura consistentes por transação. | |
| A leitura consistente é obtida por segundo. | |
| Leitura consistente obtida por transação. | |
| Proporção de tempo de CPU. | |
| Uso de CPU por segundo. | |
| Uso de CPU por transação. | |
| Blocos CR criados por segundo. | |
| Blocos CR criados por transação. | |
| Registros de desfazer CR aplicados por segundo. | |
| Registros de desfazer CR aplicados por transação. | |
| Contagem de logons atuais. | |
| Contagem atual de cursores abertos. | |
| Ocorrência do cursor sem proporção de cache. | |
| Tempo do banco de dados por segundo. | |
| Pontos de verificação DBWR por segundo. | |
| Enfileirar deadlocks por segundo. | |
| Enfileirar deadlocks por transação. | |
| Enfileirar solicitações por segundo. | |
| Enfileirar solicitações por transação. | |
| Tempo limite de enfileiramento por segundo. | |
| Tempo limite de enfileiramento por transação. | |
| O enfileiramento espera por segundo. | |
| Enfileirar espera por transação. | |
| Execuções por segundo. | |
| Execuções por transação. | |
| Execuções por chamada de usuário. | |
| Varreduras completas de índice por segundo. | |
| Varreduras completas de índice por transação. | |
| Bloco GC CR recebido por segundo. | |
| Bloco GC CR recebido por transação. | |
| Bloco atual do GC recebido por segundo. | |
| Bloco atual de GC recebido por transação. | |
| Tempo médio de obtenção de CR do cache global. | |
| Tempo médio de obtenção atual do cache global. | |
| Contagem de análise difícil por segundo. | |
| Contagem de análise difícil por transação. | |
| Uso da CPU do host por segundo. | |
| Utilização da CPU do host (porcentagem). | |
| O nó folha se divide por segundo. | |
| O nó folha é dividido por transação. | |
| Biblioteca ocorrência sem taxa de cache. | |
| Taxa de falta do cache da biblioteca. | |
| Leituras lógicas por segundo. | |
| Leituras lógicas por transação. | |
| Logons por segundo. | |
| Logons por transação. | |
| Longas varreduras de tabela por segundo. | |
| Longas varreduras de tabela por transação. | |
| Cursores abertos por segundo. | |
| Cursores abertos por transação. | |
| Carga atual do sistema operacional. | |
| Contagem de falhas de análise por segundo. | |
| Contagem de falhas de análise por transação. | |
| PGA ocorrência sem percentual de cache. | |
| Porcentagem de limite do processo. | |
| Chamadas recursivas por segundo. | |
| Chamadas recursivas por transação. | |
| Refazer gravações por segundo. | |
| Refazer gravações por transação. | |
| Tempo de resposta por transação. | |
| Ocorrência de linha sem proporção de cache. | |
| Taxa de falta de cache de linha. | |
| Linhas por classificação. | |
| Contagem de sessões. | |
| Porcentagem de limite de sessão. | |
| Porcentagem livre do pool compartilhado. | |
| Proporção de análise suave. | |
| Total de classificações por chamada de usuário. | |
| Serviço SQL tempo de resposta. | |
| Porcentagem de uso do pool de fluxos. | |
| Total de varreduras de tabela por chamada de usuário. | |
| Total de varreduras de índice por segundo. | |
| Total de varreduras de índice por transação. | |
| Contagem total de análise por segundo. | |
| Contagem total de análise por transação. | |
| Total de varreduras de tabela por segundo. | |
| Total de varreduras de tabela por transação. | |
| Transação por logon. | |
| Chamadas do usuário por segundo. | |
| Chamadas de usuário por transação. | |
| Proporção de chamadas do usuário. | |
| Porcentagem de commits do usuário. | |
| O usuário confirma por segundo. | |
| Porcentagem de limite de usuário. | |
| Reversões de usuário por transação. | |
| Reversões do usuário por segundo. | |
| Registros de desfazer reversão do usuário aplicados por segundo. | |
| Registros de desfazer reversão do usuário aplicados por transação. | |
| Proporção do tempo de espera do banco de dados. | |
| Chamadas usadas capturadas | |
| Executar sem proporção de análise | |
| Logons por segundo | |
| Bytes de leitura física por segundo | |
| Solicitações de IO de leitura física por segundo | |
| Leituras físicas por segundo | |
| Bytes de gravação física por segundo | |
| Gravações físicas por segundo | |
| Número de leituras de bloco. | |
| Número de gravações de bloco. | |
| Leituras lógicas por chamada de usuário. | |
| Leituras físicas lobs diretos por segundo. | |
| Gravações físicas lobs diretos por segundo. | |
| Total de bytes de leitura física por segundo. | |
| Total de solicitações de I/O de leitura física por segundo. | |
| Leituras físicas diretas por segundo. | |
| Total de bytes de gravação física por segundo. | |
| Solicitações de I/O de gravação física por segundo. | |
| Gravações físicas diretas por segundo. | |
| Total de solicitações de I/O de gravação física por segundo. | |
| Número total de leituras físicas. | |
| Quantidade de tempo de leitura do arquivo. | |
| Classificação de disco por segundo. | |
| Classificação de disco por transação. | |
| Espaço temporário usado. | |
| Número total de gravações físicas. | |
| Quantidade de tempo de gravação do arquivo. | |
| Número de contas cujo | |
| Número de consultas de longa duração (> 60 anos). | |
| Buffer de ocorrência sem taxa de cache. | |
| Blocos de cache global corrompidos. | |
| Blocos de cache global perdidos. | |
| Quantidade atual de memória PGA alocada pela instância. | |
| Tamanho máximo de uma área de trabalho executada em modo automático. | |
| Número de bytes de memória PGA em todos os processos que podem ser liberados de volta para o sistema operacional. | |
| Indica quanta memória PGA está atualmente consumida pelas áreas de trabalho. Este número pode ser usado para determinar quanta memória é consumida por outro consumidor da memória PGA (por exemplo, PL/SQL ou Java). | |
| Proporção de acertos de alocação de refazer. | |
| Refaça os bytes gerados por segundo. | |
| Refazer bytes gerados por transação. | |
| Proporção de classificação de memória. | |
| Megabytes de I/O por segundo. | |
| Solicitações de I/O por segundo. | |
| Volume de tráfego de rede por segundo. | |
| Leituras físicas direcionam lobs por transação. | |
| Gravações físicas diretas por transação. | |
| Leituras físicas diretas por transação. | |
| Leituras físicas por transação. | |
| Gravações físicas diretas por transação. | |
| Gravações físicas por transação. | |
| Transação do usuário por segundo. | |
| Número de redo arquivo de log switch evento. | |
| Número de eventos de redo arquivo de log switch que precisam ser arquivados. | |
| Número de pontos de verificação de redo arquivo de log switch evento que estão incompletos. | |
| Número de esperas de redo log. | |
| Número de segmentos de reversão obtidos. | |
| Proporção de esperas por segmentos de reversão. | |
| Número de esperas de segmentos de reversão. | |
| Número de esperas ocupadas de buffer SGA. | |
| Tamanho fixo SGA. | |
| Número de buffer livre de SGA inspecionado. | |
| Número de esperas de buffer livre de SGA. | |
| Taxa de acerto para o SGA. | |
| Proporção de novas tentativas de alocações para o buffer de log SGA. | |
| Proporção de refazer alocação para o buffer de log SGA. | |
| Número de entradas Redo no buffer de log SGA. | |
| O espaço do buffer aguarda o buffer de log SGA. | |
| Buffers de redo SGA, em bytes. | |
| Taxa de falta para o cache do dicionário do pool compartilhado SGA (dict). | |
| Proporção de acertos para o cache da biblioteca do conjunto compartilhado SGA. | |
| Proporção de recarga para o cache da biblioteca do conjunto compartilhado SGA. | |
| Memória cacheável SGA por instrução, em bytes. | |
| Memória cacheável SGA por usuário, em bytes. | |
| Memória total na Área Global do usuário (UGA). | |
| Classifica o uso do disco, em bytes. | |
| Classifica o uso de memória, em bytes. |
Métrica de tablespace
A integração do Oracle banco de dados coleta a seguinte métrica de tablespace. Esses atributos podem ser encontrados consultando o tipo de evento OracleTablespaceSample
. Observe que as métricas de uso de tablespace não estão disponíveis para banco de dados standby somente leitura - leia mais sobre essa limitação na Oracle Knowledgebase aqui.
Métrica | Descrição | Estendido |
---|---|---|
| Booleano para status offline do espaço de tabela. | |
| O número de arquivos de dados PDB que estão offline. | |
| O número de arquivos de dados CDB que estão offline. | |
| O número de arquivos de dados PDB em estado não gravável. | |
| Quantidade consumida de espaço de tabela em bytes. | |
| Total de espaço de tabela reservado em bytes. | |
| Proporção entre o espaço de tabela usado e o total. |
Dados de inventário
A integração do Oracle banco de dados captura o parâmetro de configuração do banco de dados Oracle. Os dados estão disponíveis na página Inventário, na origem config/oracledb . Para obter mais informações sobre dados de inventário, consulte Compreender os dados de integração.
A integração captura dados para o seguinte parâmetro de configuração do Oracle banco de dados:
Resolução de problemas
Dicas de resolução de problemas:
Verifique o código-fonte
Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.