Monitoramento do Oracle Database com NRDOT

Visualização

Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!

Atualmente, esse recurso é fornecido como parte de uma prévia, de acordo com nossas políticas de pré-lançamento.

A New Relic agora capacita sua equipe a monitorar o desempenho do banco de dados Oracle usando a New Relic Distribution of OpenTelemetry (NRDOT) com os recursos de monitoramento de banco de dados da New Relic. Esta integração fornece insights abrangentes sobre métricas de banco de dados, desempenho de consultas e saúde do sistema usando o coletor NRDOT.

Essa abordagem baseada em NRDOT complementa nossa Integração On-Host (OHI) existente, utilizando padrões OpenTelemetry para monitoramento de banco de dados, facilitando a integração com sua stack de observabilidade existente.

Pré-requisitos

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

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
Para o banco de dados Oracle, você tem o Oracle Instant Client na máquina executando o coletor NRDOT

Configure o NRDOT Collector para o monitoramento do Oracle Database

Você pode configurar o monitoramento do Oracle Database usando o NRDOT Collector em ambientes on-host (multitenant) ou RDS. Selecione a configuração adequada com base no seu ambiente de banco de dados e siga as etapas.

Dica

O NRDOT Collector coleta dados de telemetria relacionados tanto à infraestrutura quanto ao banco de dados, para que você tenha uma solução de observabilidade unificada para o seu ambiente Oracle Database no New Relic.

Você pode configurar o monitoramento do Oracle Database usando o NRDOT Collector em ambientes on-host ou multitenant. Para instalar o NRDOT Collector em ambientes on-host (multitenant), siga estas etapas:

Método de instalação

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

Importante

Recomenda-se instalar o NRDOT Collector no mesmo host da sua instância do Oracle Database para visualizar métricas de nível de infraestrutura para o monitoramento de desempenho de consultas.

Para sistemas Debian/Ubuntu, execute:
bash
```
$curl -L -o nrdot-collector-host-linux-amd64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-amd64-latest
```

Para sistemas RHEL/CentOS/OEL, execute:

bash

$curl -L -o nrdot-collector-host-linux-amd64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.rpm
$sudo rpm -ivh nrdot-collector-host-linux-amd64-latest

Para sistemas Debian/Ubuntu, execute:

bash

$curl -L -o nrdot-collector-host-linux-arm64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-arm64-latest

Para sistemas RHEL/CentOS/OEL, execute:

bash

$curl -L -o nrdot-collector-host-linux-arm64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.rpm
$sudo rpm -ivh nrdot-collector-host-linux-arm64-latest

Configurar usuário do banco de dados

Crie um usuário de monitoramento com os privilégios necessários para seu Oracle Database multitenant. Isso requer a criação de um usuário comum com o prefixo C##.

Faça login no banco de dados raiz como administrador:
```
CREATE USER c##<YOUR_DB_USERNAME> IDENTIFIED BY "<USER_PASSWORD>";
```
Dica
Certifique-se de que sua USER_PASSWORD atenda aos requisitos de senha de novo usuário da Oracle.

Conceder privilégios de monitoramento para banco de dados multitenant

Execute as seguintes instruções SQL para conceder privilégios de monitoramento. Use o formato correto de nome de usuário com o prefixo C## para banco de dados multilocatário:

ALTER USER c##<YOUR_DB_USERNAME> SET CONTAINER_DATA=ALL CONTAINER=CURRENT;
GRANT CREATE SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SET CONTAINER TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT CONNECT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SYSSTAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SESSTAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$STATNAME TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SYSTEM_EVENT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SHARED_SERVER TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$DISPATCHER TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$CIRCUIT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$RESOURCE_LIMIT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$LOCK TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$DATABASE TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$PARAMETER TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SQLAREA TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SQL TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$SQL_PLAN TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.V_$PDBS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$INSTANCE TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SGA TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SESSTAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$STATNAME TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SYSSTAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SQLAREA TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$LIBRARYCACHE TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$ROWCACHE TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$PGASTAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$CONTAINERS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$PDBS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$CON_SYSMETRIC TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SYSMETRIC TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$FILESTAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SYSTEM_EVENT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$ACTIVE_SERVICES TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$SESSION_WAIT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON SYS.GV_$ROLLSTAT TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_OBJECTS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_TABLESPACES TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_DATA_FILES TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON DBA_USERS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_SERVICES TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_DATA_FILES TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_TABLESPACE_USAGE_METRICS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_USERS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON CDB_PDBS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON ALL_USERS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON ALL_VIEWS TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;
GRANT SELECT ON GLOBAL_NAME TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;

Configurar o NRDOT Collector

Edite seu arquivo config.yaml disponível em /etc/nrdot-collector-host/ e adicione o seguinte trecho de código:

Importante

Se você já é um usuário do NRDOT Collector, certifique-se de mesclar a configuração acima com o seu arquivo config.yaml existente. Isso inclui adicionar os novos receptores, processadores e exportadores para o monitoramento do Oracle Database, mantendo suas configurações atuais.

extensions:
  health_check:
receivers:
  otlp:
    protocols:
      grpc:
      http:
  hostmetrics:
    collection_interval: 60s
    scrapers:
      cpu:
        metrics:
          system.cpu.time:
            enabled: false
          system.cpu.utilization:
            enabled: true
      load:
      memory:
        metrics:
          system.memory.utilization:
            enabled: true
      paging:
        metrics:
          system.paging.utilization:
            enabled: false
          system.paging.faults:
            enabled: false
      filesystem:
        metrics:
          system.filesystem.utilization:
            enabled: true
      disk:
        metrics:
          system.disk.merged:
            enabled: false
          system.disk.pending_operations:
            enabled: false
          system.disk.weighted_io_time:
            enabled: false
      network:
        metrics:
          system.network.connections:
            enabled: false
      # Uncomment to enable process metrics, which can be noisy but valuable.
      # processes:
      # process:
      #   metrics:
      #     process.cpu.utilization:
      #       enabled: true
      #     process.cpu.time:
      #       enabled: false
  filelog:
    include:
      - /var/log/alternatives.log
      - /var/log/cloud-init.log
      - /var/log/auth.log
      - /var/log/dpkg.log
      - /var/log/syslog
      - /var/log/messages
      - /var/log/secure
      - /var/log/yum.log
  newrelicoracledb/cdb:
    endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    service: "<YOUR_CDB_SERVICE_NAME>"
    collection_interval: 30s
    timeout: 30s
    # enable_tablespace_scraper: true
    # enable_core_scraper: true
    # enable_system_scraper: true
    # enable_connection_scraper: true
    # enable_container_scraper: true
    # enable_database_info_scraper: true
  newrelicoracledb/pdb:
    endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    service: "<YOUR_CDB_SERVICE_NAME>"
    collection_interval: 30s
    timeout: 30s
    pdb_services: ["ALL"]
    # query_monitoring_response_time_threshold: 500
    # query_monitoring_count_threshold: 30
    # enable_query_monitoring: true
    # enable_pdb_scraper: true

processors:
  metricstransform:
    transforms:
      - include: system.cpu.utilization
        action: update
        operations:
          - action: aggregate_labels
            label_set: [ state ]
            aggregation_type: mean
      - include: system.paging.operations
        action: update
        operations:
          - action: aggregate_labels
            label_set: [ direction ]
            aggregation_type: sum
  filter/exclude_cpu_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'
  filter/exclude_memory_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'
  filter/exclude_memory_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'
  filter/exclude_filesystem_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'
  filter/exclude_filesystem_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'
  filter/exclude_filesystem_inodes_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'
  filter/exclude_system_disk:
    metrics:
      datapoint:
        - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'
  filter/exclude_system_paging:
    metrics:
      datapoint:
        - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
        - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'
  filter/exclude_network:
    metrics:
      datapoint:
        - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'
  attributes/exclude_system_paging:
    include:
      match_type: strict
      metric_names:
        - system.paging.operations
    actions:
      - key: type
        action: delete
  transform/clear_metadata:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
  filter/exec_plan_and_query_details_include:
    metrics:
      include:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details
  filter/exec_plan_and_query_details_exclude:
    metrics:
      exclude:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details
  cumulativetodelta/oracle:
    include:
      match_type: strict
      metrics:
        - newrelicoracledb.connection.bytes_received
        - newrelicoracledb.connection.bytes_sent
        - newrelicoracledb.connection.execute_count
        - newrelicoracledb.connection.logons_cumulative
        - newrelicoracledb.connection.parse_count_hard
        - newrelicoracledb.connection.parse_count_total
        - newrelicoracledb.connection.sqlnet_roundtrips
        - newrelicoracledb.connection.user_commits
        - newrelicoracledb.connection.user_rollbacks
  transform/host:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
  transform:
    trace_statements:
      - context: span
        statements:
          - truncate_all(span.attributes, 4095)
          - truncate_all(resource.attributes, 4095)
    log_statements:
      - context: log
        statements:
          - truncate_all(log.attributes, 4095)
          - truncate_all(resource.attributes, 4095)
  memory_limiter:
    check_interval: 1s
    limit_mib: ${env:NEW_RELIC_MEMORY_LIMIT_MIB:-100}
  batch:
  resourcedetection:
    detectors: ["system"]
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true
  resourcedetection/db_safe:
    detectors: ["system"]
    override: false
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true
  resourcedetection/cloud:
    detectors: ["gcp", "ec2", "azure"]
    timeout: 2s
    override: true
  resourcedetection/env:
    detectors: ["env"]
    timeout: 2s
    override: true

