NRDOTによるOracleデータベース監視

プレビュー

この機能はまだ開発中ですが、ぜひお試しください。

この機能は現在、弊社のプレリリースポリシーに従ってプレビューの一部として提供されています。

New Relicでは、 New Relic Distribution of OpenTelemetry (NRDOT) とNew Relic Relic のデータベース監視機能を使用して、チームがOracleのパフォーマンスを監視できるようになりました。この統合により、NRDOT コレクターを使用して、包括的なインサイトをデータベースメトリクス、書き込みパフォーマンス、およびシステムの状態に提供します。

この NRDOT ベースのアプローチは、データベース監視のOpenTelemetry標準を活用することで既存のオンホストインテグレーション (OHI) を補完し、既存の監視スタックとの統合を容易にします。

前提条件

始める前に、次のものがあることを確認してください。

有効なNew Relicライセンスキー
サポートされているアーキテクチャー: AMD64 および ARM64 を搭載した Linux
New Relicの OTLP エンドポイントへのネットワーク接続
Oracleデータベース 19c 以降
Oracleデータベースでは、NRDOT コレクターを実行しているマシン上にOracle Instant Clientがあります。

Oracleデータベース監視用の NRDOT Collectorセットアップ

オンホスト (マルチテナント) 環境または RDS 環境で NRDOT Collector使用してOracleデータベース監視を設定できます。データベース環境に基づいて適切な設定を選択し、手順に従ってください。

ヒント

NRDOT Collectorインフラストラクチャとデータベース関連のテレメトリーデータの両方を収集するため、 New RelicでOracleデータベース環境の統合された監視ソリューションを実現できます。

オンホスト環境またはマルチテナント環境で NRDOT Collectorを使用してOracleデータベース監視を設定できます。オンホスト（マルチテナント）環境にNRDOT Collectorインストールするには、以下の手順に従ってください。

設置方法

Linux 環境に適したインストレーション配布方法を選択します。

重要

パフォーマンス監視のためにインフラレベルのメトリクスを表示するには、 Oracleデータベースインスタンスと同じホストに NRDOT Collectorインストールすることをお勧めします。

