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

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

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

1. インスタンスに接続し、オペレーティング・システムに応じて次のいずれかのコマンドを実行します。
   Oracle LinuxおよびUbuntu

   curl -v -H 'Authorization: Bearer Oracle' http://169.254.169.254/opc/v2/instance/

   Oracle Cloud Agentが実行されている場合、次のようなメッセージが表示されます:

   * About to connect() to 169.254.169.254 port 80 (#0)
   *   Trying 169.254.169.254...
   * Connected to 169.254.169.254 (169.254.169.254) port 80 (#0)
   > GET /opc/v2/instance/ HTTP/1.1
   > User-Agent: curl/7.29.0
   > Host: 169.254.169.254
   > Accept: */*
   > Authorization: Bearer Oracle
   >
   < HTTP/1.1 200 OK
   < Server: server
   < Date: Wed, 24 Mar 2021 20:52:38 GMT
   < Content-Type: application/json
   < Content-Length: 1800
   < Last-Modified: Wed, 03 Mar 2021 01:43:50 GMT
   < Connection: keep-alive
   < ETag: "603ee9d6-708"
   < Accept-Ranges: bytes
   <
   {
     "availabilityDomain" : "uybn:<availability_domain>",
     "faultDomain" : "<fault_domain>",
     "compartmentId" : "ocid1.compartment.oc1..<unique_ID>",
     "displayName" : "<instance_name>",
     "hostname" : "<host_name>",
     "id" : "<unique_ID>",
     "image" : "ocid1.image.oc1.iad.<unique_ID>",
     "metadata" : {
       "ssh_authorized_keys" : ""
     },
     "region" : "<region_key>",
     "canonicalRegionName" : "<region_name>",
     "ociAdName" : "<availability_domain>",
     "regionInfo" : {
       "realmKey" : "<realm>",
       "realmDomainComponent" : "oraclecloud.com",
       "regionKey" : "<region_key>",
       "regionIdentifier" : "<region>"
     },
     "shape" : "<shape>",
     "state" : "Running",
     "timeCreated" : 1614637343723,
     "agentConfig" : {
       "monitoringDisabled" : false,
       "managementDisabled" : false,
       "allPluginsDisabled" : false,
       "pluginsConfig" : [ {
         "name" : "OS Management Service Agent",
         "desiredState" : "ENABLED"
       }, {
         "name" : "Custom Logs Monitoring",
         "desiredState" : "ENABLED"
       }, {
         "name" : "Compute Instance Run Command",
         "desiredState" : "ENABLED"
       }, {
         "name" : "Compute Instance Monitoring",
         "desiredState" : "ENABLED"
       } ]
     },
     "freeformTags" : {
       "keep" : "keep"
     }
   * Connection #0 to host 169.254.169.254 left intact
   

   Windows Server

   Windows PowerShellで、管理者としてコマンドを実行します。

   Invoke-WebRequest -Headers @{'Authorization'='Bearer Oracle'} http://169.254.169.254/opc/v2/instance/
   

   Oracle Cloud Agentが実行されている場合、次のようなメッセージが表示されます:

   StatusCode        : 200
   StatusDescription : OK
   Content           : {
                         "availabilityDomain" : "<availability_domain>",
                         "faultDomain" : "<fault_domain>",
                         "compartmentId" :
                       "ocid1.tenancy.region1..<unique_ID>",
                         "displayNam...
   RawContent        : HTTP/1.1 200 OK
                       Connection: keep-alive
                       Accept-Ranges: bytes
                       Content-Length: 1197
                       Content-Type: application/json
                       Date: Wed, 24 Mar 2021 21:07:42 GMT
                       ETag: "<unique_ID>"
                       Last-Modified: Wed, 24 M...
   Forms             : {}
   Headers           : {[Connection, keep-alive], [Accept-Ranges, bytes], [Content-Length, 1197], [Content-Type,
                       application/json]...}
   Images            : {}
   InputFields       : {}
   Links             : {}
   ParsedHtml        : mshtml.HTMLDocumentClass
   RawContentLength  : 1197
   

2. プロキシ・エラーなしで正常なレスポンスが得られた場合は、クロック・スキュー・エラーを確認します。プロキシ・サーバー・エラーが発生した場合は、プロキシ・サーバー設定を確認します。

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

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

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

   Linux

   sudo tail -15 /var/log/oracle-cloud-agent/plugins/gomon/monitoring.log

   Windows Server 2019、Windows Server 2022

   Windows PowerShellで、管理者としてコマンドを実行します。

   Get-Content -tail 15 C:\Windows\ServiceProfiles\OCA\AppData\Local\OracleCloudAgent\plugins\gomon\monitoring.log

   2019より前のWindows Server

   Windows PowerShellで、管理者としてコマンドを実行します。

   Get-Content -tail 15 C:\Users\OCA\AppData\Local\OracleCloudAgent\plugins\gomon\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を再起動します:
   Oracle Linux 6.x

   sudo initctl restart oracle-cloud-agent

   Oracle Linux 7.x以降のバージョン

   sudo systemctl restart oracle-cloud-agent

   Ubuntu

   sudo snap restart oracle-cloud-agent

   Windows Server

   Windows PowerShellで、管理者としてコマンドを実行します。

   net stop OCA
   net start OCA

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