connectors:
  metricsaslogs:
    include_resource_attributes: true
    include_scope_info: true

exporters:
  otlp:
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
    headers:
      api-key: "<YOUR_NEWRELIC_API_KEY>"
    compression: gzip

service:
  pipelines:
    metrics/host:
      receivers: [hostmetrics]
      processors:
        - memory_limiter
        - metricstransform
        - filter/exclude_cpu_utilization
        - filter/exclude_memory_utilization
        - filter/exclude_memory_usage
        - filter/exclude_filesystem_utilization
        - filter/exclude_filesystem_usage
        - filter/exclude_filesystem_inodes_usage
        - filter/exclude_system_disk
        - filter/exclude_network
        - attributes/exclude_system_paging
        - transform/host
        - resourcedetection
        - resourcedetection/cloud
        - resourcedetection/env
        - cumulativetodelta/oracle
        - batch
      exporters: [otlp]
    traces:
      receivers: [otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
      exporters: [otlp]
    metrics:
      receivers: [otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
      exporters: [otlp]
    logs:
      receivers: [otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
      exporters: [otlp]
    metrics/oracledb:
      receivers: [newrelicoracledb/cdb, newrelicoracledb/pdb]
      processors: [memory_limiter, resourcedetection/db_safe, batch, transform/clear_metadata, filter/exec_plan_and_query_details_exclude]
      exporters: [otlp]
    metrics/exec_plan_and_query_details_to_logs:
      receivers: [newrelicoracledb/cdb, newrelicoracledb/pdb]
      processors: [filter/exec_plan_and_query_details_include]
      exporters: [metricsaslogs]
    logs/oracledb:
      receivers: [metricsaslogs]
      processors: [memory_limiter, resourcedetection/db_safe, batch]
      exporters: [otlp]
  extensions: [health_check]

Defina os seguintes parâmetros obrigatórios no arquivo de configuração:

Parâmetro	Descrição
`<YOUR_DB_HOST>`	Insira o nome do host do banco de dados Oracle.
`<YOUR_DB_PORT>`	Insira a porta do seu banco de dados Oracle.
`<USERNAME>`	Insira seu nome de usuário do banco de dados.
`<PASSWORD>`	Insira a senha do seu banco de dados.
`<YOUR_CDB_SERVICE_NAME>`	Insira o nome do serviço Oracle.
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	Insira o endpoint OTLP da New Relic. Para mais informações, consulte a documentação dos endpoints OTLP da New Relic.
`<YOUR_NEWRELIC_API_KEY>`	Insira sua chave de API da New Relic.
`pdb_services`	Selecione os serviços PDB para monitorar nas opções a seguir: Vazio ou nulo: Coletar apenas dados de serviço especificados `["ALL"]`: Coletar todos os serviços de PDB (excluindo CDB) `["pdb1", "pdb2"]`: Coletar apenas serviços de PDB especificados
`enable_query_monitoring`	Obtenha métricas de monitoramento de consultas, como sessões lentas, ativas, em espera, de bloqueio e plano de execução. O valor padrão é definido como `false`
`query_monitoring_response_time_threshold`	Defina o limite para o tempo de resposta da consulta (em ms). Captura as consultas que ultrapassam este limiar. O valor padrão é definido como 500ms.
`query_monitoring_count_threshold`	O número de registros para cada métrica de desempenho de consulta. O valor padrão é definido como 30

Dica

Para informações mais detalhadas sobre a configuração do endpoint OTLP da New Relic e as melhores práticas do OpenTelemetry, consulte a documentação do OpenTelemetry OTLP.

Reiniciar o coletor NRDOT

Após atualizar a configuração, reinicie o coletor NRDOT:

bash

$sudo systemctl restart nrdot-collector-host
$sudo systemctl status nrdot-collector-host

Dica

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

(Opcional) Configuração de multirreceptor

O binário nrdot-collector-host suporta uma configuração de múltiplos receptores em um único config.yaml para monitorar várias instâncias de banco de dados Oracle usando credenciais exclusivas. O exemplo config.yaml abaixo demonstra como configurar vários receptores para diferentes instâncias no host (multilocatárias), compartilhando processadores e exportadores comuns.

receivers:
  newrelicoracledb/cdb1:
    endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    service: "<YOUR_CDB1_SERVICE_NAME>"
    collection_interval: 30s
    timeout: 30s
    # enable_tablespace_scraper: true
    # enable_core_scraper: true
    # enable_system_scraper: true
    # enable_connection_scraper: true
    # enable_container_scraper: true
    # enable_database_info_scraper: true

  # First CDB's PDB configuration
  newrelicoracledb/pdb1:
    endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    service: "<YOUR_CDB2_SERVICE_NAME>"
    collection_interval: 30s
    timeout: 30s
    pdb_services: ["ALL"]
    # query_monitoring_response_time_threshold: 500
    # query_monitoring_count_threshold: 30
    # enable_query_monitoring: true
    # enable_pdb_scraper: true

  # Second CDB configuration
  newrelicoracledb/cdb2:
    endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    service: "<YOUR_CDB2_SERVICE_NAME>"
    collection_interval: 30s
    timeout: 30s
    # enable_tablespace_scraper: true
    # enable_core_scraper: true
    # enable_system_scraper: true
    # enable_connection_scraper: true
    # enable_container_scraper: true
    # enable_database_info_scraper: true

  # Second CDB's PDB configuration
  newrelicoracledb/pdb2:
    endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    service: "<YOUR_CDB2_SERVICE_NAME>"
    collection_interval: 30s
    timeout: 30s
    pdb_services: ["ALL"]
    # query_monitoring_response_time_threshold: 500
    # query_monitoring_count_threshold: 30
    # enable_query_monitoring: true
    # enable_pdb_scraper: true

processors:
  memory_limiter/oracle:
    check_interval: 1s
    limit_mib: ${env:NEW_RELIC_MEMORY_LIMIT_MIB:-100}

  cumulativetodelta/oracle:
    include:
      match_type: strict
      metrics:
        - newrelicoracledb.connection.bytes_received
        - newrelicoracledb.connection.bytes_sent
        - newrelicoracledb.connection.execute_count
        - newrelicoracledb.connection.logons_cumulative
        - newrelicoracledb.connection.parse_count_hard
        - newrelicoracledb.connection.parse_count_total
        - newrelicoracledb.connection.sqlnet_roundtrips
        - newrelicoracledb.connection.user_commits
        - newrelicoracledb.connection.user_rollbacks

  transform/oracle_clear_metadata:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
    log_statements:
      - context: log
        statements:
          - set(body, "")

  filter/exec_plan_and_query_details_include:
    metrics:
      include:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details

  filter/exec_plan_and_query_details_exclude:
    metrics:
      exclude:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details

  resourcedetection/oracle_db_safe:
    detectors: ["system"]
    override: false
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true

connectors:
  metricsaslogs/oracle:
    include_resource_attributes: true
    include_scope_info: true

service:
  pipelines:
    metrics/oracledb:
      receivers: [newrelicoracledb/cdb1, newrelicoracledb/pdb1, newrelicoracledb/cdb2, newrelicoracledb/pdb2]
      processors: [memory_limiter/oracle, cumulativetodelta/oracle, transform/oracle_clear_metadata, filter/exec_plan_and_query_details_exclude, resourcedetection/oracle_db_safe]
      exporters: [otlp]

    metrics/oracle_query_to_logs:
      receivers: [newrelicoracledb/cdb1, newrelicoracledb/pdb1, newrelicoracledb/cdb2, newrelicoracledb/pdb2]
      processors: [memory_limiter/oracle, filter/exec_plan_and_query_details_include]
      exporters: [metricsaslogs/oracle]

    logs/oracledb:
      receivers: [metricsaslogs/oracle]
      processors: [memory_limiter/oracle, transform/oracle_clear_metadata, resourcedetection/oracle_db_safe]
      exporters: [otlp]

Dica

Esta configuração permite monitorar múltiplas instâncias do Oracle RDS simultaneamente. Cada instância recebe sua própria configuração de receptor com credenciais exclusivas, enquanto compartilha processadores e exportadores comuns. Ajuste o collection_interval e outros parâmetros com base em seus requisitos de monitoramento.
Reinicie o coletor NRDOT após atualizar a configuração para aplicar as alterações.

(Opcional) Configurar a correlação entre APM e banco de dados

Para correlacionar o desempenho da sua aplicação com as operações de banco de dados, você pode configurar a identificação de serviço de banco de dados. Este recurso permite visualizar exatamente quais aplicativos estão gerando workloads específicas de banco de dados. Para mais informações, consulte configurar a identificação de serviço de banco de dados para obter a correlação APM-banco de dados no New Relic.

Importante

Para visualizar dados de desempenho do banco de dados no APM, ambas as entidades devem estar na mesma conta New Relic. Se as entidades estiverem em contas diferentes da New Relic, você deve ter acesso a ambas as contas para visualizar os dados.

(Opcional) Configurar o gerenciamento de segredos

O recurso de gerenciamento de segredos permite 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. Para mais informações, consulte gerenciamento de segredos.

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 usuário 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 na lista de entidades.

Para instalar o NRDOT Collector em ambientes RDS, siga estas etapas:

Método de instalação

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

Para sistemas Debian/Ubuntu, execute:

bash

$curl -L -o nrdot-collector-host-linux-amd64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-amd64-latest

Para sistemas RHEL/CentOS/OEL, execute:

bash

$curl -L -o nrdot-collector-host-linux-amd64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.rpm
$sudo rpm -ivh nrdot-collector-host-linux-amd64-latest

Para sistemas Debian/Ubuntu, execute:

bash

$curl -L -o nrdot-collector-host-linux-arm64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-arm64-latest

Para sistemas RHEL/CentOS/OEL, execute:

bash

$curl -L -o nrdot-collector-host-linux-arm64-latest https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.rpm
$sudo rpm -ivh nrdot-collector-host-linux-arm64-latest

Configurar usuário do banco de dados

Crie um usuário de monitoramento com os privilégios necessários para o seu banco de dados RDS Oracle.

Faça login no banco de dados raiz como administrador:

CREATE USER <USERNAME> IDENTIFIED BY "<USER_PASSWORD>";

Conceda privilégios CONNECT ao usuário recém-criado:
```
GRANT CONNECT TO <USERNAME>;
```

Conceder privilégios de monitoramento para o banco de dados RDS

Execute as seguintes instruções SQL para conceder privilégios de monitoramento. Substitua <USERNAME_IN_UPPERCASE> pelo seu nome de usuário em letras maiúsculas:

SET SERVEROUTPUT ON;
BEGIN
    FOR r IN (SELECT column_value as view_name FROM table(sys.odcivarchar2list(
                'V_$SESSION', 'V_$SYSSTAT', 'V_$SESSTAT', 'V_$STATNAME', 
                'V_$SYSTEM_EVENT', 'V_$SHARED_SERVER', 'V_$DISPATCHER', 
                'V_$RESOURCE_LIMIT', 'V_$LOCK', 'V_$DATABASE', 
                'V_$PARAMETER', 'V_$SQLAREA', 'V_$SQL', 'V_$SQL_PLAN', 
                'V_$PDBS', 'GV_$INSTANCE', 'GV_$SGA', 'GV_$SESSTAT', 
                'GV_$STATNAME', 'GV_$SYSSTAT', 'GV_$SQLAREA', 
                'GV_$LIBRARYCACHE', 'GV_$ROWCACHE', 'GV_$PGASTAT', 
                'GV_$CONTAINERS', 'GV_$PDBS', 'GV_$CON_SYSMETRIC', 
                'GV_$SYSMETRIC', 'GV_$FILESTAT', 'GV_$SYSTEM_EVENT', 
                'GV_$ACTIVE_SERVICES', 'GV_$SESSION', 'GV_$SESSION_WAIT', 
                'GV_$ROLLSTAT', 'DBA_OBJECTS', 'DBA_TABLESPACES', 
                'DBA_TABLESPACE_USAGE_METRICS', 'DBA_DATA_FILES', 'DBA_USERS', 
                'CDB_SERVICES', 'CDB_DATA_FILES', 'CDB_TABLESPACE_USAGE_METRICS', 
                'CDB_USERS', 'CDB_PDBS', 'ALL_USERS', 'ALL_VIEWS', 'GLOBAL_NAME'
            ))) LOOP
      BEGIN
          rdsadmin.rdsadmin_util.grant_sys_object(
            p_obj_name  => r.view_name, 
            p_grantee   => '<USERNAME_IN_UPPERCASE>', 
            p_privilege => 'SELECT'
          );
      EXCEPTION 
          WHEN OTHERS THEN 
            DBMS_OUTPUT.PUT_LINE('FAILED: ' || r.view_name || ' | Error: ' || SQLERRM);
      END;
    END LOOP;
END;
/

Configurar o NRDOT Collector

Edite seu arquivo config.yaml disponível em /etc/nrdot-collector-host/ e adicione o seguinte trecho de código:

Importante

receivers:
  newrelicoracledb/pdb:
    endpoint: "<YOUR_DB_HOST>:<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    service: "<PDB_NAME>"
    collection_interval: 30s
    timeout: 30s
    # pdb_services: ['PDB1','PDB2'] #for multiple pdbs
    # query_monitoring_response_time_threshold: 500
    # query_monitoring_count_threshold: 30
    # enable_query_monitoring: true
    # enable_pdb_scraper: true
    # enable_tablespace_scraper: true
    # enable_core_scraper: true
    # enable_system_scraper: true
    # enable_connection_scraper: true
    # enable_container_scraper: true
    # enable_database_info_scraper: true
processors:
  transform/clear_metadata:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
    log_statements:
      - context: log
        statements:
          - set(log.body, "")
  filter/exec_plan_and_query_details_include:
    metrics:
      include:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details
  filter/exec_plan_and_query_details_exclude:
    metrics:
      exclude:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details
  cumulativetodelta:
    include:
      match_type: strict
      metrics:
        - newrelicoracledb.connection.bytes_received
        - newrelicoracledb.connection.bytes_sent
        - newrelicoracledb.connection.execute_count
        - newrelicoracledb.connection.logons_cumulative
        - newrelicoracledb.connection.parse_count_hard
        - newrelicoracledb.connection.parse_count_total
        - newrelicoracledb.connection.sqlnet_roundtrips
        - newrelicoracledb.connection.user_commits
        - newrelicoracledb.connection.user_rollbacks        
connectors:
  metricsaslogs:
    include_resource_attributes: true
    include_scope_info: true 
exporters:
  otlp:
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>" 
    headers:
      api-key: "<YOUR_NEWRELIC_API_KEY>"
    compression: gzip
service:
  pipelines:
    metrics:
      receivers: [newrelicoracledb/pdb]
      processors: [transform/clear_metadata, filter/exec_plan_and_query_details_exclude, cumulativetodelta]
      exporters: [otlp]
    metrics/exec_plan_and_query_details_to_logs:
      receivers: [newrelicoracledb/pdb]
      processors: [filter/exec_plan_and_query_details_include]
      exporters: [metricsaslogs]
    logs/newrelicoracledb:
      receivers: [metricsaslogs]
      processors: [transform/clear_metadata]
      exporters: [otlp]

Defina os seguintes parâmetros obrigatórios no arquivo de configuração:

Parâmetro	Descrição
`<YOUR_DB_HOST>`	Insira o nome do host do banco de dados Oracle.
`<YOUR_DB_PORT>`	Insira a porta do seu banco de dados Oracle.
`<USERNAME>`	Insira seu nome de usuário do banco de dados.
`<PASSWORD>`	Insira a senha do seu banco de dados.
`<PDB_NAME>`	Insira o nome do serviço PDB.
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	Insira o endpoint OTLP da New Relic. Para mais informações, consulte a documentação dos endpoints OTLP da New Relic.
`<YOUR_NEWRELIC_API_KEY>`	Insira sua chave de API da New Relic.
`pdb_services`	Selecione os serviços PDB para monitorar nas opções a seguir: Vazio ou nulo: Coletar apenas dados de serviço especificados `["pdb1", "pdb2"]`: Coletar apenas serviços de PDB especificados
`enable_query_monitoring`	Obtenha métricas de monitoramento de consultas, como sessões lentas, ativas, em espera, de bloqueio e plano de execução. O valor padrão é definido como `false`
`query_monitoring_response_time_threshold`	Defina o limite para o tempo de resposta da consulta (em ms). Captura as consultas que ultrapassam este limiar. O valor padrão é definido como 500ms.
`query_monitoring_count_threshold`	O número de registros para cada métrica de desempenho de consulta. O valor padrão é definido como 30

Reiniciar o coletor NRDOT

Após atualizar a configuração, reinicie o coletor NRDOT:

bash

$sudo systemctl restart nrdot-collector-host
$sudo systemctl status nrdot-collector-host

Dica

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

(Opcional) Configuração de multirreceptor

O binário nrdot-collector-host suporta uma configuração de múltiplos receptores em um único config.yaml para monitorar várias instâncias de banco de dados Oracle usando credenciais exclusivas. O exemplo config.yaml abaixo demonstra como configurar vários receptores para diferentes instâncias RDS, compartilhando processadores e exportadores comuns.

receivers:
  # First RDS Instance
  newrelicoracledb/pdb/rds1:
    endpoint: "<YOUR_DB_HOST_1>:<YOUR_DB_PORT_1>"
    username: "<USERNAME_1>"
    password: "<PASSWORD_1>"
    service: "<PDB_NAME_1>"
    collection_interval: 30s
    timeout: 30s
    # query_monitoring_response_time_threshold: 500
    # query_monitoring_count_threshold: 30
    # enable_query_monitoring: true

  # Second RDS Instance
  newrelicoracledb/pdb/rds2:
    endpoint: "<YOUR_DB_HOST_2>:<YOUR_DB_PORT_2>"
    username: "<USERNAME_2>"
    password: "<PASSWORD_2>"
    service: "<PDB_NAME_2>"
    collection_interval: 30s
    timeout: 30s
    # query_monitoring_response_time_threshold: 500
    # query_monitoring_count_threshold: 30
    # enable_query_monitoring: true

processors:
  transform/clear_metadata:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")
    log_statements:
      - context: log
        statements:
          - set(log.body, "")

  filter/exec_plan_and_query_details_include:
    metrics:
      include:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details

  filter/exec_plan_and_query_details_exclude:
    metrics:
      exclude:
        match_type: strict
        metric_names:
          - newrelicoracledb.execution_plan
          - newrelicoracledb.slow_queries.query_details

connectors:
  metricsaslogs:
    include_resource_attributes: true
    include_scope_info: true

exporters:
  otlp:
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
    headers:
      api-key: "<YOUR_NEWRELIC_API_KEY>"
    compression: gzip

service:
  pipelines:
    # Separate metrics pipelines to apply unique resource names
    metrics/rds1:
      receivers: [newrelicoracledb/pdb/rds1]
      processors: [transform/clear_metadata, filter/exec_plan_and_query_details_exclude]
      exporters: [otlp]
    
    metrics/rds2:
      receivers: [newrelicoracledb/pdb/rds2]
      processors: [transform/clear_metadata, filter/exec_plan_and_query_details_exclude]
      exporters: [otlp]

    # Combined logs pipeline for execution plans and query details
    metrics/exec_plan_and_query_details_to_logs:
      receivers: [newrelicoracledb/pdb/rds1, newrelicoracledb/pdb/rds2]
      processors: [filter/exec_plan_and_query_details_include]
      exporters: [metricsaslogs]

    logs/newrelicoracledb:
      receivers: [metricsaslogs]
      processors: [transform/clear_metadata]
      exporters: [otlp]

Dica

Esta configuração permite monitorar múltiplas instâncias do Oracle RDS simultaneamente. Cada instância recebe sua própria configuração de receptor com credenciais exclusivas, enquanto compartilha processadores e exportadores comuns. Ajuste o collection_interval e outros parâmetros com base em seus requisitos de monitoramento.
Reinicie o coletor NRDOT após atualizar a configuração para aplicar as alterações.

(Opcional) Configurar a correlação entre APM e banco de dados

Importante

Para visualizar dados de desempenho do banco de dados no APM, ambas as entidades devem estar na mesma conta da New Relic. Se as entidades estiverem em contas diferentes, você deve ter acesso a ambas as contas para visualizar os dados.

(Opcional) Configurar o gerenciamento de segredos

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 usuário 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 na lista de entidades.

Comandos suportados pelo coletor NRDOT

Esta seção fornece uma lista de comandos comuns para gerenciar o serviço NRDOT Collector no seu sistema.

Para validar o status da instalação:
- Para distribuições baseadas em Debian/Ubuntu:
  bash
```
$dpkg -l | grep nrdot-collector-host
```
- Para distribuições baseadas em RHEL/CentOS:
  bash
```
$rpm -q nrdot-collector-host || ls /etc/nrdot-collector-host
```

Para reiniciar o NRDOT Collector:

bash

$sudo systemctl restart nrdot-collector-host

Para verificar o status do NRDOT Collector:
bash
```
$sudo systemctl status nrdot-collector-host
```

Para visualizar os logs do NRDOT Collector:

bash

$sudo journalctl -u nrdot-collector-host -n 50 --no-pager

Para excluir o serviço NRDOT Collector:
- Para distribuições baseadas em Debian/Ubuntu:
  bash
```
$sudo apt purge nrdot-collector-host
```
- Para distribuições baseadas em RHEL/CentOS:
  bash
```
$sudo yum erase nrdot-collector-host
```

Para limpar arquivos de configuração:

bash

$# Clean up configuration and reload systemd
$sudo rm -rf /etc/nrdot-collector-host/
$sudo systemctl daemon-reload

Métricas disponíveis

Monitore o desempenho do banco de dados Oracle com métricas organizadas por flags de configuração. Métricas padrão são coletadas automaticamente para a funcionalidade da interface do New Relic. Você também pode usar as métricas adicionais fornecidas para obter insights avançados e mais profundos ao ativar scrapers específicos.

Métrica padrão

Essas métricas são essenciais para os recursos de monitoramento de banco de dados Oracle da New Relic e são coletadas automaticamente, independentemente da sua configuração.

Nome da métrica	Descrição
`newrelicoracledb.child_cursors.details`	Detalhes sobre cursores filhos no banco de dados Oracle
`newrelicoracledb.child_cursors.elapsed_time`	Tempo decorrido para operações de cursor filho
`newrelicoracledb.connection.active_sessions`	Número de sessões ativas do banco de dados Oracle
`newrelicoracledb.connection.execute_count`	Número de execuções de SQL
`newrelicoracledb.connection.inactive_sessions`	Número de sessões inativas do banco de dados Oracle
`newrelicoracledb.connection.total_sessions`	Número total de sessões do banco de dados Oracle
`newrelicoracledb.memory.pga_max_size_bytes`	Limite global de memória para PGA em bytes
`newrelicoracledb.sessions.count`	Número total de sessões ativas de banco de dados Oracle
`newrelicoracledb.sga_hit_ratio`	Taxa de acerto da SGA (eficiência do buffer cache)
`newrelicoracledb.sga_shared_pool_library_cache_hit_ratio`	Taxa de acerto do cache de biblioteca para o namespace SQL AREA
`newrelicoracledb.slow_queries.execution_count`	Contagem de execuções de consultas lentas
`newrelicoracledb.slow_queries.interval_avg_cpu_time`	Tempo médio de CPU para consultas lentas no intervalo
`newrelicoracledb.slow_queries.interval_avg_elapsed_time`	Tempo médio decorrido para consultas lentas no intervalo
`newrelicoracledb.slow_queries.interval_buffer_gets`	Buffer gets para consultas lentas no intervalo
`newrelicoracledb.slow_queries.interval_cpu_time`	Tempo de CPU para consultas lentas no intervalo
`newrelicoracledb.slow_queries.interval_elapsed_time`	Tempo decorrido para consultas lentas no intervalo
`newrelicoracledb.slow_queries.interval_execution_count`	Contagem de execução para consultas lentas no intervalo
`newrelicoracledb.slow_queries.interval_rows_processed`	Linhas processadas para consultas lentas no intervalo
`newrelicoracledb.slow_queries.interval_wait_time`	Tempo de espera para consultas lentas no intervalo
`newrelicoracledb.slow_queries.query_details`	Informações detalhadas sobre consultas lentas
`newrelicoracledb.slow_queries.total_cpu_time`	Tempo total de CPU para consultas lentas
`newrelicoracledb.slow_queries.total_elapsed_time`	Tempo total decorrido para consultas lentas
`newrelicoracledb.slow_queries.total_rows_examined`	Total de linhas examinadas por consultas lentas
`newrelicoracledb.slow_queries.total_rows_returned`	Total de linhas retornadas por consultas lentas
`newrelicoracledb.slow_queries.total_wait_time`	Tempo total de espera para consultas lentas
`newrelicoracledb.system.average_active_sessions`	Média de sessões ativas simultâneas
`newrelicoracledb.system.buffer_cache_hit_ratio`	Taxa de acerto do cache de buffer
`newrelicoracledb.system.database_cpu_time_ratio`	Taxa de tempo de CPU do banco de dados
`newrelicoracledb.system.enqueue_waits_per_second`	Taxa de contenção de enfileiramento
`newrelicoracledb.system.executions_per_second`	Taxa de execução de SQL
`newrelicoracledb.system.hard_parse_count_per_second`	Taxa de hard parse
`newrelicoracledb.system.host_cpu_utilization`	Porcentagem de uso de CPU do host
`newrelicoracledb.system.io_megabytes_per_second`	Taxa de transferência de E/S em MB/s
`newrelicoracledb.system.physical_reads_per_second`	Taxa de leitura física
`newrelicoracledb.system.physical_writes_per_second`	Taxa de gravação física
`newrelicoracledb.system.redo_generated_bytes_per_second`	Taxa de geração de redo
`newrelicoracledb.system.response_time_per_transaction`	Tempo de resposta por transação
`newrelicoracledb.system.transactions_per_second`	Taxa de transações por segundo
`newrelicoracledb.wait_events.current_wait_time_ms`	Tempo de espera atual para eventos de banco de dados em milissegundos

Métricas adicionais

Ative essas métricas adicionais conforme necessário para obter insights mais profundos sobre o desempenho e a saúde do seu banco de dados Oracle.

Ative o enable_tablespace_scraper: true para coletar estas métricas:

Nome da métrica	Descrição
`newrelicoracledb.tablespace.space_consumed_bytes`	Espaço usado em bytes por tablespace
`newrelicoracledb.tablespace.space_reserved_bytes`	Espaço total alocado em bytes por tablespace
`newrelicoracledb.tablespace.space_used_percentage`	Porcentagem de uso por tablespace
`newrelicoracledb.tablespace.is_offline`	Status offline da tablespace (1=offline, 0=online)
`newrelicoracledb.tablespace.global_name`	Nome global do banco de dados marcado por tablespace
`newrelicoracledb.tablespace.db_id`	ID do banco de dados marcado por tablespace
`newrelicoracledb.tablespace.offline_cdb_datafiles`	Contagem de arquivos de dados offline em tablespaces do CDB
`newrelicoracledb.tablespace.offline_pdb_datafiles`	Contagem de arquivos de dados offline em tablespaces de PDB
`newrelicoracledb.tablespace.pdb_non_write_mode`	Contagem de tablespaces de PDB que não estão em modo de gravação

Ative o enable_core_scraper: true para coletar estas métricas:

Nome da métrica	Descrição
`newrelicoracledb.memory.pga_in_use_bytes`	Memória PGA total atualmente em uso em bytes
`newrelicoracledb.memory.pga_allocated_bytes`	Total de memória PGA alocada em bytes
`newrelicoracledb.memory.pga_freeable_bytes`	Total de memória PGA liberável em bytes
`newrelicoracledb.memory.sga_uga_total_bytes`	Memória total SGA UGA em bytes
`newrelicoracledb.memory.sga_shared_pool_library_cache_sharable_bytes`	Memória compartilhável do cache da biblioteca do pool compartilhado da SGA em bytes
`newrelicoracledb.memory.sga_shared_pool_library_cache_user_bytes`	Memória compartilhável do cache de biblioteca do pool compartilhado da SGA por usuário em bytes
`newrelicoracledb.sga_shared_pool_library_cache_reload_ratio`	Taxa de recarregamento do cache da biblioteca (recarregamentos/fixações)
`newrelicoracledb.sga_shared_pool_dict_cache_miss_ratio`	Taxa de falhas do cache de dicionário (getmisses/gets)
`newrelicoracledb.sga_log_buffer_space_waits`	Número de sessões aguardando espaço no buffer de log
`newrelicoracledb.sga_log_allocation_retries_ratio`	Taxa de novas tentativas de alocação de log
`newrelicoracledb.sga_fixed_size_bytes`	Memória de tamanho fixo da SGA em bytes
`newrelicoracledb.sga_redo_buffers_bytes`	Memória dos buffers de redo da SGA em bytes
`newrelicoracledb.disk.reads`	Número de leituras de disco físico
`newrelicoracledb.disk.writes`	Número de gravações em disco físico
`newrelicoracledb.disk.blocks_read`	Número de blocos físicos lidos do disco
`newrelicoracledb.disk.blocks_written`	Número de blocos físicos gravados em disco
`newrelicoracledb.disk.read_time_milliseconds`	Tempo gasto lendo do disco em milissegundos
`newrelicoracledb.disk.write_time_milliseconds`	Tempo gasto gravando no disco em milissegundos
`newrelicoracledb.global_name`	Informações do nome global do banco de dados Oracle
`newrelicoracledb.db_id`	Informações de ID do banco de dados Oracle
`newrelicoracledb.locked_accounts`	Contagem de contas de usuário bloqueadas no banco de dados
`newrelicoracledb.long_running_queries`	Número de consultas de longa duração
`newrelicoracledb.sga_log_buffer_redo_allocation_retries`	Número de novas tentativas de alocação do buffer de redo
`newrelicoracledb.sga_log_buffer_redo_entries`	Número de entradas de redo
`newrelicoracledb.sorts_memory`	Número de ordenações realizadas em memória
`newrelicoracledb.sorts_disk`	Número de ordenações realizadas em disco
`newrelicoracledb.rollback_segments_gets`	Número de obtenções nos segmentos de rollback
`newrelicoracledb.rollback_segments_waits`	Número de esperas em segmentos de rollback
`newrelicoracledb.rollback_segments_wait_ratio`	Taxa de espera de segmentos de rollback (esperas/obtenções)
`newrelicoracledb.redo_log_parallel_write_waits`	Número de esperas por eventos de gravação paralela em arquivo de log
`newrelicoracledb.redo_log_switch_completion_waits`	Número de esperas por eventos de conclusão de alternância de arquivo de log
`newrelicoracledb.redo_log_switch_checkpoint_incomplete_waits`	Número de esperas por eventos de alternância de arquivo de log (checkpoint incompleto)
`newrelicoracledb.redo_log_switch_archiving_needed_waits`	Número de esperas por eventos de alternância de arquivo de log (arquivamento necessário)
`newrelicoracledb.sga_buffer_busy_waits`	Número de eventos de buffer busy waits
`newrelicoracledb.sga_free_buffer_waits`	Número de eventos de esperas de buffer livre
`newrelicoracledb.sga_free_buffer_inspected_waits`	Número de eventos de espera de buffers livres inspecionados

Ative o enable_system_scraper: true para coletar estas métricas:

Nome da métrica	Descrição
`newrelicoracledb.system.active_parallel_sessions`	Sessões paralelas ativas
`newrelicoracledb.system.active_serial_sessions`	Sessões seriais ativas
`newrelicoracledb.system.background_checkpoints_per_second`	Checkpoints em segundo plano por seg
`newrelicoracledb.system.background_cpu_usage_per_second`	Uso de CPU em segundo plano por seg
`newrelicoracledb.system.background_time_per_second`	Tempo em segundo plano por s
`newrelicoracledb.system.branch_node_splits_per_second`	Divisões de nó de ramificação por seg
`newrelicoracledb.system.branch_node_splits_per_transaction`	Divisões de nó de ramificação por transação
`newrelicoracledb.system.captured_user_calls`	Chamadas de usuário capturadas
`newrelicoracledb.system.consistent_read_changes_per_second`	Alterações de Leitura Consistente por Seg
`newrelicoracledb.system.consistent_read_changes_per_transaction`	Alterações de Leitura Consistente por Txn
`newrelicoracledb.system.consistent_read_gets_per_second`	Obtenções de Leitura Consistente Por Seg
`newrelicoracledb.system.consistent_read_gets_per_transaction`	Gets de leitura consistente por transação
`newrelicoracledb.system.cpu_usage_per_second`	Uso de CPU por seg
`newrelicoracledb.system.cpu_usage_per_transaction`	Uso de CPU por transação
`newrelicoracledb.system.cr_blocks_created_per_second`	Blocos CR Criados Por Seg
`newrelicoracledb.system.cr_blocks_created_per_transaction`	Blocos CR Criados por Transação
`newrelicoracledb.system.cr_undo_records_applied_per_second`	Registros de Desfazer de CR Aplicados Por Seg
`newrelicoracledb.system.cr_undo_records_applied_per_transaction`	Registros de Undo de CR Aplicados por Transação
`newrelicoracledb.system.current_logons_count`	Contagem de Logons Atuais
`newrelicoracledb.system.current_open_cursors_count`	Contagem atual de cursores abertos
`newrelicoracledb.system.current_os_load`	Carga atual do SO
`newrelicoracledb.system.cursor_cache_hit_ratio`	Taxa de acerto do cache do cursor
`newrelicoracledb.system.database_time_per_second`	Tempo de banco de dados por segundo
`newrelicoracledb.system.database_wait_time_ratio`	Taxa de tempo de espera do banco de dados
`newrelicoracledb.system.db_block_changes_per_second`	Alterações de Bloco do Banco de Dados por Seg
`newrelicoracledb.system.db_block_changes_per_transaction`	Alterações de Bloco de BD por Transação
`newrelicoracledb.system.db_block_changes_per_user_call`	Alterações de Bloco do BD por Chamada de Usuário
`newrelicoracledb.system.db_block_gets_per_second`	Gets de Bloco do BD Por Seg
`newrelicoracledb.system.db_block_gets_per_transaction`	DB Block Gets por Transação
`newrelicoracledb.system.db_block_gets_per_user_call`	Gets de Bloco do BD por Chamada de Usuário
`newrelicoracledb.system.dbwr_checkpoints_per_second`	Checkpoints do DBWR Por Seg
`newrelicoracledb.system.disk_sort_per_second`	Classificação de Disco Por Seg
`newrelicoracledb.system.disk_sort_per_transaction`	Ordenação em Disco por Txn
`newrelicoracledb.system.enqueue_deadlocks_per_second`	Deadlocks de Enfileiramento Por Seg
`newrelicoracledb.system.enqueue_deadlocks_per_transaction`	Deadlocks de Enqueue por Transação
`newrelicoracledb.system.enqueue_requests_per_second`	Solicitações Enfileiradas por Seg
`newrelicoracledb.system.enqueue_requests_per_transaction`	Requisições de Enfileiramento por Transação
`newrelicoracledb.system.enqueue_timeouts_per_second`	Timeouts de Enfileiramento Por Seg
`newrelicoracledb.system.enqueue_timeouts_per_transaction`	Timeouts de Enfileiramento Por Transação
`newrelicoracledb.system.enqueue_waits_per_transaction`	Esperas de Enqueue por Transação
`newrelicoracledb.system.execute_without_parse_ratio`	Taxa de execução sem análise
`newrelicoracledb.system.executions_per_transaction`	Execuções por transação
`newrelicoracledb.system.executions_per_user_call`	Execuções por chamada de usuário
`newrelicoracledb.system.full_index_scans_per_second`	Varreduras Completas de Índice Por Seg
`newrelicoracledb.system.full_index_scans_per_transaction`	Varreduras completas de índice por transação
`newrelicoracledb.system.gc_cr_block_received_per_second`	Blocos CR do GC Recebidos por Seg (RAC)
`newrelicoracledb.system.gc_cr_block_received_per_transaction`	Bloco CR do GC Recebido Por Transação (RAC)
`newrelicoracledb.system.gc_current_block_received_per_second`	Bloco Atual do GC Recebido Por Seg (RAC)
`newrelicoracledb.system.gc_current_block_received_per_transaction`	Bloco Atual do GC Recebido Por Transação (RAC)
`newrelicoracledb.system.global_cache_average_cr_get_time`	Tempo Médio de Obtenção de CR do Cache Global (RAC)
`newrelicoracledb.system.global_cache_average_current_get_time`	Tempo Médio de Obtenção Atual do Cache Global (RAC)
`newrelicoracledb.system.global_cache_blocks_corrupted`	Blocos do Cache Global Corrompidos (RAC)
`newrelicoracledb.system.global_cache_blocks_lost`	Blocos Perdidos do Cache Global (RAC)
`newrelicoracledb.system.hard_parse_count_per_transaction`	Contagem de Hard Parse por Transação
`newrelicoracledb.system.host_cpu_usage_per_second`	Uso de CPU do Host por Seg
`newrelicoracledb.system.io_requests_per_second`	Requisições de E/S por segundo
`newrelicoracledb.system.leaf_node_splits_per_second`	Divisões de nó folha por seg
`newrelicoracledb.system.leaf_node_splits_per_transaction`	Divisões de nó folha por transação
`newrelicoracledb.system.library_cache_hit_ratio`	Taxa de acerto do cache da biblioteca
`newrelicoracledb.system.library_cache_miss_ratio`	Taxa de Falhas do Cache de Biblioteca
`newrelicoracledb.system.logical_reads_per_second`	Leituras lógicas por segundo
`newrelicoracledb.system.logical_reads_per_transaction`	Leituras lógicas por transação
`newrelicoracledb.system.logical_reads_per_user_call`	Leituras lógicas por chamada de usuário
`newrelicoracledb.system.logons_per_second`	Logons por segundo
`newrelicoracledb.system.logons_per_transaction`	Logons por Transação
`newrelicoracledb.system.long_table_scans_per_second`	Varreduras de Tabela Longas Por Seg
`newrelicoracledb.system.long_table_scans_per_transaction`	Varreduras de Tabela Longas por Transação
`newrelicoracledb.system.memory_sorts_ratio`	Taxa de ordenações em memória
`newrelicoracledb.system.network_traffic_volume_per_second`	Volume de tráfego de rede por segundo
`newrelicoracledb.system.open_cursors_per_second`	Cursores Abertos por Segundo
`newrelicoracledb.system.open_cursors_per_transaction`	Cursores Abertos por Transação
`newrelicoracledb.system.parse_failure_count_per_second`	Contagem de falhas de análise por segundo
`newrelicoracledb.system.parse_failure_count_per_transaction`	Contagem de falhas de análise por transação
`newrelicoracledb.system.pga_cache_hit_percentage`	Porcentagem de Acertos do Cache PGA
`newrelicoracledb.system.physical_lobs_reads_per_second`	Leituras Físicas de LOBs Por Segundo
`newrelicoracledb.system.physical_lobs_reads_per_transaction`	Leituras Físicas de LOBs por Transação
`newrelicoracledb.system.physical_lobs_writes_per_second`	Gravações Físicas de LOBs por Seg
`newrelicoracledb.system.physical_lobs_writes_per_transaction`	Gravações de LOBs Físicos por Transação
`newrelicoracledb.system.physical_read_bytes_per_second`	Bytes de leitura física por segundo
`newrelicoracledb.system.physical_read_io_requests_per_second`	Solicitações de E/S de leitura física por segundo
`newrelicoracledb.system.physical_read_total_bytes_per_second`	Total de bytes de leitura física por segundo
`newrelicoracledb.system.physical_read_total_io_requests_per_second`	Total de solicitações de E/S de leitura física por segundo
`newrelicoracledb.system.physical_reads_direct_per_second`	Leituras Físicas Diretas Por Seg
`newrelicoracledb.system.physical_reads_direct_per_transaction`	Leituras Físicas Diretas Por Transação
`newrelicoracledb.system.physical_reads_per_transaction`	Leituras Físicas por Transação
`newrelicoracledb.system.physical_write_bytes_per_second`	Bytes de Gravação Física por Segundo
`newrelicoracledb.system.physical_write_io_requests_per_second`	Solicitações de E/S de Gravação Física por Segundo
`newrelicoracledb.system.physical_write_total_bytes_per_second`	Total de Bytes de Gravação Física por Segundo
`newrelicoracledb.system.physical_write_total_io_requests_per_second`	Total de solicitações de E/S de gravação física por segundo
`newrelicoracledb.system.physical_writes_direct_per_second`	Gravações Físicas Diretas Por Seg
`newrelicoracledb.system.physical_writes_direct_per_transaction`	Gravações Físicas Diretas Por Transação
`newrelicoracledb.system.physical_writes_per_transaction`	Gravações Físicas por Transação
`newrelicoracledb.system.process_limit_percentage`	Porcentagem do limite de processos
`newrelicoracledb.system.recursive_calls_per_second`	Chamadas recursivas por segundo
`newrelicoracledb.system.recursive_calls_per_transaction`	Chamadas Recursivas por Transação
`newrelicoracledb.system.redo_allocation_hit_ratio`	Taxa de Acerto de Alocação de Redo
`newrelicoracledb.system.redo_generated_bytes_per_transaction`	Bytes de Redo Gerados por Transação
`newrelicoracledb.system.redo_writes_per_second`	Gravações de Redo Por Seg
`newrelicoracledb.system.redo_writes_per_transaction`	Gravações de Redo por Transação
`newrelicoracledb.system.row_cache_hit_ratio`	Taxa de acertos do cache de linha
`newrelicoracledb.system.row_cache_miss_ratio`	Taxa de falhas do cache de linha
`newrelicoracledb.system.rows_per_sort`	Linhas por ordenação
`newrelicoracledb.system.session_count`	Contagem de sessões
`newrelicoracledb.system.session_limit_percentage`	Porcentagem do Limite de Sessão
`newrelicoracledb.system.shared_pool_free_percentage`	Porcentagem Livre do Shared Pool
`newrelicoracledb.system.soft_parse_ratio`	Taxa de Soft Parse
`newrelicoracledb.system.sql_service_response_time`	Tempo de resposta do serviço SQL
`newrelicoracledb.system.streams_pool_usage_percentage`	Porcentagem de Uso do Pool de Streams
`newrelicoracledb.system.temp_space_used`	Espaço temporário usado
`newrelicoracledb.system.total_index_scans_per_second`	Total de varreduras de índice por segundo
`newrelicoracledb.system.total_index_scans_per_transaction`	Total de varreduras de índice por transação
`newrelicoracledb.system.total_parse_count_per_second`	Contagem Total de Análises Por Seg
`newrelicoracledb.system.total_parse_count_per_transaction`	Contagem Total de Parses por Transação
`newrelicoracledb.system.total_sorts_per_user_call`	Total de ordenações por chamada de usuário
`newrelicoracledb.system.total_table_scans_per_second`	Total de varreduras de tabela por segundo
`newrelicoracledb.system.total_table_scans_per_transaction`	Total de varreduras de tabela por transação
`newrelicoracledb.system.total_table_scans_per_user_call`	Total de varreduras de tabela por chamada de usuário
`newrelicoracledb.system.transactions_per_logon`	Transações por Logon
`newrelicoracledb.system.transactions_per_second`	Transações por segundo
`newrelicoracledb.system.user_calls_per_second`	Chamadas de usuário por segundo
`newrelicoracledb.system.user_calls_per_transaction`	Chamadas de usuário por transação
`newrelicoracledb.system.user_calls_ratio`	Taxa de chamadas do usuário
`newrelicoracledb.system.user_commits_percentage`	Porcentagem de commits do usuário
`newrelicoracledb.system.user_limit_percentage`	Porcentagem do limite de usuários
`newrelicoracledb.system.user_rollback_undo_records_applied_per_second`	Registros de Undo de Rollback de Usuário Aplicados por Seg
`newrelicoracledb.system.user_rollback_undo_records_applied_per_transaction`	Registros de desfazer de rollback de usuário aplicados por transação
`newrelicoracledb.system.user_rollbacks_per_second`	Reversões de Usuário por Seg
`newrelicoracledb.system.user_rollbacks_percentage`	Porcentagem de Rollbacks de Usuário

Ative o enable_connection_scraper: true para coletar estas métricas:

Nome da métrica	Descrição
`newrelicoracledb.connection.sessions_by_status`	Número de sessões agrupadas por status
`newrelicoracledb.connection.sessions_by_type`	Número de sessões agrupadas por tipo
`newrelicoracledb.connection.logons_cumulative`	Número acumulado de logons desde a inicialização da instância
`newrelicoracledb.connection.logons_current`	Número atual de logons ativos
`newrelicoracledb.connection.shared_servers`	Número de servidores compartilhados
`newrelicoracledb.connection.dispatchers`	Número de despachantes
`newrelicoracledb.connection.circuits`	Número de circuitos ativos
`newrelicoracledb.connection.resource_current_utilization`	Utilização atual de recursos Oracle
`newrelicoracledb.connection.resource_max_utilization`	Utilização máxima de recursos Oracle desde a inicialização
`newrelicoracledb.connection.resource_limit`	Valor limite para recursos Oracle
`newrelicoracledb.connection.user_commits`	Número de commits do usuário
`newrelicoracledb.connection.user_rollbacks`	Número de reversões de usuário
`newrelicoracledb.connection.parse_count_total`	Número total de chamadas de análise
`newrelicoracledb.connection.parse_count_hard`	Número de chamadas de hard parse
`newrelicoracledb.connection.sqlnet_roundtrips`	Número de viagens de ida e volta do SQL*Net para/do cliente
`newrelicoracledb.connection.bytes_sent`	Bytes enviados via SQL*Net para o cliente
`newrelicoracledb.connection.bytes_received`	Bytes recebidos via SQL*Net do cliente

Habilite o enable_pdb_scraper: true para coletar estas métricas de PDB (Pluggable Database):

Nome da métrica	Descrição
`newrelicoracledb.pdb.active_parallel_sessions`	Número de sessões paralelas ativas no PDB
`newrelicoracledb.pdb.active_serial_sessions`	Número de sessões seriais ativas no PDB
`newrelicoracledb.pdb.average_active_sessions`	Número médio de sessões ativas no PDB
`newrelicoracledb.pdb.background_cpu_usage_per_second`	Uso de CPU em segundo plano por segundo no PDB
`newrelicoracledb.pdb.background_time_per_second`	Tempo de segundo plano por segundo no PDB
`newrelicoracledb.pdb.block_changes_per_second`	Alterações de bloco do BD por segundo no PDB
`newrelicoracledb.pdb.block_changes_per_transaction`	Alterações de bloco do BD por transação no PDB
`newrelicoracledb.pdb.cpu_time_ratio`	Taxa de tempo de CPU do banco de dados no PDB
`newrelicoracledb.pdb.cpu_usage_per_second`	Uso de CPU por segundo no PDB
`newrelicoracledb.pdb.cpu_usage_per_transaction`	Uso de CPU por transação no PDB
`newrelicoracledb.pdb.current_logons`	Número atual de logons no PDB
`newrelicoracledb.pdb.current_open_cursors`	Número atual de cursores abertos no PDB
`newrelicoracledb.pdb.db_physical_read_bytes_per_second`	Bytes de leitura física por segundo no PDB
`newrelicoracledb.pdb.db_physical_reads_per_second`	Leituras físicas por segundo no PDB
`newrelicoracledb.pdb.db_physical_write_bytes_per_second`	Bytes de gravação física por segundo no PDB
`newrelicoracledb.pdb.db_physical_writes_per_second`	Gravações físicas por segundo no PDB
`newrelicoracledb.pdb.execute_without_parse_ratio`	Taxa de execução sem análise no PDB
`newrelicoracledb.pdb.executions_per_second`	Execuções por segundo no PDB
`newrelicoracledb.pdb.executions_per_transaction`	Execuções por transação no PDB
`newrelicoracledb.pdb.hard_parse_count_per_second`	Contagem de hard parses por segundo no PDB
`newrelicoracledb.pdb.hard_parse_count_per_transaction`	Contagem de hard parse por transação no PDB
`newrelicoracledb.pdb.logical_reads_per_second`	Leituras lógicas por segundo no PDB
`newrelicoracledb.pdb.logical_reads_per_transaction`	Leituras lógicas por transação no PDB
`newrelicoracledb.pdb.logons_per_second`	Logons por segundo no PDB
`newrelicoracledb.pdb.logons_per_transaction`	Logons por transação no PDB
`newrelicoracledb.pdb.network_traffic_byte_per_second`	Volume de tráfego de rede por segundo em bytes no PDB
`newrelicoracledb.pdb.open_cursors_per_second`	Cursores abertos por segundo no PDB
`newrelicoracledb.pdb.open_cursors_per_transaction`	Cursores abertos por transação no PDB
`newrelicoracledb.pdb.parse_failure_count_per_second`	Contagem de falhas de análise por segundo no PDB
`newrelicoracledb.pdb.physical_read_bytes_per_second`	Total de bytes de leitura física por segundo no PDB
`newrelicoracledb.pdb.physical_reads_per_transaction`	Leituras físicas por transação no PDB
`newrelicoracledb.pdb.physical_write_bytes_per_second`	Total de bytes de gravação física por segundo no PDB
`newrelicoracledb.pdb.physical_writes_per_transaction`	Gravações físicas por transação no PDB
`newrelicoracledb.pdb.redo_generated_bytes_per_second`	Redo gerado por segundo em bytes no PDB
`newrelicoracledb.pdb.redo_generated_bytes_per_transaction`	Redo gerado por transação em bytes no PDB
`newrelicoracledb.pdb.response_time_per_transaction`	Tempo de resposta por transação no PDB
`newrelicoracledb.pdb.session_count`	Contagem de sessões no PDB
`newrelicoracledb.pdb.soft_parse_ratio`	Taxa de soft parse no PDB
`newrelicoracledb.pdb.sql_service_response_time`	Tempo de resposta do serviço SQL no PDB
`newrelicoracledb.pdb.total_parse_count_per_second`	Contagem total de análises por segundo no PDB
`newrelicoracledb.pdb.total_parse_count_per_transaction`	Contagem total de parses por transação no PDB
`newrelicoracledb.pdb.transactions_per_second`	Transações de usuário por segundo no PDB
`newrelicoracledb.pdb.user_calls_per_second`	Chamadas de usuário por segundo no PDB
`newrelicoracledb.pdb.user_calls_per_transaction`	Chamadas de usuário por transação no PDB
`newrelicoracledb.pdb.user_commits_per_second`	Commits de usuário por segundo no PDB
`newrelicoracledb.pdb.user_commits_percentage`	Porcentagem de commits de usuário no PDB
`newrelicoracledb.pdb.user_rollbacks_per_second`	Reversões de usuário por segundo no PDB
`newrelicoracledb.pdb.user_rollbacks_percentage`	Porcentagem de rollbacks de usuário no PDB
`newrelicoracledb.pdb.wait_time_ratio`	Taxa de tempo de espera do banco de dados no PDB

Habilite enable_container_scraper: true para coletar estas métricas de contêiner para ambientes CDB:

Nome da métrica	Descrição
`newrelicoracledb.container.status`	Status do modo de abertura do contêiner (1=LEITURA GRAVAÇÃO 0=outro)
`newrelicoracledb.container.restricted`	Modo restrito do contêiner (1=SIM 0=NÃO)
`newrelicoracledb.pdb.open_mode`	Modo de abertura do PDB (1=READ WRITE 0=outro)
`newrelicoracledb.pdb.total_size_bytes`	Tamanho total do PDB em bytes
`newrelicoracledb.tablespace.used_bytes`	Bytes usados por tablespace no CDB
`newrelicoracledb.tablespace.total_bytes`	Total de bytes por tablespace no CDB
`newrelicoracledb.tablespace.used_percent`	Porcentagem de uso por tablespace no CDB
`newrelicoracledb.datafile.size_bytes`	Tamanho do arquivo de dados em bytes
`newrelicoracledb.datafile.used_bytes`	Bytes usados no arquivo de dados
`newrelicoracledb.datafile.autoextensible`	Status de autoextensão do arquivo de dados (1=SIM 0=NÃO)
`newrelicoracledb.service.status`	Status do serviço Oracle (1=ativo 0=inativo)
`newrelicoracledb.service.count`	Contagem de serviços por contêiner

Ative o enable_rac_scraper: true para coletar estas métricas do RAC (Real Application Clusters):

Nome da métrica	Descrição
`newrelicoracledb.asm.diskgroup.total_mb`	Capacidade total do grupo de discos ASM em MB
`newrelicoracledb.asm.diskgroup.free_mb`	Espaço livre disponível no grupo de discos ASM em MB
`newrelicoracledb.asm.diskgroup.offline_disks`	Número de discos offline no grupo de discos ASM
`newrelicoracledb.rac.wait_time`	Taxa de tempo de espera do cluster em microssegundos por segundo
`newrelicoracledb.rac.total_waits`	Número total de eventos de espera do cluster
`newrelicoracledb.rac.instance.status`	Status da instância RAC (1=OPEN 0=outro)
`newrelicoracledb.rac.instance.uptime_seconds`	Tempo de atividade da instância em segundos desde a inicialização
`newrelicoracledb.rac.instance.database_status`	Indicador de status do banco de dados (1=ATIVO 0=outro)
`newrelicoracledb.rac.instance.active_state`	Indicador de estado ativo da instância (1=NORMAL 0=outro)
`newrelicoracledb.rac.instance.logins_allowed`	Indicador de status de login da instância (1=PERMITIDO 0=RESTRITO)
`newrelicoracledb.rac.instance.archiver_started`	Indicador de status do arquivador (1=INICIADO 0=PARADO)
`newrelicoracledb.rac.instance.version_info`	Informações de versão do banco de dados Oracle (sempre 1 versão nos atributos)
`newrelicoracledb.rac.service.instance_id`	ID da instância onde o serviço está sendo executado atualmente
`newrelicoracledb.rac.service.network_config`	Configuração da rede de serviço (sempre 1 configuração nos atributos)
`newrelicoracledb.rac.service.clb_config`	Configuração de balanceamento de carga de conexão (sempre 1 configuração nos atributos)
`newrelicoracledb.rac.service.goal_config`	Configuração da meta de serviço (sempre 1 meta nos atributos)
`newrelicoracledb.rac.service.blocked_status`	Indicador de serviço bloqueado (1=bloqueado 0=não bloqueado)
`newrelicoracledb.rac.service.fan_enabled`	Indicador de Fast Application Notification (FAN) ativado (1=ativado 0=desativado)
`newrelicoracledb.rac.service.transaction_guard_enabled`	Indicador de Transaction Guard habilitado (1=habilitado 0=desabilitado)
`newrelicoracledb.rac.service.drain_timeout_seconds`	Tempo limite de drenagem de sessão em segundos antes da parada do serviço
`newrelicoracledb.rac.service.replay_timeout_seconds`	Tempo limite de iniciação de repetição do Application Continuity em segundos

Ative o enable_database_info_scraper: true para coletar estas métricas de informações do banco de dados:

Nome da métrica	Descrição
`newrelicoracledb.database.info`	Informações de versão e configuração do banco de dados
`newrelicoracledb.hosting.info`	Hospedagem de banco de dados e informações da plataforma
`newrelicoracledb.database.role`	Função do banco de dados e configuração do Data Guard

Habilite o enable_query_monitoring: true para coletar estas métricas de monitoramento de consultas lentas:

Nome da métrica	Descrição
`newrelicoracledb.slow_queries.execution_count`	Número de execuções de consultas lentas
`newrelicoracledb.slow_queries.total_elapsed_time`	Tempo decorrido total acumulado para consultas lentas
`newrelicoracledb.slow_queries.total_cpu_time`	Tempo total acumulado de CPU para consultas lentas
`newrelicoracledb.slow_queries.total_wait_time`	Tempo de espera cumulativo total para consultas lentas (elapsed_time - cpu_time)
`newrelicoracledb.slow_queries.total_rows_examined`	Total acumulado de linhas examinadas para consultas lentas (buffer gets/leituras lógicas)
`newrelicoracledb.slow_queries.total_rows_returned`	Total acumulado de linhas retornadas para consultas lentas (linhas processadas)
`newrelicoracledb.slow_queries.total_disk_reads`	Total acumulado de leituras de disco para consultas lentas
`newrelicoracledb.slow_queries.total_disk_writes`	Total acumulado de gravações diretas para consultas lentas - gravações ignorando o cache de buffer
`newrelicoracledb.slow_queries.interval_execution_count`	Número de novas execuções desde a última coleta (métrica delta)
`newrelicoracledb.slow_queries.interval_elapsed_time`	Tempo total decorrido no último intervalo de sondagem (métrica delta não calculada pela média)
`newrelicoracledb.slow_queries.interval_cpu_time`	Tempo total de CPU no último intervalo de coleta (métrica delta não calculada pela média)
`newrelicoracledb.slow_queries.interval_wait_time`	Tempo total de espera no último intervalo de sondagem (métrica delta sem média)
`newrelicoracledb.slow_queries.interval_buffer_gets`	Total de buffer gets (leituras lógicas) no último intervalo de coleta (métrica delta sem média)
`newrelicoracledb.slow_queries.interval_rows_processed`	Total de linhas processadas (retornadas) no último intervalo de sondagem (métrica delta sem média)
`newrelicoracledb.slow_queries.interval_disk_reads`	Total de leituras de disco no último intervalo de sondagem (métrica delta não promediada)
`newrelicoracledb.slow_queries.interval_disk_writes`	Total de gravações diretas no último intervalo de coleta - gravações ignorando o cache de buffer (métrica delta não calculada a média)
`newrelicoracledb.slow_queries.interval_avg_elapsed_time`	Tempo médio decorrido por execução no último intervalo de sondagem (métrica delta)
`newrelicoracledb.slow_queries.interval_avg_cpu_time`	Tempo médio de CPU por execução no último intervalo de polling (métrica delta)
`newrelicoracledb.slow_queries.interval_avg_wait_time`	Tempo médio de espera por execução no último intervalo de sondagem (métrica delta)
`newrelicoracledb.slow_queries.interval_avg_buffer_gets`	Média de buffer gets (leituras lógicas) por execução no último intervalo de coleta (métrica delta)
`newrelicoracledb.slow_queries.interval_avg_rows_processed`	Média de linhas processadas (retornadas) por execução no último intervalo de coleta (métrica delta)
`newrelicoracledb.slow_queries.interval_avg_disk_reads`	Média de leituras de disco por execução no último intervalo de sondagem (métrica delta)
`newrelicoracledb.slow_queries.interval_avg_disk_writes`	Média de gravações diretas por execução no último intervalo de sondagem - gravações ignorando o cache de buffer (métrica delta)
`newrelicoracledb.slow_queries.query_details`	Contagem de detalhes de consultas lentas
`newrelicoracledb.child_cursors.elapsed_time`	Tempo médio decorrido por execução para este cursor filho (em milissegundos)
`newrelicoracledb.child_cursors.cpu_time`	Tempo médio de CPU por execução para este cursor filho (em milissegundos)
`newrelicoracledb.child_cursors.user_io_wait_time`	Tempo médio de espera de E/S do usuário por execução para este cursor filho (em milissegundos)
`newrelicoracledb.child_cursors.buffer_gets`	Número médio de buffer gets por execução para este cursor filho
`newrelicoracledb.child_cursors.disk_reads`	Número médio de leituras de disco por execução para este cursor filho
`newrelicoracledb.child_cursors.executions`	Número total de execuções deste cursor filho
`newrelicoracledb.child_cursors.invalidations`	Número de vezes que este cursor filho foi invalidado
`newrelicoracledb.child_cursors.details`	Detalhes do cursor filho, incluindo tempos de carregamento
`newrelicoracledb.execution_plan`	Detalhes do plano de execução do Oracle SQL, incluindo custos de operação, cardinalidade e estimativas de recursos

Qual é o próximo

Após configurar o monitoramento de banco de dados Oracle com o NRDOT:

Crie dashboards personalizados para visualizar suas métricas de banco de dados
Configure alertas para limites críticos de desempenho do banco de dados
Explore seus dados usando os recursos de consulta do New Relic

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

Monitoramento do Oracle Database com NRDOT

Visualização

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

Configure o NRDOT Collector para o monitoramento do Oracle Database

Dica

Método de instalação

Importante

Para arquitetura ARM64

Configurar usuário do banco de dados

Dica

Conceder privilégios de monitoramento para banco de dados multitenant

Configurar o NRDOT Collector

Importante

Dica

Reiniciar o coletor NRDOT

Dica

(Opcional) Configuração de multirreceptor

Dica

(Opcional) Configurar a correlação entre APM e banco de dados

Importante

(Opcional) Configurar o gerenciamento de segredos

Encontre e use seus dados

Método de instalação

Para arquitetura AMD64

Para arquitetura ARM64

Configurar usuário do banco de dados

Conceder privilégios de monitoramento para o banco de dados RDS

Configurar o NRDOT Collector

Importante

Reiniciar o coletor NRDOT

Dica

(Opcional) Configuração de multirreceptor

Dica

(Opcional) Configurar a correlação entre APM e banco de dados

Importante

(Opcional) Configurar o gerenciamento de segredos

Encontre e use seus dados

Comandos suportados pelo coletor NRDOT

Comandos do Coletor NRDOT

Métricas disponíveis

Métrica padrão

Métricas padrão coletadas pelo NRDOT Collector

Métricas adicionais

Métrica de tablespace

Métricas principais

Métrica do sistema

Métricas de conexão

Métricas de PDB

recipiente métrico

Métricas do RAC

Métricas de informações do banco de dados

Consultar métricas de monitoramento

Qual é o próximo

Pré-requisitos