このページは機械翻訳したものです。

Oracle Cloud Agentのトラブルシューティング

Oracle Cloud Agentを使用していると、次の問題が発生することがあります:

  • 「インスタンスの詳細」ページの「Oracle Cloud Agent」タブで、すべてのプラグインのステータスが「無効」になっている。
  • 「コンソール」ダッシュボードの「メトリック」セクションに、インスタンスのCPU、メモリー、ネットワークまたはディスクのメトリックが表示されない。

これらの問題が発生した場合、Oracle Cloud Agentがインストールされていないか、実行されていないか、Oracleサービスと通信できない可能性があります。特定の問題を診断するには、次のトラブルシューティング・ステップに従います。

ヒント

このトピックでは、Oracle Linuxの手順はCentOSイメージにも適用されます。

ステップ1: Oracle Cloud Agentがインストールされていることの確認

次のステップに従って、Oracle Cloud Agentがインスタンスにインストールされていることを確認します。

  1. インスタンスに接続し、オペレーティング・システムに応じて次のいずれかのコマンドを実行します。
  2. コマンドの実行後にOracle Cloud Agentがインストールされていることを示すメッセージが表示されない場合は、Oracle Cloud Agentをインストールします。Oracle Cloud Agentがインストールされている場合は、次のステップに進み、実行されていることを確認します。

ステップ2: Oracle Cloud Agentが実行されていることの確認

Oracle Cloud Agentがインストールされていることを確認した後、次のステップに従って、実行されていることを確認します。

  1. インスタンスに接続し、次のいずれかのコマンドを使用して、Oracle Cloud Agentを再起動します。
  2. コマンドの実行後にOracle Cloud Agentが実行されていることを示すメッセージが表示されない場合は、診断ツールを実行し、プラグインのデバッグ情報およびログを含むファイルを使用してサポート・チケットを提出します。Oracle Cloud Agentが実行されている場合は、次のステップに進み、Oracleサービスに接続できることを確認します。

ステップ3: Oracle Cloud AgentがOracleサービスに接続できることの確認

Oracle Cloud Agentがインストールされ実行されているが、「インスタンスの詳細」ページのすべてのプラグインのステータスが「無効」であることを確認した場合、または「コンソール」ダッシュボードの「メトリック」セクションにメトリックが表示されない場合、Oracle Cloud AgentがOracleサービスに接続できない可能性があります。次の各項では、Oracle Cloud AgentがOracleサービスに接続できない場合に考えられる原因について説明します。問題を診断するには、次のステップを順番に実行します。

  1. インスタンスがインスタンス・メタデータ・サービス・エンドポイントにアクセスできることを確認します。
  2. クロック・スキュー・エラーを確認します。
  3. ゲートウェイが正しく構成されていることを確認します。
  4. プロキシ・サーバー設定を変更します。

インスタンスがインスタンス・メタデータ・サービス・エンドポイントにアクセスできることの確認

次のステップでは、インスタンスがインスタンス・メタデータ・サービス・エンドポイントにアクセスできるかどうかを確認します。

  1. インスタンスに接続し、オペレーティング・システムに応じて次のいずれかのコマンドを実行します。
  2. プロキシ・エラーなしで正常なレスポンスが得られた場合は、クロック・スキュー・エラーを確認します。プロキシ・サーバー・エラーが発生した場合は、プロキシ・サーバー設定を確認します。

クロック・スキュー・エラーの確認

