Oracle エージェント

前提条件

  • エージェントのインストールに必要な前提条件の確認については エージェントのインストールに必要な前提条件の確認 を参照してください。
  • SixthSense コレクターの URL/IP（カスタマーサポートから提供されるテナント URL）
  • SixthSense ポータルからのアクセストークン。トークン取得については「SixthSense ポータル はじめに」の アクセストークンの取得 を参照してください。
  • Oracle エージェントイメージ ss-oracle-agent
  • DB の詳細（ホスト名、ポート、DB 名、DB ユーザー認証情報、Oracle サービス名）
  • クエリを使用してサービス名を取得します。パラメーター service_name; を使用してください。
  • カスタマーサポートから提供されるパッケージトークンを使用して、エージェントをダウンロードします。

エージェントのダウンロード

Windows および Linux ベースのサーバーの場合は、次のリンクを使用します。

curl --header "PRIVATE-TOKEN:{{TOKEN}}" --output Sixthsense-Meter-Agent.zip "https://artifacts-observability.sixthsense.rakuten.com/api/v4/projects/32/packages/generic/Meter-Agent/latest/meter-agent.zip"
note

エージェントはオペレーティングシステムとアーキテクチャに依存します。

DB ユーザーの権限

Oracle サーバーから DB メトリクスを収集するには、まず最初に SELECT 権限を持つ Oracle ユーザーを作成する必要があります。

以下の手順に従いユーザーを作成し、権限を付与します。

Oracle SQLPlus シェルで、必要な権限を持つユーザーを作成します。

ALTER SESSION set "_Oracle_SCRIPT"=true;
CREATE USER <username> IDENTIFIED BY "<user_password>";
GRANT CONNECT TO <username>;
GRANT SELECT ON cdb_data_files TO <username>;
GRANT SELECT ON cdb_pdbs TO <username>;
GRANT SELECT ON cdb_users TO <username>;
GRANT SELECT ON gv_$sysmetric TO <username>;
GRANT SELECT ON gv_$pgastat TO <username>;
GRANT SELECT ON gv_$instance TO <username>;
GRANT SELECT ON gv_$filestat TO <username>;
GRANT SELECT ON gv_$parameter TO <username>;
GRANT SELECT ON sys.dba_data_files TO <username>;
GRANT SELECT ON DBA_TABLESPACES TO <username>;
GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS TO <username>;
GRANT SELECT ON gv_$session TO <username>;
GRANT SELECT ON gv_$sesstat TO <username>;
GRANT SELECT ON gv_$statname TO <username>;
GRANT SELECT ON gv_$rowcache TO <username>;
GRANT SELECT ON gv_$sga TO <username>;
GRANT SELECT ON gv_$sysstat TO <username>;
GRANT SELECT ON v_$database TO <username>;
GRANT SELECT ON gv_$librarycache TO <username>;
GRANT SELECT ON gv_$sqlarea TO <username>;
GRANT SELECT ON gv_$system_event TO <username>;
GRANT SELECT ON dba_tablespaces TO <username>;
GRANT SELECT ON gv_$session_wait TO <username>;
GRANT SELECT ON gv_$rollstat TO <username>;
GRANT SELECT ON v_$instance TO <username>;
GRANT SELECT ON v_$sql TO <username>;
note

your_host_name と your_strong_password を、ユーザーの値に置き換えてください。

Oracle エージェントの設定

同じディレクトリに config.yaml ファイルを作成します。

# sixthsense-oracle-agent-v2 can be configured via yaml or environment variables
#
# Note: Environment Variables are given higher priority over yaml file
#
# Following are the environment variables that can be set:
# ENV VARIABLE CORRESPONDS TO
# SS_SERVICE_NAME service_name
# SS_AUTHENTICATION authentication
# SS_BACKEND sixthsense_backend
# SS_LOGGING logging
# SS_SECURE secure
sixthsense:
service_name: <name of the service>
# Login to Sixthsense UI --> Go to Settings on Side Navbar --> Copy Access Token
authentication: <authentication token from dashboard>
# debug|error|info
logging: <level> (level supported: debug ,error ,info)
sixthsense_backend: <Name of the Collector>
# For GCP: grpc-collector-observability.sixthsense.rakuten.com:443
# (One Cloud) For connectivity to backend using intra public network: 133.237.176.44:80
# (One Cloud) For connectivity to backend using onecloud private network: 100.99.116.221:80
# SSL connection with backend true|false
secure: true
# (For One Cloud) secure: false
# MY | ES | MS | CB | OR
type: <Database Type>(Select MY for MySql)
# cron: "* * * * *"(optional)
hostname: <Hostname of the database>
port: <Port number of the database>
user: <Database User>
password: <Password for the database user>
sid: <ServiceId of oracle db>
queryLimit: <query limit>
queryThresholdTime: <query threshold limit>

エージェントの実行

Linuxの場合:

./meter-agent config.yaml config1.yaml ...

ネットワークに制限がある場合は、プロキシを使用して SixthSense バックエンドに接続が可能です。

HTTPS_PROXY=proxy-server:port./meter-agent path/to/config.yaml

Windowsの場合:

  1. meter-agent.zip ファイルを解凍し、クラスタ情報を含む yaml ファイルの設定を編集します。

  2. 管理者としてコマンドプロンプトを開き、次のコマンドを入力します。

    nssm.exe install “Service_Name”

  3. NSSM サービス インストーラ画面では、[アプリケーション] タブがデフォルトで選択されています。

  4. 次の詳細を入力します。

  • パス：meter-agent.exe のフルパス
  • スタートアップディレクトリ：フォルダパス
  • 引数：yaml フルネーム

  1. [詳細] タブをクリックします。

  2. 次の詳細を入力します。

  • 表示名：サービスの表示名
  • 内容：サービスの内容
  • セットアップの種類：「自動」等のセットアップの種類を選択します。
  1. [ログオン] タブをクリックします。
  2. [ローカルシステムアカウント] ラジオボタンを選択します。
  3. [サービスがデスクトップと対話できるようにする] チェックボックスを選択します。
  4. [サービスのインストール] をクリックします。