Debian/Ubuntuシステムの場合は、以下を実行してください。
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
```

RHEL/CentOS/OELシステムの場合は、以下を実行してください。

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

Debian/Ubuntuシステムの場合は、以下を実行してください。

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

RHEL/CentOS/OELシステムの場合は、以下を実行してください。

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

データベースユーザーを構成する

マルチテナントOracleデータベースに必要な権限を持つ監視ユーザーを作成します。これには、接頭辞C##を持つ共通ユーザーを作成する必要があります。

ルートデータベースにアドミニストレーターとしてログインします。
```
CREATE USER c##<YOUR_DB_USERNAME> IDENTIFIED BY "<USER_PASSWORD>";
```
ヒント
USER_PASSWORDが Oracle の新規ユーザーパスワード要件を満たしていることを確認してください。

マルチテナントデータベースの監視権限を付与する

監視権限を付与するには、以下のSQL文を実行してください。マルチテナントデータベースの場合は、 C##プレフィックスとして正しいユーザー名形式を使用してください。

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;

NRDOT Collectorを構成する

/etc/nrdot-collector-host/にあるconfig.yamlファイルを編集し、以下のコードスニペットを追加してください。

重要

既存の NRDOT Collectorユーザーの場合は、上記の設定を既存のconfig.yamlファイルにマージしてください。これには、現在の設定を保持したまま、 Oracleデータベース監視用の新しいレシーバー、プロセッサ、およびエクスポータを追加することが含まれます。

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]

設定ファイルに次の必須事項を設定します。

パラメータ	説明
`<YOUR_DB_HOST>`	Oracleデータベースのホスト名を入力します。
`<YOUR_DB_PORT>`	Oracleデータベースのポートを入力します。
`<USERNAME>`	データベースのユーザー名を入力してください。
`<PASSWORD>`	データベースのパスワードを入力してください。
`<YOUR_CDB_SERVICE_NAME>`	Oracleサービス名を入力してください。
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	New Relic OTLP エンドポイントを入力します。詳細については、 New Relic OTLP エンドポイントのドキュメントを参照してください。
`<YOUR_NEWRELIC_API_KEY>`	New Relic APIキーを入力します。
`pdb_services`	次のオプションから監視する PDB サービスを選択します。空またはnil：指定されたサービスデータのみを収集します `["ALL"]`: すべてのPDBサービス（CDBを除く）を収集します `["pdb1", "pdb2"]`指定されたPDBサービスのみを収集する
`enable_query_monitoring`	低速、アクティブ、待機、ブロックセッション、実行計画などの監視メトリクスを取得します。デフォルト値は `false`
`query_monitoring_response_time_threshold`	応答タイムの閾値を設定します (ミリ秒単位)。この閾値を越える突破を捕捉します。デフォルト値は500msに設定されています。
`query_monitoring_count_threshold`	各書き込みパフォーマンスメトリクスのレコード数。デフォルト値は30に設定されています

ヒント

New Relic OTLP エンドポイント設定およびOpenTelemetryベストプラクティスの詳細については、 OpenTelemetry OTLP ドキュメントを参照してください。

NRDOTコレクターを再起動します

設定を更新した後、NRDOT コレクターを再起動します。

bash

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

ヒント

新しい設定を確実に有効にするために、設定を変更した後は必ず NRDOT コレクターを再起動してください。

（オプション）マルチレシーバー設定

nrdot-collector-hostバイナリは、一意の資格証明を使用して複数のOracleデータベースインスタンスを監視するために、単一のconfig.yaml内のマルチレシーバー設定をサポートします。以下の例config.yamlは、共通のプロセッサとエクスポーターを共有しながら、異なるオンホスト（マルチテナント）インスタンス用に複数のレシーバを設定する方法を示しています。

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]

ヒント

この設定により、複数のOracle RDS インスタンスを同時に監視できます。各インスタンスは、共通のプロセッサとエクスポータを共有しながら、一意の資格情報を持つ独自のレシーバ設定を取得します。監視要件に基づいて、 collection_intervalとその他の値を調整します。
設定を更新した後、NRDOT コレクターを再起動して変更を適用します。

（オプション）APMとデータベースの相関関係を設定する

アプリケーションのパフォーマンスをデータベース操作と関連付けるために、データベースサービス ID を設定できます。この機能を使用すると、特定のデータベースワークロードを生成しているアプリケーションを正確に確認できます。詳細については、「 New RelicでAPMとデータベースの相関関係を取得するためのデータベースサービス ID のセットアップ」を参照してください。

重要

APM でデータベースパフォーマンスデータを表示するには、両方のエンティティが同じ New Relic アカウント内にある必要があります。エンティティが異なる New Relic アカウントにある場合、データを表示するには両方のアカウントにアクセスできる必要があります。

（オプション）シークレット管理を構成する

シークレット管理機能を使用すると、データベース資格情報などの機密情報を安全に管理できます。これにより、構成ファイルに機密データをハードコーディングすることを避け、監視設定のセキュリティを強化できます。詳細については、シークレット管理を参照してください。

データを探す、使う

データが収集されると、 New RelicのUIを通じて包括的なOracleデータベース監視にアクセスできるようになります。

New RelicでOracleデータベースのエンティティを見つけるには:

https://one.newrelic.com > All Capabilities > Databasesに移動します。
検索条件をinstrumentation.provider = opentelemetryに設定します。
エンティティのリストからOracleデータベースを選択します。

RDS環境にNRDOT Collectorインストールするには、以下の手順に従ってください。

設置方法

Linux 環境に適したインストレーション配布方法を選択します。

Debian/Ubuntuシステムの場合は、以下を実行してください。

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

RHEL/CentOS/OELシステムの場合は、以下を実行してください。

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

Debian/Ubuntuシステムの場合は、以下を実行してください。

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

RHEL/CentOS/OELシステムの場合は、以下を実行してください。

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

データベースユーザーを構成する

RDS Oracleデータベースに必要な権限を持つ監視ユーザーを作成します。

ルートデータベースにアドミニストレーターとしてログインします。
```
CREATE USER <USERNAME> IDENTIFIED BY "<USER_PASSWORD>";
```
新しく作成されたユーザーにCONNECT権限を付与します。
```
GRANT CONNECT TO <USERNAME>;
```

RDS データベースに対する監視権限を付与する

監視権限を付与するには、以下のSQL文を実行してください。<USERNAME_IN_UPPERCASE>あなたのユーザー名（大文字）に置き換えてください。

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;
/

NRDOT Collectorを構成する

/etc/nrdot-collector-host/にあるconfig.yamlファイルを編集し、以下のコードスニペットを追加してください。

重要

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]

設定ファイルに次の必須事項を設定します。

パラメータ	説明
`<YOUR_DB_HOST>`	Oracleデータベースのホスト名を入力します。
`<YOUR_DB_PORT>`	Oracleデータベースのポートを入力します。
`<USERNAME>`	データベースのユーザー名を入力してください。
`<PASSWORD>`	データベースのパスワードを入力してください。
`<PDB_NAME>`	PDBサービス名を入力してください。
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	New Relic OTLP エンドポイントを入力します。詳細については、 New Relic OTLP エンドポイントのドキュメントを参照してください。
`<YOUR_NEWRELIC_API_KEY>`	New Relic APIキーを入力します。
`pdb_services`	次のオプションから監視する PDB サービスを選択します。空またはnil：指定されたサービスデータのみを収集します `["pdb1", "pdb2"]`指定されたPDBサービスのみを収集する
`enable_query_monitoring`	低速、アクティブ、待機、ブロックセッション、実行計画などの監視メトリクスを取得します。デフォルト値は `false`
`query_monitoring_response_time_threshold`	応答タイムの閾値を設定します (ミリ秒単位)。この閾値を越える突破を捕捉します。デフォルト値は500msに設定されています。
`query_monitoring_count_threshold`	各書き込みパフォーマンスメトリクスのレコード数。デフォルト値は30に設定されています

NRDOTコレクターを再起動します

設定を更新した後、NRDOT コレクターを再起動します。

bash

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

ヒント

新しい設定を確実に有効にするために、設定を変更した後は必ず NRDOT コレクターを再起動してください。

（オプション）マルチレシーバー設定

nrdot-collector-hostバイナリは、一意の資格証明を使用して複数のOracleデータベースインスタンスを監視するために、単一のconfig.yaml内のマルチレシーバー設定をサポートします。以下の例config.yamlは、共通のプロセッサとエクスポーターを共有しながら、異なる RDS インスタンスに対して複数のレシーバを設定する方法を示しています。

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]

ヒント

この設定により、複数のOracle RDS インスタンスを同時に監視できます。各インスタンスは、共通のプロセッサとエクスポータを共有しながら、一意の資格情報を持つ独自のレシーバ設定を取得します。監視要件に基づいて、 collection_intervalとその他の値を調整します。
設定を更新した後、NRDOT コレクターを再起動して変更を適用します。

（オプション）APMとデータベースの相関関係を設定する

重要

APM でデータベースパフォーマンスデータを表示するには、両方のエンティティが同じ New Relic アカウント内にある必要があります。エンティティが異なるアカウントに存在する場合、データを表示するには両方のアカウントへのアクセス権が必要です。

（オプション）シークレット管理を構成する

データを探す、使う

データが収集されると、 New RelicのUIを通じて包括的なOracleデータベース監視にアクセスできるようになります。

New RelicでOracleデータベースのエンティティを見つけるには:

https://one.newrelic.com > All Capabilities > Databasesに移動します。
検索条件をinstrumentation.provider = opentelemetryに設定します。
エンティティのリストからOracleデータベースを選択します。

NRDOT コレクターがサポートするコマンド

このセクションでは、システム上のNRDOT Collectorサービスを管理するための一般的なコマンドの一覧を示します。

インストールステータスを検証するには:
- Debian/Ubuntu ベースのディストリビューションの場合:
  bash
```
$dpkg -l | grep nrdot-collector-host
```
- RHEL/CentOS ベースのディストリビューションの場合:
  bash
```
$rpm -q nrdot-collector-host || ls /etc/nrdot-collector-host
```
NRDOT Collector を再起動するには:
bash
```
$sudo systemctl restart nrdot-collector-host
```
NRDOT Collectorステータスを確認するには:
bash
```
$sudo systemctl status nrdot-collector-host
```

NRDOT Collector ログを表示するには:

bash

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

NRDOT Collector サービスを削除するには:
- Debian/Ubuntu ベースのディストリビューションの場合:
  bash
```
$sudo apt purge nrdot-collector-host
```
- RHEL/CentOS ベースのディストリビューションの場合:
  bash
```
$sudo yum erase nrdot-collector-host
```

設定ファイルをクリーンアップするには：

bash

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

利用可能なメトリクス

設定フラグごとに整理されたメトリクスを使用して、 Oracleパフォーマンスを監視します。デフォルトのメトリクスは、 New Relic UI機能のために自動的に収集されます。特定のスクレイパーを有効にすると、提供される追加のメトリクスを使用して、高度でより深いインサイトを取得することもできます。

デフォルトのメトリクス

これらのメトリクスはNew RelicのOracleデータベース監視機能に不可欠であり、設定に関係なく自動的に収集されます。

メトリクス名	説明
`newrelicoracledb.child_cursors.details`	Oracleデータベースの子カーソルの詳細
`newrelicoracledb.child_cursors.elapsed_time`	子カーソル操作にかかった経過時間
`newrelicoracledb.connection.active_sessions`	アクティブなOracleデータベースセッションの数
`newrelicoracledb.connection.execute_count`	SQL実行回数
`newrelicoracledb.connection.inactive_sessions`	非アクティブなOracleデータベースセッションの数
`newrelicoracledb.connection.total_sessions`	Oracleデータベースセッションの合計数
`newrelicoracledb.memory.pga_max_size_bytes`	PGAのグローバルメモリバウンド（バイト単位）
`newrelicoracledb.sessions.count`	アクティブなOracleデータベースセッションの合計数
`newrelicoracledb.sga_hit_ratio`	SGAヒット率（バッファキャッシュ効率）
`newrelicoracledb.sga_shared_pool_library_cache_hit_ratio`	SQL AREAネームスペースのライブラリキャッシュのヒット率
`newrelicoracledb.slow_queries.execution_count`	スロー実行の数
`newrelicoracledb.slow_queries.interval_avg_cpu_time`	間隔内のスロー書き込みの平均 CPU 時間
`newrelicoracledb.slow_queries.interval_avg_elapsed_time`	インターバル内のスロー書き込みの平均経過時間
`newrelicoracledb.slow_queries.interval_buffer_gets`	間隔内でスロー書き込み用のバッファを取得します
`newrelicoracledb.slow_queries.interval_cpu_time`	間隔内のスロー書き込みの CPU 時間
`newrelicoracledb.slow_queries.interval_elapsed_time`	インターバル内のスロー書き込みの経過時間
`newrelicoracledb.slow_queries.interval_execution_count`	インターバル内のスロー書き込みの実行回数
`newrelicoracledb.slow_queries.interval_rows_processed`	間隔内でスロー書き込みのために処理された行数
`newrelicoracledb.slow_queries.interval_wait_time`	インターバル内のスロー書き込みの待ち時間
`newrelicoracledb.slow_queries.query_details`	スロー書き込みの詳細情報
`newrelicoracledb.slow_queries.total_cpu_time`	スロー書き込みの合計 CPU 時間
`newrelicoracledb.slow_queries.total_elapsed_time`	スロー書き込みの合計経過時間
`newrelicoracledb.slow_queries.total_rows_examined`	スロー書き込みで調べられた合計行数
`newrelicoracledb.slow_queries.total_rows_returned`	スロー書き込みによって返された合計行数
`newrelicoracledb.slow_queries.total_wait_time`	スロー書き込みの合計待ち時間
`newrelicoracledb.system.average_active_sessions`	同時アクティブセッションの平均数
`newrelicoracledb.system.buffer_cache_hit_ratio`	バッファキャッシュのヒット率
`newrelicoracledb.system.database_cpu_time_ratio`	データベース CPU 時間比率
`newrelicoracledb.system.enqueue_waits_per_second`	エンキュー競合率
`newrelicoracledb.system.executions_per_second`	SQL実行速度
`newrelicoracledb.system.hard_parse_count_per_second`	ハードパースレート
`newrelicoracledb.system.host_cpu_utilization`	ホストCPU使用率
`newrelicoracledb.system.io_megabytes_per_second`	I/Oループット（MB/秒）
`newrelicoracledb.system.physical_reads_per_second`	物理読み取り速度
`newrelicoracledb.system.physical_writes_per_second`	物理書き込み速度
`newrelicoracledb.system.redo_generated_bytes_per_second`	リドゥ生成レート
`newrelicoracledb.system.response_time_per_transaction`	トランザクションごとの応答時間
`newrelicoracledb.system.transactions_per_second`	1秒あたりのトランザクションレート
`newrelicoracledb.wait_events.current_wait_time_ms`	データベースイベントの現在の待機時間（ミリ秒）

追加のメトリクス

インサイトをOracleデータベースのパフォーマンスと健全性にさらに深くするために、必要に応じてこれらの追加のメトリクスを有効にします。

enable_tablespace_scraper: trueを有効にしてこれらのメトリクスを収集します。

メトリクス名	説明
`newrelicoracledb.tablespace.space_consumed_bytes`	テーブルスペースごとの使用容量（バイト単位）
`newrelicoracledb.tablespace.space_reserved_bytes`	テーブルスペースごとの割り当て済み容量（バイト単位）
`newrelicoracledb.tablespace.space_used_percentage`	テーブルスペースごとの使用率
`newrelicoracledb.tablespace.is_offline`	テーブルスペースのオフライン状態（1=オフライン、0=オンライン）
`newrelicoracledb.tablespace.global_name`	テーブルスペースでタグ付けされたグローバルデータベース名
`newrelicoracledb.tablespace.db_id`	テーブルスペースごとのデータベース ID タグ
`newrelicoracledb.tablespace.offline_cdb_datafiles`	CDBテーブルスペース内のオフラインデータファイルの数
`newrelicoracledb.tablespace.offline_pdb_datafiles`	PDB表領域内のオフラインデータファイルの数
`newrelicoracledb.tablespace.pdb_non_write_mode`	書き込みモードではないPDBテーブルスペースの数

enable_core_scraper: trueを有効にしてこれらのメトリクスを収集します。

メトリクス名	説明
`newrelicoracledb.memory.pga_in_use_bytes`	現在使用されている合計 PGA メモリ (バイト単位)
`newrelicoracledb.memory.pga_allocated_bytes`	PGAに割り当てられたメモリの合計（バイト単位）
`newrelicoracledb.memory.pga_freeable_bytes`	解放可能な PGA メモリの合計 (バイト単位)
`newrelicoracledb.memory.sga_uga_total_bytes`	SGA UGA メモリの合計 (バイト単位)
`newrelicoracledb.memory.sga_shared_pool_library_cache_sharable_bytes`	SGA共有プールライブラリキャッシュ共有可能メモリ（バイト単位）
`newrelicoracledb.memory.sga_shared_pool_library_cache_user_bytes`	SGA共有プールライブラリキャッシュユーザーごとの共有可能メモリ（バイト単位）
`newrelicoracledb.sga_shared_pool_library_cache_reload_ratio`	ライブラリキャッシュの再読み込み率（再読み込み数／固定数）
`newrelicoracledb.sga_shared_pool_dict_cache_miss_ratio`	ディクショナリキャッシュミス率（getmisses/gets）
`newrelicoracledb.sga_log_buffer_space_waits`	ログバッファ領域を待機しているセッション数
`newrelicoracledb.sga_log_allocation_retries_ratio`	ログ割り当て再試行率
`newrelicoracledb.sga_fixed_size_bytes`	SGA固定サイズメモリ（バイト単位）
`newrelicoracledb.sga_redo_buffers_bytes`	SGAリドゥバッファのメモリ（バイト単位）
`newrelicoracledb.disk.reads`	物理ディスク読み取り回数
`newrelicoracledb.disk.writes`	物理ディスクへの書き込み回数
`newrelicoracledb.disk.blocks_read`	ディスクから読み取られた物理ブロックの数
`newrelicoracledb.disk.blocks_written`	ディスクに書き込まれた物理ブロックの数
`newrelicoracledb.disk.read_time_milliseconds`	ディスクからの読み込みに要した時間（ミリ秒）
`newrelicoracledb.disk.write_time_milliseconds`	ディスクへの書き込みにかかった時間（ミリ秒）
`newrelicoracledb.global_name`	Oracleデータベースのグローバル名情報
`newrelicoracledb.db_id`	Oracleデータベース ID 情報
`newrelicoracledb.locked_accounts`	データベース内のロックされたユーザーアカウントの数
`newrelicoracledb.long_running_queries`	長時間実行されるクエリの数
`newrelicoracledb.sga_log_buffer_redo_allocation_retries`	リドゥバッファ割り当ての再試行回数
`newrelicoracledb.sga_log_buffer_redo_entries`	やり直しエントリ数
`newrelicoracledb.sorts_memory`	メモリ内で実行されたソート回数
`newrelicoracledb.sorts_disk`	ディスク上で実行されたソート回数
`newrelicoracledb.rollback_segments_gets`	ロールバックセグメントでの取得回数
`newrelicoracledb.rollback_segments_waits`	ロールバックセグメントでの待機回数
`newrelicoracledb.rollback_segments_wait_ratio`	ロールバックセグメントの待機率（待機回数／取得回数）
`newrelicoracledb.redo_log_parallel_write_waits`	ログファイル並列書き込みイベントの待機回数
`newrelicoracledb.redo_log_switch_completion_waits`	ログファイル切り替え完了イベントの待機回数
`newrelicoracledb.redo_log_switch_checkpoint_incomplete_waits`	ログファイル切り替え（チェックポイント不完全）イベントの待機回数
`newrelicoracledb.redo_log_switch_archiving_needed_waits`	ログファイル切り替え（アーカイブが必要）イベントの待機回数
`newrelicoracledb.sga_buffer_busy_waits`	バッファビジー待機イベントの数
`newrelicoracledb.sga_free_buffer_waits`	空きバッファ待機イベントの数
`newrelicoracledb.sga_free_buffer_inspected_waits`	検査された空きバッファ待機イベントの数

enable_system_scraper: trueを有効にしてこれらのメトリクスを収集します。

メトリクス名	説明
`newrelicoracledb.system.active_parallel_sessions`	アクティブな並列セッション
`newrelicoracledb.system.active_serial_sessions`	アクティブなシリアルセッション
`newrelicoracledb.system.background_checkpoints_per_second`	バックグラウンドチェックポイント数（1秒あたり）
`newrelicoracledb.system.background_cpu_usage_per_second`	バックグラウンドCPU使用率（1秒あたり）
`newrelicoracledb.system.background_time_per_second`	バックグラウンド処理時間（秒あたり）
`newrelicoracledb.system.branch_node_splits_per_second`	1秒あたりの分岐ノード分割数
`newrelicoracledb.system.branch_node_splits_per_transaction`	ブランチノードはトランザクションごとに分割されます
`newrelicoracledb.system.captured_user_calls`	キャプチャされたユーザーの通話
`newrelicoracledb.system.consistent_read_changes_per_second`	1秒あたりの読み取り変更数の一貫性
`newrelicoracledb.system.consistent_read_changes_per_transaction`	トランザクションごとの一貫した読み取り変更
`newrelicoracledb.system.consistent_read_gets_per_second`	1秒あたりの読み取り取得数（一貫性あり）
`newrelicoracledb.system.consistent_read_gets_per_transaction`	トランザクションごとの一貫した読み取り取得数
`newrelicoracledb.system.cpu_usage_per_second`	1秒あたりのCPU使用率
`newrelicoracledb.system.cpu_usage_per_transaction`	トランザクションあたりのCPU使用率
`newrelicoracledb.system.cr_blocks_created_per_second`	1秒あたりに作成されるCRブロック数
`newrelicoracledb.system.cr_blocks_created_per_transaction`	トランザクションごとに作成されるCRブロック
`newrelicoracledb.system.cr_undo_records_applied_per_second`	CR 取り消しレコード適用件数（1秒あたり）
`newrelicoracledb.system.cr_undo_records_applied_per_transaction`	CR トランザクションごとに適用されたレコードの取り消し
`newrelicoracledb.system.current_logons_count`	現在のログオン数
`newrelicoracledb.system.current_open_cursors_count`	現在開いているカーソルの数
`newrelicoracledb.system.current_os_load`	現在のOS負荷
`newrelicoracledb.system.cursor_cache_hit_ratio`	カーソルキャッシュのヒット率
`newrelicoracledb.system.database_time_per_second`	データベース処理時間（秒）
`newrelicoracledb.system.database_wait_time_ratio`	データベース待機時間比率
`newrelicoracledb.system.db_block_changes_per_second`	1秒あたりのDBブロック変更数
`newrelicoracledb.system.db_block_changes_per_transaction`	トランザクションごとのDBブロック変更
`newrelicoracledb.system.db_block_changes_per_user_call`	ユーザー呼び出しごとのDBブロック変更
`newrelicoracledb.system.db_block_gets_per_second`	DBブロックの取得数（1秒あたり）
`newrelicoracledb.system.db_block_gets_per_transaction`	DBブロックはトランザクションごとに取得されます
`newrelicoracledb.system.db_block_gets_per_user_call`	DBブロックはユーザー呼び出しごとに取得されます
`newrelicoracledb.system.dbwr_checkpoints_per_second`	DBWR チェックポイント/秒
`newrelicoracledb.system.disk_sort_per_second`	ディスクソート/秒
`newrelicoracledb.system.disk_sort_per_transaction`	トランザクションごとのディスクソート
`newrelicoracledb.system.enqueue_deadlocks_per_second`	1秒あたりのエンキューデッドロック数
`newrelicoracledb.system.enqueue_deadlocks_per_transaction`	トランザクションごとのエンキューデッドロック
`newrelicoracledb.system.enqueue_requests_per_second`	1秒あたりのリクエストキューへの追加数
`newrelicoracledb.system.enqueue_requests_per_transaction`	トランザクションごとのリクエストのキューイング数
`newrelicoracledb.system.enqueue_timeouts_per_second`	1秒あたりのエンキュータイムアウト数
`newrelicoracledb.system.enqueue_timeouts_per_transaction`	トランザクションごとのエンキュータイムアウト
`newrelicoracledb.system.enqueue_waits_per_transaction`	トランザクションごとのエンキュー待ち時間
`newrelicoracledb.system.execute_without_parse_ratio`	解析比率なしで実行する
`newrelicoracledb.system.executions_per_transaction`	トランザクションあたりの実行回数
`newrelicoracledb.system.executions_per_user_call`	ユーザー呼び出しごとの実行回数
`newrelicoracledb.system.full_index_scans_per_second`	1秒あたりのフルインデックススキャン回数
`newrelicoracledb.system.full_index_scans_per_transaction`	トランザクションごとのフルインデックススキャン
`newrelicoracledb.system.gc_cr_block_received_per_second`	GC CRブロック受信数（1秒あたり）（RAC）
`newrelicoracledb.system.gc_cr_block_received_per_transaction`	トランザクションごとに受信されたGC CRブロック（RAC）
`newrelicoracledb.system.gc_current_block_received_per_second`	GC（ガベージコレクション）の1秒あたりの受信ブロック数（RAC）
`newrelicoracledb.system.gc_current_block_received_per_transaction`	GC（ガベージコレクション）トランザクションごとの受信ブロック数（RAC）
`newrelicoracledb.system.global_cache_average_cr_get_time`	グローバルキャッシュの平均CR取得時間（RAC）
`newrelicoracledb.system.global_cache_average_current_get_time`	グローバルキャッシュの平均現在取得時間（RAC）
`newrelicoracledb.system.global_cache_blocks_corrupted`	グローバルキャッシュブロック破損（RAC）
`newrelicoracledb.system.global_cache_blocks_lost`	グローバルキャッシュブロック損失（RAC）
`newrelicoracledb.system.hard_parse_count_per_transaction`	トランザクションごとのハードパース回数
`newrelicoracledb.system.host_cpu_usage_per_second`	ホストCPU使用率（秒単位）
`newrelicoracledb.system.io_requests_per_second`	1秒あたりのI/Oリクエスト数
`newrelicoracledb.system.leaf_node_splits_per_second`	1秒あたりの葉節分割数
`newrelicoracledb.system.leaf_node_splits_per_transaction`	リーフノードのトランザクションごとの分割
`newrelicoracledb.system.library_cache_hit_ratio`	ライブラリキャッシュのヒット率
`newrelicoracledb.system.library_cache_miss_ratio`	ライブラリキャッシュミス率
`newrelicoracledb.system.logical_reads_per_second`	1秒あたりの論理読み取り回数
`newrelicoracledb.system.logical_reads_per_transaction`	トランザクションあたりの論理読み取り回数
`newrelicoracledb.system.logical_reads_per_user_call`	ユーザー呼び出しごとの論理読み取り
`newrelicoracledb.system.logons_per_second`	1 秒あたりのログオン数
`newrelicoracledb.system.logons_per_transaction`	トランザクションあたりのログオン数
`newrelicoracledb.system.long_table_scans_per_second`	長いテーブルを1秒あたりスキャンする回数
`newrelicoracledb.system.long_table_scans_per_transaction`	トランザクションごとのロングテーブルスキャン
`newrelicoracledb.system.memory_sorts_ratio`	メモリソート比率
`newrelicoracledb.system.network_traffic_volume_per_second`	1秒あたりのネットワークTraffic量
`newrelicoracledb.system.open_cursors_per_second`	1秒あたりのオープンカーソル数
`newrelicoracledb.system.open_cursors_per_transaction`	トランザクションごとのオープンカーソル数
`newrelicoracledb.system.parse_failure_count_per_second`	1秒あたりの解析失敗回数
`newrelicoracledb.system.parse_failure_count_per_transaction`	トランザクションごとの解析失敗回数
`newrelicoracledb.system.pga_cache_hit_percentage`	PGA キャッシュのヒット率
`newrelicoracledb.system.physical_lobs_reads_per_second`	物理LOBの1秒あたりの読み取り回数
`newrelicoracledb.system.physical_lobs_reads_per_transaction`	物理LOBの読み取り回数（トランザクションあたり）
`newrelicoracledb.system.physical_lobs_writes_per_second`	物理LOB書き込み/秒
`newrelicoracledb.system.physical_lobs_writes_per_transaction`	物理LOBのトランザクションごとの書き込み
`newrelicoracledb.system.physical_read_bytes_per_second`	1 秒あたりの物理読み取りバイト数
`newrelicoracledb.system.physical_read_io_requests_per_second`	1秒あたりの物理読み取りIOリクエスト数
`newrelicoracledb.system.physical_read_total_bytes_per_second`	物理読み取り合計バイト/秒
`newrelicoracledb.system.physical_read_total_io_requests_per_second`	物理読み取り合計IOリクエスト/秒
`newrelicoracledb.system.physical_reads_direct_per_second`	1秒あたりの直接物理読み取り数
`newrelicoracledb.system.physical_reads_direct_per_transaction`	トランザクションごとの物理読み取り
`newrelicoracledb.system.physical_reads_per_transaction`	トランザクションあたりの物理読み取り回数
`newrelicoracledb.system.physical_write_bytes_per_second`	物理書き込みバイト/秒
`newrelicoracledb.system.physical_write_io_requests_per_second`	1秒あたりの物理書き込みIOリクエスト数
`newrelicoracledb.system.physical_write_total_bytes_per_second`	物理書き込み合計バイト/秒
`newrelicoracledb.system.physical_write_total_io_requests_per_second`	物理書き込み合計IOリクエスト/秒
`newrelicoracledb.system.physical_writes_direct_per_second`	1秒あたりの直接書き込み物理書き込み
`newrelicoracledb.system.physical_writes_direct_per_transaction`	トランザクションごとの物理書き込み
`newrelicoracledb.system.physical_writes_per_transaction`	トランザクションあたりの物理書き込み
`newrelicoracledb.system.process_limit_percentage`	工程限界率
`newrelicoracledb.system.recursive_calls_per_second`	1秒あたりの再帰呼び出し回数
`newrelicoracledb.system.recursive_calls_per_transaction`	トランザクションあたりの再帰呼び出し回数
`newrelicoracledb.system.redo_allocation_hit_ratio`	再割り当てヒット率
`newrelicoracledb.system.redo_generated_bytes_per_transaction`	トランザクションごとに生成されるリドゥバイト数
`newrelicoracledb.system.redo_writes_per_second`	1秒あたりのリドゥ書き込み回数
`newrelicoracledb.system.redo_writes_per_transaction`	トランザクションごとのリドゥ書き込み
`newrelicoracledb.system.row_cache_hit_ratio`	ロウキャッシュのヒット率
`newrelicoracledb.system.row_cache_miss_ratio`	行キャッシュミス率
`newrelicoracledb.system.rows_per_sort`	ソートごとの行数
`newrelicoracledb.system.session_count`	セッション数
`newrelicoracledb.system.session_limit_percentage`	セッション制限率
`newrelicoracledb.system.shared_pool_free_percentage`	共有プール無料利用率
`newrelicoracledb.system.soft_parse_ratio`	ソフトパース比率
`newrelicoracledb.system.sql_service_response_time`	SQL サービスの応答時間
`newrelicoracledb.system.streams_pool_usage_percentage`	ストリームプール使用率
`newrelicoracledb.system.temp_space_used`	一時的に使用するスペース
`newrelicoracledb.system.total_index_scans_per_second`	1秒あたりのインデックススキャン総数
`newrelicoracledb.system.total_index_scans_per_transaction`	トランザクションあたりのインデックススキャン総数
`newrelicoracledb.system.total_parse_count_per_second`	1秒あたりの合計解析回数
`newrelicoracledb.system.total_parse_count_per_transaction`	トランザクションごとの合計解析回数
`newrelicoracledb.system.total_sorts_per_user_call`	ユーザー呼び出しごとの合計ソート数
`newrelicoracledb.system.total_table_scans_per_second`	1秒あたりのテーブルスキャン総数
`newrelicoracledb.system.total_table_scans_per_transaction`	トランザクションあたりのテーブルスキャン総数
`newrelicoracledb.system.total_table_scans_per_user_call`	ユーザー呼び出しごとのテーブルスキャン総数
`newrelicoracledb.system.transactions_per_logon`	ログインごとのトランザクション数
`newrelicoracledb.system.transactions_per_second`	1秒あたりのトランザクション数
`newrelicoracledb.system.user_calls_per_second`	1秒あたりのユーザー呼び出し数
`newrelicoracledb.system.user_calls_per_transaction`	トランザクションあたりのユーザー呼び出し回数
`newrelicoracledb.system.user_calls_ratio`	ユーザー通話率
`newrelicoracledb.system.user_commits_percentage`	ユーザーコミット率
`newrelicoracledb.system.user_limit_percentage`	ユーザー制限率
`newrelicoracledb.system.user_rollback_undo_records_applied_per_second`	ユーザーロールバック取り消しレコード適用件数（1秒あたり）
`newrelicoracledb.system.user_rollback_undo_records_applied_per_transaction`	ユーザーロールバック取り消しレコード（トランザクションごとに適用）
`newrelicoracledb.system.user_rollbacks_per_second`	1秒あたりのユーザーロールバック数
`newrelicoracledb.system.user_rollbacks_percentage`	ユーザーロールバック率

enable_connection_scraper: trueを有効にしてこれらのメトリクスを収集します。

メトリクス名	説明
`newrelicoracledb.connection.sessions_by_status`	ステータス別にグループ化されたセッション数
`newrelicoracledb.connection.sessions_by_type`	セッション数をタイプ別にグループ化
`newrelicoracledb.connection.logons_cumulative`	インスタンス起動以降の累計ログオン回数
`newrelicoracledb.connection.logons_current`	現在アクティブなログオン数
`newrelicoracledb.connection.shared_servers`	共有サーバー数
`newrelicoracledb.connection.dispatchers`	ディスパッチャーの数
`newrelicoracledb.connection.circuits`	アクティブ回路の数
`newrelicoracledb.connection.resource_current_utilization`	Oracleリソースの現在の利用状況
`newrelicoracledb.connection.resource_max_utilization`	Oracleのリソースを、起動時から最大限に活用しています。
`newrelicoracledb.connection.resource_limit`	Oracleリソースの制限値
`newrelicoracledb.connection.user_commits`	ユーザーコミット数
`newrelicoracledb.connection.user_rollbacks`	ユーザーによるロールバック数
`newrelicoracledb.connection.parse_count_total`	解析呼び出しの総数
`newrelicoracledb.connection.parse_count_hard`	ハードパース呼び出しの数
`newrelicoracledb.connection.sqlnet_roundtrips`	クライアントとの間でSQL*Netが往復した回数
`newrelicoracledb.connection.bytes_sent`	SQL*Net経由でクライアントに送信されたバイト
`newrelicoracledb.connection.bytes_received`	SQL*Net を介してクライアントから受信したバイト数

enable_pdb_scraper: trueを有効にして、これらの PDB (プラガブルデータベース) メトリクスを収集します。

メトリクス名	説明
`newrelicoracledb.pdb.active_parallel_sessions`	PDBにおけるアクティブな並列セッション数
`newrelicoracledb.pdb.active_serial_sessions`	PDBにおけるアクティブなシリアルセッションの数
`newrelicoracledb.pdb.average_active_sessions`	PDBにおけるアクティブセッションの平均数
`newrelicoracledb.pdb.background_cpu_usage_per_second`	PDBにおける1秒あたりのバックグラウンドCPU使用率
`newrelicoracledb.pdb.background_time_per_second`	PDBにおける1秒あたりの背景時間
`newrelicoracledb.pdb.block_changes_per_second`	PDBにおける1秒あたりのDBブロック変更数
`newrelicoracledb.pdb.block_changes_per_transaction`	PDBにおけるトランザクションごとのDBブロック変更
`newrelicoracledb.pdb.cpu_time_ratio`	データベース PDB の CPU 時間比率
`newrelicoracledb.pdb.cpu_usage_per_second`	PDBにおける1秒あたりのCPU使用率
`newrelicoracledb.pdb.cpu_usage_per_transaction`	PDBにおけるトランザクションごとのCPU使用率
`newrelicoracledb.pdb.current_logons`	PDBにおける現在のログオン数
`newrelicoracledb.pdb.current_open_cursors`	PDB内の現在開いているカーソルの数
`newrelicoracledb.pdb.db_physical_read_bytes_per_second`	PDBにおける1秒あたりの物理読み取りバイト数
`newrelicoracledb.pdb.db_physical_reads_per_second`	PDBにおける1秒あたりの物理読み取り数
`newrelicoracledb.pdb.db_physical_write_bytes_per_second`	PDBにおける1秒あたりの物理書き込みバイト数
`newrelicoracledb.pdb.db_physical_writes_per_second`	PDBにおける1秒あたりの物理書き込み数
`newrelicoracledb.pdb.execute_without_parse_ratio`	PDBで解析比率なしで実行する
`newrelicoracledb.pdb.executions_per_second`	PDBにおける1秒あたりの実行回数
`newrelicoracledb.pdb.executions_per_transaction`	PDBにおけるトランザクションあたりの実行回数
`newrelicoracledb.pdb.hard_parse_count_per_second`	PDBにおける1秒あたりのハードパース回数
`newrelicoracledb.pdb.hard_parse_count_per_transaction`	PDBにおけるトランザクションごとのハードパース数
`newrelicoracledb.pdb.logical_reads_per_second`	PDBにおける1秒あたりの論理読み取り回数
`newrelicoracledb.pdb.logical_reads_per_transaction`	PDBにおけるトランザクションごとの論理読み取り
`newrelicoracledb.pdb.logons_per_second`	PDBにおける1秒あたりのログオン数
`newrelicoracledb.pdb.logons_per_transaction`	PDBにおけるトランザクションごとのログオン数
`newrelicoracledb.pdb.network_traffic_byte_per_second`	1秒あたりのネットワークトラフィック量（バイト単位、PDB形式）
`newrelicoracledb.pdb.open_cursors_per_second`	PDBにおける1秒あたりのオープンカーソル数
`newrelicoracledb.pdb.open_cursors_per_transaction`	PDB内のトランザクションごとのオープンカーソル
`newrelicoracledb.pdb.parse_failure_count_per_second`	PDBにおける1秒あたりの解析失敗回数
`newrelicoracledb.pdb.physical_read_bytes_per_second`	PDBにおける物理読み取り合計バイト/秒
`newrelicoracledb.pdb.physical_reads_per_transaction`	PDBにおけるトランザクションごとの物理読み取り回数
`newrelicoracledb.pdb.physical_write_bytes_per_second`	PDBにおける物理書き込み合計バイト/秒
`newrelicoracledb.pdb.physical_writes_per_transaction`	PDBにおけるトランザクションごとの物理書き込み
`newrelicoracledb.pdb.redo_generated_bytes_per_second`	1秒あたりに生成されるリドゥログのバイト数（PDB形式）
`newrelicoracledb.pdb.redo_generated_bytes_per_transaction`	トランザクションごとに生成されるリドゥログのバイト数（PDB内）
`newrelicoracledb.pdb.response_time_per_transaction`	PDB での 1 回あたりの応答時間
`newrelicoracledb.pdb.session_count`	PDBにおけるセッション数
`newrelicoracledb.pdb.soft_parse_ratio`	PDBにおけるソフトパース比率
`newrelicoracledb.pdb.sql_service_response_time`	PDB での SQL サービスの応答時間
`newrelicoracledb.pdb.total_parse_count_per_second`	PDBにおける1秒あたりの合計解析回数
`newrelicoracledb.pdb.total_parse_count_per_transaction`	PDBにおけるトランザクションごとの総解析回数
`newrelicoracledb.pdb.transactions_per_second`	PDBにおける1秒あたりのユーザートランザクション数
`newrelicoracledb.pdb.user_calls_per_second`	PDBにおける1秒あたりのユーザー呼び出し数
`newrelicoracledb.pdb.user_calls_per_transaction`	PDBにおけるトランザクションごとのユーザー呼び出し回数
`newrelicoracledb.pdb.user_commits_per_second`	PDBにおける1秒あたりのユーザーコミット数
`newrelicoracledb.pdb.user_commits_percentage`	PDBにおけるユーザーのコミット率
`newrelicoracledb.pdb.user_rollbacks_per_second`	PDBにおける1秒あたりのユーザーロールバック数
`newrelicoracledb.pdb.user_rollbacks_percentage`	PDBにおけるユーザーロールバック率
`newrelicoracledb.pdb.wait_time_ratio`	PDBにおけるデータベース待機時間比率

CDB環境のコンテナメトリクスを収集するには、 enable_container_scraper: true有効にしてください。

メトリクス名	説明
`newrelicoracledb.container.status`	コンテナのオープンモードステータス（1=読み取り/書き込み、0=その他）
`newrelicoracledb.container.restricted`	コンテナ制限モード（1=はい、0=いいえ）
`newrelicoracledb.pdb.open_mode`	PDBオープンモード（1=読み書き、0=その他）
`newrelicoracledb.pdb.total_size_bytes`	PDBの合計サイズ（バイト単位）
`newrelicoracledb.tablespace.used_bytes`	CDBにおけるテーブルスペースあたりの使用バイト数
`newrelicoracledb.tablespace.total_bytes`	CDBにおけるテーブルスペースごとの合計バイト数
`newrelicoracledb.tablespace.used_percent`	CDBにおけるテーブルスペースごとの使用率
`newrelicoracledb.datafile.size_bytes`	データファイルのサイズ（バイト単位）
`newrelicoracledb.datafile.used_bytes`	データファイルで使用されているバイト数
`newrelicoracledb.datafile.autoextensible`	データファイルの自動拡張ステータス（1=はい、0=いいえ）
`newrelicoracledb.service.status`	Oracleサービスのステータス（1=アクティブ、0=非アクティブ）
`newrelicoracledb.service.count`	コンテナあたりのサービス数

enable_rac_scraper: trueを有効にして、これらの RAC (Real Application クラスタ) メトリクスを収集します。

メトリクス名	説明
`newrelicoracledb.asm.diskgroup.total_mb`	ASMディスクグループの総容量（MB）
`newrelicoracledb.asm.diskgroup.free_mb`	ASMディスクグループの空き容量（MB）
`newrelicoracledb.asm.diskgroup.offline_disks`	ASMディスクグループ内のオフラインディスクの数
`newrelicoracledb.rac.wait_time`	クラスター待機時間の割合（マイクロ秒/秒）
`newrelicoracledb.rac.total_waits`	クラスター待機イベントの総数
`newrelicoracledb.rac.instance.status`	RAC インスタンスのステータス (1=OPEN 0=その他)
`newrelicoracledb.rac.instance.uptime_seconds`	インスタンスの起動からの稼働時間（秒）
`newrelicoracledb.rac.instance.database_status`	データベースの状態を示すインジケーター（1＝アクティブ、0＝その他）
`newrelicoracledb.rac.instance.active_state`	インスタンスのアクティブ状態を示すインジケーター（1=通常、0=その他）
`newrelicoracledb.rac.instance.logins_allowed`	インスタンスログインステータスインジケーター（1=許可、0=制限）
`newrelicoracledb.rac.instance.archiver_started`	アーカイブ機能の状態表示（1=開始済み、0=停止済み）
`newrelicoracledb.rac.instance.version_info`	Oracleデータベースのバージョン情報 (プロパティでは常に 1 バージョン)
`newrelicoracledb.rac.service.instance_id`	サービスが現在実行されているインスタンスID
`newrelicoracledb.rac.service.network_config`	サービスネットワーク設定（プロパティに常に1つの設定）
`newrelicoracledb.rac.service.clb_config`	接続負荷分散設定（属性には常に1つの設定が含まれます）
`newrelicoracledb.rac.service.goal_config`	サービス目標の設定（属性には常に1つの目標が含まれます）
`newrelicoracledb.rac.service.blocked_status`	サービスブロック表示（1＝ブロック済み、0＝ブロックなし）
`newrelicoracledb.rac.service.fan_enabled`	高速アプリケーション通知（FAN）有効インジケーター（1=有効、0=無効）
`newrelicoracledb.rac.service.transaction_guard_enabled`	トランザクションガード有効インジケーター（1=有効、0=無効）
`newrelicoracledb.rac.service.drain_timeout_seconds`	サービス停止前のセッションドレインタイムアウト（秒）
`newrelicoracledb.rac.service.replay_timeout_seconds`	アプリケーション継続性リプレイ開始タイムアウト（秒）

enable_database_info_scraper: trueを有効にして、これらのデータベース情報メトリクスを収集します:

メトリクス名	説明
`newrelicoracledb.database.info`	データベースのバージョンと設定情報
`newrelicoracledb.hosting.info`	データベースホスティングとプラットフォーム情報
`newrelicoracledb.database.role`	データベースの役割とData Guardの設定

enable_query_monitoring: trueを有効にして、これらの低速監視メトリクスを収集します:

メトリクス名	説明
`newrelicoracledb.slow_queries.execution_count`	スロー実行の実行数
`newrelicoracledb.slow_queries.total_elapsed_time`	スロー書き込みの累計経過時間の合計
`newrelicoracledb.slow_queries.total_cpu_time`	スロー書き込みの合計累積 CPU 時間
`newrelicoracledb.slow_queries.total_wait_time`	スロー書き込みの合計累積待機時間 (elapsed_time - cpu_time)
`newrelicoracledb.slow_queries.total_rows_examined`	スロー書き込みについて検査された合計累積行数 (バッファーの取得/論理読み取り)
`newrelicoracledb.slow_queries.total_rows_returned`	スローペースで返された累積行数の合計 (処理された行数)
`newrelicoracledb.slow_queries.total_disk_reads`	スロー書き込みの合計累積ディスク読み取り数
`newrelicoracledb.slow_queries.total_disk_writes`	スロー書き込みの合計累積直接書き込み - バッファキャッシュをバイパスした書き込み
`newrelicoracledb.slow_queries.interval_execution_count`	前回のスクレイピング以降の新しい実行数 (デルタメトリクス)
`newrelicoracledb.slow_queries.interval_elapsed_time`	最後のポーリングの合計経過時間 (デルタメトリクスは平均化されていません)
`newrelicoracledb.slow_queries.interval_cpu_time`	最後のポーリング冷静の合計 CPU 時間 (デルタメトリクスは平均化されていません)
`newrelicoracledb.slow_queries.interval_wait_time`	前回のポーリング冷静の合計待機時間 (デルタメトリクスは平均化されていません)
`newrelicoracledb.slow_queries.interval_buffer_gets`	最後のポーリング冷静で取得された合計バッファー (論理読み取り) (デルタメトリクスは平均化されていません)
`newrelicoracledb.slow_queries.interval_rows_processed`	最後のポーリング冷静で処理された（返された）行の合計（デルタメトリクスは平均化されていません）
`newrelicoracledb.slow_queries.interval_disk_reads`	最後のポーリング冷静における合計ディスク読み取り数 (デルタメトリクスは平均化されていません)
`newrelicoracledb.slow_queries.interval_disk_writes`	最後のポーリング態勢での直接書き込みの合計 - バッファキャッシュをバイパスした書き込み (デルタメトリクスは平均化されません)
`newrelicoracledb.slow_queries.interval_avg_elapsed_time`	最後のポーリング待機における実行あたりの平均経過時間 (デルタメトリクス)
`newrelicoracledb.slow_queries.interval_avg_cpu_time`	最後のポーリング監視における実行あたりの平均 CPU 時間 (デルタメトリクス)
`newrelicoracledb.slow_queries.interval_avg_wait_time`	最後のポーリング冷静における実行ごとの平均待機時間 (デルタメトリクス)
`newrelicoracledb.slow_queries.interval_avg_buffer_gets`	最後のポーリング間隔での実行ごとの平均バッファ取得 (論理読み取り) (デルタメトリクス)
`newrelicoracledb.slow_queries.interval_avg_rows_processed`	最後のポーリング間隔での実行ごとに処理された (返された) 平均行数 (デルタメトリクス)
`newrelicoracledb.slow_queries.interval_avg_disk_reads`	最後のポーリング監視における実行あたりの平均ディスク読み取り数 (デルタメトリクス)
`newrelicoracledb.slow_queries.interval_avg_disk_writes`	最後のポーリング冷静における実行あたりの平均直接書き込み - バッファキャッシュをバイパスした書き込み (デルタメトリクス)
`newrelicoracledb.slow_queries.query_details`	スロー詳細カウント
`newrelicoracledb.child_cursors.elapsed_time`	この子カーソルの実行あたりの平均経過時間（ミリ秒）
`newrelicoracledb.child_cursors.cpu_time`	この子カーソルの実行あたりの平均CPU時間（ミリ秒）
`newrelicoracledb.child_cursors.user_io_wait_time`	平均この子カーソルの実行ごとのI/O待機時間（ミリ秒）
`newrelicoracledb.child_cursors.buffer_gets`	この子カーソルの実行あたりの平均バッファ取得回数
`newrelicoracledb.child_cursors.disk_reads`	この子カーソルの実行あたりの平均ディスク読み取り回数
`newrelicoracledb.child_cursors.executions`	この子カーソルの実行総数
`newrelicoracledb.child_cursors.invalidations`	この子カーソルが無効化された回数
`newrelicoracledb.child_cursors.details`	子カーソルの詳細（読み込み時間を含む）
`newrelicoracledb.execution_plan`	Oracle SQL実行計画の詳細（運用コスト、カーディナリティ、リソース見積もりを含む）

次のステップ

NRDOT を使用してOracleデータベース監視を設定した後:

データベースのメトリクスを視覚化するカスタムダッシュボードを作成する
クリティカルデータベースパフォーマンス閾値のアラートを設定する
New Relicのクエリ機能を使用してデータを探索する

この機械翻訳は、参考として提供されています。

NRDOTによるOracleデータベース監視

プレビュー

前提条件 .css-21sua1{background:none;border:none;width:0;padding:0;}

Oracleデータベース監視用の NRDOT Collectorセットアップ

ヒント

設置方法

重要

ARM64用アーキテクチャー

データベースユーザーを構成する

ヒント

マルチテナントデータベースの監視権限を付与する

NRDOT Collectorを構成する

重要

ヒント

NRDOTコレクターを再起動します

ヒント

（オプション）マルチレシーバー設定

ヒント

（オプション）APMとデータベースの相関関係を設定する

重要

（オプション）シークレット管理を構成する

データを探す、使う

設置方法

AMD64向けアーキテクチャー

ARM64用アーキテクチャー

データベースユーザーを構成する

RDS データベースに対する監視権限を付与する

NRDOT Collectorを構成する

重要

NRDOTコレクターを再起動します

ヒント

（オプション）マルチレシーバー設定

ヒント

（オプション）APMとデータベースの相関関係を設定する

重要

（オプション）シークレット管理を構成する

データを探す、使う

NRDOT コレクターがサポートするコマンド

NRDOT Collectorコマンド

利用可能なメトリクス

デフォルトのメトリクス

NRDOT Collectorによって収集されたデフォルトのメトリクス

追加のメトリクス

テーブルスペース・メトリクス

コアメトリクス

システム指標

接続メトリクス

PDBメトリクス

コンテナメトリクス

RACメトリクス

データベース情報メトリクス

クエリ監視メトリクス

次のステップ

前提条件