Helmを使用したOracle監視用NRDOTのインストールと設定

oracle-otel Helmチャートを使用して、Kubernetes上でOracle データベースの監視をインストールおよび構成できます。オプションとして、チャートは監視データベースユーザーを作成するセットアップジョブを実行することもできます。

前提条件

有効なNew Relicのライセンスキー。
Helm 3.0以降、およびKubernetesクラスタにアクセスするように設定されたkubectl。
KubernetesクラスタからOracleデータベースのホストおよびリスナーポートへのネットワーク接続。
すでに作成済みの監視データベースユーザー、またはチャートのセットアップジョブがユーザーを作成できるようにするためのOracleデータベース管理者資格情報（RDSマスターユーザー、SYS、またはADMIN）のいずれかです。以下の監視資格情報の設定を参照してください。

ネームスペースを作成

インストール先のネームスペースを作成します。helm install --create-namespaceは最後のインストール手順でのみネームスペースを作成するため、次の手順でシークレットを作成する前に、ネームスペースが存在している必要があります：

bash

$kubectl create namespace newrelic

ヒント

以下のすべてのコマンドで-nを渡す必要がないように、現在のkubectlコンテキストのデフォルトのネームスペースとして設定します：

bash

$kubectl config set-context --current --namespace=newrelic

監視資格情報の設定

チャートのセットアップジョブでOracleデータベースの監視ユーザーを作成するかどうか、および作成しない場合はその認証情報をどのように提供するかを決定してください：

この方法ではセットアップジョブがないため、ここで監視ユーザーが自動的に作成されることはありません。チャートをインストールする前に、ご自身で作成してください：環境に応じて、オンホストCDB またはオンホストPDB のデータベースユーザーの設定 および監視権限の付与の手順に従ってください。

次のステップで、監視用のユーザー名とパスワードを直接values.yamlに設定します。

この方法でも、セットアップジョブはありません。上記のプレーンテキストの資格情報を使用する方法とまったく同じように、まずご自身で監視ユーザーを作成してください。唯一の違いは、資格情報の保存場所です：values.yamlにプレーンテキストで保存する代わりに、Kubernetesシークレットに保存します：

bash

$kubectl create secret generic oracle-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic

この方法では、チャートのセットアップジョブがデータベース管理者の認証情報を使用して監視ユーザーを作成します。監視および管理者の認証情報はどちらもKubernetesシークレットとして提供する必要があります：セットアップジョブはプレーンテキストの管理者認証情報を受け入れることはなく、これを有効にするにはシークレットベースの監視認証情報も必要になります。

監視のユーザー名とパスワードを使用してシークレットを作成します。これは、セットアップジョブが作成し、コレクターが接続に使用するIDです：
bash
```
$kubectl create secret generic oracle-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic
```
セットアップジョブは、Kubernetesシークレット経由でのみ管理者資格情報を受け入れます（values.yamlにプレーンテキストのユーザー名/パスワードを含めることはできません）。この認証情報はユーザーを作成し、データベースへの幅広いアクセス権を付与できるため、独自のシークレットとして作成してください：
bash
```
$kubectl create secret generic oracle-admin-creds \
>  --from-literal=username=<ADMIN_USERNAME> \
>  --from-literal=password='<ADMIN_PASSWORD>' \
>  -n newrelic
```

Helmの値を設定します

環境に合わせてoracle.topologyを設定してください：

価値	説明
`cdb`	オンホスト、マルチテナントCDB。このCDB配下のすべてのPDBがモニターされます。
`pdb`	オンホスト、シングルPDB。
`rds`	AWS RDS上のOracleデータベース。
`adb`	Oracle Autonomous データベース。

前の手順で選択した資格情報メソッドに一致するvalues.yamlを使用します：

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

oracle:
  topology: <cdb|pdb|rds|adb>
  endpoint: <YOUR_DB_HOST>:<YOUR_DB_PORT>
  service: <YOUR_SERVICE_NAME>
  username: <YOUR_MONITORING_USERNAME>
  password: <YOUR_MONITORING_PASSWORD>

# No setup job runs, so create the monitoring user yourself
# before installing the chart.
setupJob:
  enabled: false

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

oracle:
  topology: <cdb|pdb|rds|adb>
  endpoint: <YOUR_DB_HOST>:<YOUR_DB_PORT>
  service: <YOUR_SERVICE_NAME>
  existingSecret: oracle-monitor-creds

