Risoluzione dei problemi dell'agente Oracle Cloud

Verificare che l'istanza possa accedere all'endpoint del servizio di metadati dell'istanza

Questi passi verificano se l'istanza può accedere all'endpoint del servizio metadati dell'istanza.

1. Connettersi all'istanza ed eseguire uno dei comandi seguenti, a seconda del sistema operativo in uso.
   Oracle Linux e Ubuntu

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

   Se l'agente Oracle Cloud è in esecuzione, viene visualizzato un messaggio simile al seguente:

   * 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

   Eseguire il comando in Windows PowerShell come amministratore.

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

   Se l'agente Oracle Cloud è in esecuzione, viene visualizzato un messaggio simile al seguente:

   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. Se si ottiene una risposta riuscita senza errori proxy, verificare la presenza di errori di deviazione dell'orologio. Se si verificano errori del server proxy, verificare le impostazioni del server proxy.

Controlla errori di deviazione orario

A volte, l'orologio di un'istanza non è sincronizzato con il servizio NTP. La deviazione dell'orologio può causare l'errore delle negoziazioni TLS, impedendo all'istanza di connettersi ai servizi Oracle. Segui questi passaggi per controllare gli errori di clock skew.

1. Connettersi all'istanza ed eseguire uno dei comandi riportati di seguito per generare il file monitoring.log.

   Linux

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

   Windows Server 2019, Windows Server 2022, Windows Server 2025

   Eseguire il comando in Windows PowerShell come amministratore.

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

   Windows Server prima del 2019

   Eseguire il comando in Windows PowerShell come amministratore.

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

   Se si verifica un errore di skew dell'orologio, viene visualizzato un messaggio simile al seguente:

   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. Se si verifica un errore di skew del clock, configurare il servizio Oracle Cloud Infrastructure NTP per la tua istanza. Se non si verifica alcun errore di clock, verificare che i gateway siano configurati correttamente.
3. Se il servizio NTP è stato configurato nel passo precedente, dopo aver completato la configurazione, eseguire uno dei comandi seguenti per riavviare Oracle Cloud Agent:
   Oracle Linux 7.x e versioni successive

   sudo systemctl restart oracle-cloud-agent

   Ubuntu

   sudo snap restart oracle-cloud-agent

   Windows Server

   Eseguire il comando in Windows PowerShell come amministratore.

   net stop OCA
   net start OCA

4. Generare di nuovo il file monitoring.log.

   Se Oracle Cloud Agent è in esecuzione correttamente, una risposta riuscita è 200 OK. In monitoring.log, cercare un messaggio simile al seguente:

   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>;

Verificare le autorizzazioni per le istanze con join del dominio Windows

Se si dispone di un'istanza di Windows unita a un dominio, verificare che all'account virtuale sia concesso l'utente Accedi come servizio direttamente nel Criteri di gruppo locale. Per impostare le autorizzazioni, attenersi alla procedura per abilitare l'accesso al servizio tramite un criterio di gruppo locale nella guida Abilita accesso al servizio di Microsoft. Per Log on as a SERVICE, aggiungere l'utente NT SERVICE\ALL SERVICES o l'utente specifico.

Verificare che i gateway siano configurati correttamente

Per consentire all'agente Oracle Cloud di comunicare con i servizi Oracle, è necessario che i gateway nelle subnet siano configurati in modo corretto. Seguire questa procedura per verificare e correggere la configurazione.

1. Configurare il gateway Internet, il gateway NAT o il gateway di servizi per la subnet nella VCN.
2. Dopo aver eseguito i passi di configurazione, riavviare i servizi utilizzando i comandi della sezione Verificare che l'istanza possa accedere all'endpoint del servizio di metadati dell'istanza. Dopo aver riavviato i servizi, controllare il file monitoring.log per le richieste riuscite ai servizi Oracle.

Modifica impostazioni server proxy

A volte, i server proxy locali impediscono all'agente Oracle Cloud di comunicare con qualsiasi servizio. Ogni server proxy è diverso.

Spesso, l'impostazione delle variabili di ambiente http_proxy, https_proxy e no_proxy per i servizi oracle-cloud-agent e oracle-cloud-agent-updater nelle istanze del client proxy risolve i problemi del proxy. Dopo aver impostato queste variabili di ambiente, nel file access.log del server proxy (o equivalente, a seconda del sistema in uso), verificare che vengano visualizzate le richieste del client proxy ai servizi a cui Oracle Cloud Agent accede.