1 一般的な問題のトラブルシューティング

この章では、すべてのサード・パーティ・データベース・プラグインに関連する一般的なトラブルシューティング・シナリオを示します。

この項の内容は次のとおりです。

サードパーティのデータベースのためのプラグイン・ユーザーズ・ガイド

ユーザーズ・ガイドには、Enterprise Managerでの監視のためのターゲット・インスタンスを設定するために必要な前提条件とステップに関する重要な情報が数多く記載されています。ターゲット・インスタンスとプラグインを連動させようとしているときに問題が発生した場合は、プラグインのユーザー・ガイドを参照して、ターゲット・インスタンスとプラグインを連動させるために必要なすべてのステップに従っていることを確認してください。

エージェントのデバッグ

エージェントにトラックバックされるターゲット・インスタンスで問題が発生した場合、2つの最も有用なツールはエージェント・ログおよびエージェント・メトリック・ブラウザです。デフォルトでは、エージェントはINFOレベルでログに記録するため、より詳細な出力を表示するには、ログ・レベルをDEBUGに変更する必要があります。エージェント・メトリック・ブラウザ(これも有効にする必要があります)には、すべてのターゲット・インスタンスとエージェント設定のリアルタイム・ビューが表示されます。

次の項目について説明します。

ログ・レベルの設定

一部の問題の場合は、問題の根源を調べる最適な方法は、エージェント・ログを確認することです。ただし、エージェント・ログには、デフォルトで必要なすべての情報が含まれない可能性があります。問題の特定に必要な詳細レベルを取得するには、DEBUGレベルでロギングを有効にする必要がある場合があります。これを行うには、emd.propertiesファイルを編集する必要があります。

$AGENT_BASE_DIR/agent_inst/sysman/config/emd.properties

次のエントリを探します。

Logger.log.filename=gcagent.log
Logger.log.level=INFO

2番目のエントリを次のように変更します。

Logger.log.level=DEBUG

設定を有効にするには、エージェントを再ロードまたは再起動します。

gcagent.logファイルでDEBUGという単語が含まれる文が追加され始めたら、変更が実行されていることを確認できます。

この設定は未処理の問題を解決するのに適していますが、問題が解決した後で、最大のパフォーマンスを得るためにエージェントのログ・レベルをINFOに戻す必要があります。

メトリック・ブラウザをオンにする

メトリック・ブラウザをオンにするには、前述のようにemd.propertiesファイルを編集します。

$AGENT_BASE_DIR/agent_inst/sysman/config/emd.properties

次の2つのパラメータを追加します。

_enableMetricBrowser=true
_metricBrowserNoLogin=true

設定を有効にするには、エージェントを再ロードまたは再起動します。次に、ブラウザ・ウィンドウを開き、次のURLに移動します。

http://<agent_host>:<agent_port>/emd/browser/main

emd.propertiesファイルのEMD_URLはほとんど同じものであるため、これをURLのモデルとして使用できます。

このブラウザ・インタフェースを使用すると、エージェントが監視しているターゲット・インスタンスにリアルタイム・アクセスを向けることができます。インスタンスをクリックしてから、ターゲット・インスタンス内の任意のメトリックをクリックすると、そのターゲット・インスタンスのエージェントによるそのメトリックのリアルタイム・コレクションが表示されます。メトリックのいずれかに問題がある場合、メトリックのコレクションの結果として発生したエラーがページに表示されるため、このインタフェースに問題の理由が示されます。

エージェント・ホストからの接続性の確認

監視対象のターゲット・インスタンスにエージェントがアクセスできるかどうかを判断するために実行できる、単純なコマンドがいくつかあります。エージェント・ホストでこれらのコマンドを実行します。

ping <target host>
nslookup <target host>
telnet <target host> port (success means port is active and not blocked)

「接続のテスト」ボタンの使用

Enterprise Managerリリース12.1.0.3より前では、手動による検出ページで「接続のテスト」ボタンはサード・パーティ・データベース・プラグインには機能しませんでした。この問題は、12.1.0.3.0リリースの一部として解決されています。バグが原因で「接続のテスト」ボタンが機能していなかったため、Enterprise Managerの以前のバージョンに依存しないようにしてください。

このバグの詳細は、My Oracle SupportのDoc ID 1503064.1を参照してください

https://support.oracle.com/rs?type=doc&id=1503064.1

JDBCドライバの問題

次の問題と解決情報は、JDBCドライバの問題に対応しています。

クラスパスのロードに失敗しました: インスタンス: <JDBC DRIVER>を作成できませんでした

考えられる原因: ターゲット・プロパティのJDBCドライバ名および/または正しくないバージョンのドライバが使用されました。

処置:

  1. ターゲット・プロパティに正しいJDBCドライバ名を指定します。
  2. 正しいバージョンのドライバが適切なディレクトリにあることを確認してください。

オプションではない問合せ記述子プロパティ[PLUGIN_DEPENDENCIES] (PLUGIN_DEPENDENCIES)を解決できません

考えられる原因: jdbcdriverディレクトリが正しく作成されなかったか、ドライバがjdbcdriverディレクトリに配置されていませんでした。

処置

  1. jdbcdriverディレクトリが正しく作成されたことを確認してください。
    • Microsoft SQL Serverの場合、正しいディレクトリは次のとおりです。

      $AGENT_BASE_DIR/plugins/oracle.em.smss.agent.plugin_<version>/dependencies/oracle.em.smss/jdbcdriver
      
    • IBM DB2およびSybase ASEの場合、正しいディレクトリは次のとおりです。

      $AGENT_BASE_DIR/plugins/dependencies/<plugin_id>/jdbcdriver
      
  2. 正しいバージョンのドライバがそのディレクトリにあることを確認してください。