# No setup job runs, so the monitoring user referenced by
# this secret must already exist - create it yourself
# before installing the chart.
setupJob:
  enabled: false

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

oracle:
  topology: <cdb|pdb|rds|adb>
  endpoint: <YOUR_DB_HOST>:<YOUR_DB_PORT>
  service: <YOUR_SERVICE_NAME>
  existingSecret: oracle-monitor-creds

setupJob:
  enabled: true
  image:
    # -- Oracle Instant Client + sqlplus image. No default: pulling from container-registry.oracle.com requires accepting Oracle's license terms first. See README.
    repository: ""
    tag: ""
    pullPolicy: IfNotPresent
  oracleAdmin:
    existingSecret: oracle-admin-creds

パラメータ	説明
`licenseKey`	New Relicライセンスキー。
`otlpEndpoint`	スキームなしの単なる `host:port` としての、お客様のリージョンのOTLP/gRPCエンドポイント： `otlp.nr-data.net:4317` (US)または `otlp.eu01.nr-data.net:4317` (EU)。詳細については、 New Relic OTLPエンドポイントのドキュメントを参照してください。
`oracle.endpoint`	クラスタから到達可能な、Oracleデータベースのホスト（またはRDSエンドポイント）およびリスナーポート。
`oracle.service`	コレクター接続用のCDB、PDB、RDS、またはADBのサービス名です。
`setupJob.image.repository` / `setupJob.image.tag`	セットアップジョブで使用されるOracle Instant Client+ `sqlplus` イメージ。デフォルトはありません： `container-registry.oracle.com` からプルするには、まずOracleのライセンス条項に同意する必要があるため、独自のイメージを用意する必要があります。セットアップジョブが有効になっている、シークレットベースの認証情報の場合にのみ必要です。

ヒント

利用可能なすべての設定オプションについては、チャートのvalues.yamlを参照してください。

(オプション) 1つのリリースから複数のインスタンスをモニターする

1つのリリースで単一のコレクターポッドから複数のOracleデータベースインスタンスをモニターするには、oracle.*の代わりにoracleMulti.enabled: trueを設定します。2つのモードは相互に排他的です：同じリリースでoracle.endpointとoracleMulti.enabled: trueを設定しないでください。リリース内のすべてのインスタンスは同じoracleMulti.topology（cdb、pdb、rds、またはadb）を共有する必要があります：トポロジの混在、たとえばRDSインスタンスとセルフホスト型CDBなどは、1つのリリースではサポートされていません；代わりにトポロジごとに個別のリリースを使用してください。

マルチインスタンスモードには、プレーンなユーザー名/パスワードのパスはありません：各インスタンスには、監視資格情報を含む独自のKubernetesシークレットが必要です。セットアップジョブで各監視ユーザーも作成するかどうかを決定します：

インストールする前に、各インスタンスの監視ユーザーのシークレットを自分で作成してください（values.yamlで指定したnameと一致するように、インスタンスごとに繰り返します）：

bash

$kubectl create secret generic db1-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic
$# Repeat for every instance (db2-monitor-creds, ...)

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

# EDIT the two example entries below (or add more) to match
# your real instances - each `name` must be unique within
# this release and match the Secret you created for it.
oracleMulti:
  enabled: true
  topology: <cdb|pdb|rds|adb>
  collectionInterval: 15s
  databases:
    - name: db1
      endpoint: <YOUR_DB_1_HOST>:<YOUR_DB_1_PORT>
      service: <YOUR_DB_1_SERVICE_NAME>
      existingSecret: db1-monitor-creds
    - name: db2
      endpoint: <YOUR_DB_2_HOST>:<YOUR_DB_2_PORT>
      service: <YOUR_DB_2_SERVICE_NAME>
      existingSecret: db2-monitor-creds

# No admin credential is configured here since the setup
# job is disabled - create each instance's monitoring user
# yourself first.
setupJob:
  enabled: false

各インスタンスには、独自の監視ユーザーシークレットと独自の管理者資格情報シークレットの両方が必要です（インスタンスごとに繰り返します）：

bash

$kubectl create secret generic db1-monitor-creds \
>  --from-literal=username=<MONITORING_USERNAME> \
>  --from-literal=password='<MONITORING_PASSWORD>' \
>  -n newrelic
>kubectl create secret generic db1-admin-creds \
>  --from-literal=username=<ADMIN_USERNAME> \
>  --from-literal=password='<ADMIN_PASSWORD>' \
>  -n newrelic
$# Repeat for every instance (db2-monitor-creds, db2-admin-creds, ...)