インスタンスのクロックがNTPサービスと同期していない場合があります。クロック・スキューによってTLSネゴシエーションが失敗し、インスタンスがOracleサービスに接続できなくなる可能性があります。次のステップに従って、クロック・スキュー・エラーを確認します。

  1. インスタンスに接続し、次のいずれかのコマンドを実行して、monitoring.logファイルを生成します。

    クロック・スキュー・エラーがあると、次のようなメッセージが表示されます:

    failed to call: Service error:NotAuthenticated. Date 'Tue, 09 Mar 2021 06:39:35 UTC' is not within allowed clock skew.
    Current 'Tue, 09 Mar 2021 06:45:45 UTC', valid datetime range: ['Tue, 09 Mar 2021 06:40:45 UTC', 'Tue, 09 Mar 2021 06:50:46 UTC'].
    http status code: 401. Opc request id: <unique_id>
  2. クロック・スキュー・エラーが発生している場合は、インスタンスのOracle Cloud Infrastructure NTPサービスを構成します。クロック・スキュー・エラーが発生していない場合は、ゲートウェイが正しく構成されていることを確認します
  3. 前のステップでNTPサービスを構成した場合は、構成の完了後に、次のいずれかのコマンドを実行して、Oracle Cloud Agentを再起動します:
  4. monitoring.logファイルを再度生成します。

    Oracle Cloud Agentが正しく実行されている場合、正常なレスポンスは200 OKです。monitoring.logで、次のようなメッセージを探します:

    2021/03/18 03:12:44.391381 t2.go:139: Sent metrics status: 200; took: 387ms; with opc-request-id:<unique_ID>;
    2021/03/18 03:13:44.006391 instancemetadata_client.go:64: fetched metadata from http://169.254.169.254/opc/v2/instance/ , status 200 OK
    2021/03/18 03:13:44.730102 t2.go:139: Sent metrics status: 200; took: 723ms; with opc-request-id:<unique_ID>;
    2021/03/18 03:14:44.324046 t2.go:139: Sent metrics status: 200; took: 320ms; with opc-request-id:<unique_ID>;

Windowsドメイン参加インスタンスの権限の確認

ドメインに参加しているWindowsインスタンスがある場合は、ローカル・グループ・ポリシーで、仮想アカウントに「サービスとしてログオン」ユーザー権限が付与されていることを確認します。権限を設定するには、Microsoftのサービス・ログオンの有効化のガイドのローカル・グループ・ポリシーを使用してサービス・ログオンを有効化するためのステップに従います。「サービスとしてログオン」で、ユーザーNT SERVICE\ALL SERVICESまたは特定のユーザーを追加します。

ゲートウェイが正しく構成されていることの確認

Oracle Cloud AgentがOracleサービスと通信するには、サブネット内のゲートウェイが正しく構成されている必要があります。次のステップに従って、構成を確認および修正します。

  1. VCNのサブネットのインターネット・ゲートウェイ、NATゲートウェイまたはサービス・ゲートウェイを構成します
  2. 構成ステップを実行した後、インスタンスがインスタンス・メタデータ・サービス・エンドポイントにアクセスできることの確認の項のコマンドを使用して、サービスを再起動します。サービスを再起動したら、monitoring.logファイルでOracleサービスへの正常なリクエストを確認します。

プロキシ・サーバー設定の変更

ローカル・プロキシ・サーバーが原因で、Oracle Cloud Agentがサービスと通信できなくなる場合があります。プロキシ・サーバーはそれぞれ異なります。

多くの場合、プロキシ・クライアント・インスタンスでoracle-cloud-agentおよびoracle-cloud-agent-updaterサービスのhttp_proxyhttps_proxyおよびno_proxy環境変数を設定すると、プロキシの問題が解決されます。これらの環境変数を設定した後、プロキシ・サーバーのaccess.logファイル(またはご使用のシステムに応じて同等のもの)で、プロキシ・クライアントからOracle Cloud Agentがアクセスするサービスへのリクエストが表示されることを確認します。

ステップ4: Oracle Cloud Agentの診断ファイルの生成

OracleサポートがOracle Cloud Agentソフトウェアの問題のトラブルシューティングを簡単に行えるようにするために、コンピュート・インスタンスにOracle Cloud Agent診断ツールを実行できます。診断ツールはOracle Cloud Agentが管理するプラグインのデバッグ情報およびログを含むファイルを生成します。

診断ツールは、Oracle Cloud Agentバージョン1.14.0以降でインストールされます。Oracle Cloud Agentを更新するには、「Oracle Cloud Agentソフトウェアの更新」を参照してください。

前述のトラブルシューティング・ステップを完了した後、診断ツールを実行し、プラグインのデバッグ情報およびログを含むファイルを使用してサポート・チケットを提出します。