Dépannage d'Oracle Cloud Agent

Vérifier que l'instance peut accéder au point d'extrémité du service de métadonnées d'instance

Ces étapes vérifient si l'instance peut accéder au point d'extrémité du service de métadonnées d'instance.

1. Connectez-vous à l'instance et exécutez l'une des commandes suivantes en fonction du système d'exploitation.
   Oracle Linux et Ubuntu

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

   Si Oracle Cloud Agent est en cours d'exécution, un message similaire à celui qui suit s'affiche :

   * 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

   Exécutez la commande de Windows PowerShell en tant qu'administrateur.

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

   Si Oracle Cloud Agent est en cours d'exécution, un message similaire à celui qui suit s'affiche :

   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. Si vous obtenez un message de réussite sans erreur de mandataire, vérifiez s'il y a des erreurs liées à la variation d'horloge. Si des erreurs de serveur mandataire se produisent, vérifiez les paramètres du serveur mandataire.

Rechercher les erreurs de variation d'horloge

Parfois, l'horologe sur une instance n'est pas synchronisée avec le service NTP. Une variation d'horloge peut entraîner l'échec des négociations TLS, empêchant l'instance de se connecter aux services Oracle. Suivez les étapes ci-dessous pour rechercher les erreurs de variation d'horloge.

1. Connectez-vous à l'instance et exécutez une des commandes suivantes pour générer le fichier monitoring.log.

   Linux

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

   Windows Server 2019, Windows Server 2022

   Exécutez la commande de Windows PowerShell en tant qu'administrateur.

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

   Windows Server antérieur à 2019

   Exécutez la commande de Windows PowerShell en tant qu'administrateur.

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

   Si une erreur de variation d'horloge se produit, un message similaire à celui qui suit s'affiche :

   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. Si une erreur de variation d'horloge se produit, configurez le service NTP pour Oracle Cloud Infrastructure pour l'instance. Si aucune erreur ne se produit, vérifiez que les passerelles sont configurées correctement.
3. Si vous avez configuré le service NTP à l'étape précédente, une fois la configuration terminée, exécutez l'une des commandes suivantes pour redémarrer Oracle Cloud Agent :
   Oracle Linux 7.x et versions ultérieures

   sudo systemctl restart oracle-cloud-agent

   Ubuntu

   sudo snap restart oracle-cloud-agent

   Windows Server

   Exécutez la commande de Windows PowerShell en tant qu'administrateur.

   net stop OCA
   net start OCA

4. Générez de nouveau le fichier monitoring.log.

   Si Oracle Cloud Agent fonctionne correctement, une réponse de réussite est 200 OK. Dans monitoring.log, recherchez un message similaire à ce qui suit :

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

Vérifier les autorisations pour les instances jointes à un domaine Windows

Si une instance Windows est jointe à un domaine, vérifiez que le compte virtuel est doté du droit d'utilisateur Ouvrir une session en tant que Service dans la politique de groupe locale. Pour définir les autorisations, suivez les étapes d'activation de la connexion au service au moyen d'une politique de groupe locale dans le guide Activer l'ouverture de session du service de Microsoft. Pour Se connecter en tant que service, ajoutez l'utilisateur NT SERVICE\ALL SERVICES ou l'utilisateur spécifique.

Vérifier que les passerelles sont configurées correctement

Pour qu'Oracle Cloud Agent communique avec les services Oracle, les passerelles des sous-réseaux doivent être configurées correctement. Suivez ces étapes pour vérifier et corriger la configuration.

1. Configurez la passerelle Internet, la passerelle NAT ou la passerelle de service pour le sous-réseau du VCN.
2. Après avoir suivi les étapes de configuration, redémarrez les services à l'aide des commandes de la section Vérifier que l'instance peut accéder au point d'extrémité du service de métadonnées d'instance. Après avoir redémarré les services, vérifiez les demandes réussies pour les services Oracle dans le fichier monitoring.log.

Modifier les paramètres du serveur mandataire

Parfois, les serveurs mandataires locaux empêchent Oracle Cloud Agent de communiquer avec les services. Chaque serveur mandataire est différent.

Souvent, la définition des variables d'environnement http_proxy, https_proxy et no_proxy pour les services oracle-cloud-agent et oracle-cloud-agent-updater sur les instances clients mandataires résout les problèmes de manadataire. Une fois que vous avez défini ces variables d'environnement, dans le fichier access.log (ou fichier équivalent) du serveur mandataire (selon votre système), vérifiez que vous voyez les demandes provenant du client mandataire pour les services auxquels Oracle Cloud Agent accède.