licenseKey: <YOUR_LICENSE_KEY>
otlpEndpoint: otlp.nr-data.net:4317

# EDIT the two example entries below (or add more) to match
# your real instances - each `name` must be unique within
# this release and match the Secrets you created for it.
oracleMulti:
  enabled: true
  topology: <cdb|pdb|rds|adb>
  collectionInterval: 15s
  databases:
    - name: db1
      endpoint: <YOUR_DB_1_HOST>:<YOUR_DB_1_PORT>
      service: <YOUR_DB_1_SERVICE_NAME>
      existingSecret: db1-monitor-creds
      oracleAdmin:
        existingSecret: db1-admin-creds
    - name: db2
      endpoint: <YOUR_DB_2_HOST>:<YOUR_DB_2_PORT>
      service: <YOUR_DB_2_SERVICE_NAME>
      existingSecret: db2-monitor-creds
      oracleAdmin:
        existingSecret: db2-admin-creds

setupJob:
  enabled: true
  image:
    repository: ""
    tag: ""

パラメータ	説明
`oracleMulti.enabled`	1つのリリースから複数のインスタンスをモニターするには、 `oracle.*` の代わりに `true` に設定します。デフォルトは `false` です。
`oracleMulti.topology`	`cdb` 、 `pdb` 、 `rds` 、または `adb` （ `oracle.topology` と同じ意味）で、このリリースのすべてのインスタンスで共有されます。
`oracleMulti.collectionInterval`	すべてのエントリのデフォルトのスクレイプ間隔です。デフォルトは `15s` です。そのエントリ独自の `collectionInterval` を使用して、特定のインスタンスに対してこれを上書きします。
`oracleMulti.databases`	モニターするインスタンスの一覧。各エントリには一意の `name` 、 `endpoint` （ `host:port` ）、 `service` 、および `existingSecret` が必要です； `setupJob.enabled` が `true` の場合にのみ、エントリごとに `oracleAdmin.existingSecret` を追加してください。

ヒント

他のNRDOT Helmチャートとは異なり、OracleではインスタンスごとにcollectionIntervalをオーバーライドできます。その他のすべてのスクレイプ設定は、引き続きすべてのインスタンスに同じように適用されます。その他に異なる必要があるものについては、additionalReceiverConfigを使用してください。セットアップジョブは、リリースごとに1回ではなく、インスタンス（<release>-setup-<name>）ごとに1回実行されます。

Helmチャートをインストールする

New Relic Helm リポジトリを追加します。

bash

$helm repo add newrelic https://helm-charts.newrelic.com
$helm repo update

values.yamlファイルを使用してチャートをインストールします：

bash

$helm upgrade --install oracle-otel newrelic/oracle-otel \
>  -n newrelic \
>  --create-namespace \
>  -f values.yaml

インストレーションを確認する

セットアップジョブが完了し、コレクターポッドが実行されていることを確認してください：
bash
```
$kubectl get jobs,pods -n newrelic --watch
```

データが到着していることを確認するには、クエリビルダーでこのクエリを実行してください：

SELECT count(*) FROM Metric
WHERE metricName LIKE 'oracledb.%'
AND instrumentation.provider = 'opentelemetry'
SINCE 10 minutes ago

New RelicでOracleデータベースのエンティティを見つけるには、「データの検索と使用」をご覧ください。

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

Helmを使用したOracle監視用NRDOTのインストールと設定

前提条件

ネームスペースを作成

ヒント

監視資格情報の設定

セットアップジョブなし：プレーンなユーザー名とパスワード

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

Helmの値を設定します

セットアップジョブなし：プレーンなユーザー名とパスワード

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

ヒント

(オプション) 1つのリリースから複数のインスタンスをモニターする

セットアップジョブなし

自動セットアップジョブ

ヒント

Helmチャートをインストールする

インストレーションを確認する

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

Helmを使用したOracle監視用NRDOTのインストールと設定

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

ネームスペースを作成

ヒント

監視資格情報の設定

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

Helmの値を設定します

セットアップジョブなし：プレーンなユーザー名とパスワード

セットアップジョブなし：シークレットベースの認証情報

自動セットアップジョブ

ヒント

(オプション) 1つのリリースから複数のインスタンスをモニターする

セットアップジョブなし

自動セットアップジョブ

ヒント

Helmチャートをインストールする

インストレーションを確認する

前提条件