Skip To Content

Contrôle de l’intégrité de GeoAnalytics

L’opération de contrôle de l’intégrité indique l’état des ressources et des tâches de calcul sur la plateforme de calcul GeoAnalytics Server, qui est le cadre sous-jacent permettant à GeoAnalytics Server de fournir une analyse sur plusieurs machines et cœurs GeoAnalytics Server.

L’opération utilisée à des fins de résolution des problèmes et de surveillance est disponible pour l’administrateur du portail ou du serveur et est accessible via une connexion à votre répertoire administrateur ArcGIS Server à l’aide du format d’URL https://gis_geoanalytics_server.domain.com:6443/arcgis/admin. Pour ouvrir le contrôle de l’intégrité, depuis votre site GeoAnalytics Server, cliquez sur System (Système) > Platform Services (Services de la plateforme) > Compute Platform (Plateforme de calcul) > Health (Intégrité).

Utilisez le contrôle de l’intégrité pour faire ce qui suit :

  • Vérifiez et identifiez les machines GeoAnalytics Server utilisées à des fins d’analyse.
  • Vérifiez que la mémoire et les cœurs alloués sont bien utilisés lors de l’exécution de l’analyse (ou d’un outil).
  • Vérifiez le nombre de cœurs ou l’espace de la mémoire disponibles sur les machines GeoAnalytics Server. Cela peut s’avérer utile lorsque vous utilisez les paramètres GeoAnalytics Server.

    En savoir plus sur les paramètres GeoAnalytics Server

  • Recherchez le jobID d’une tâche GeoAnalytics Server pour afficher l’extrémité REST.
  • Résolvez les problèmes et les messages d’erreur.
    Remarque :

    Si vous recevez l’erreur Unable to initialize distributed compute platform service (Impossible d’initialiser le service de la plateforme de calcul distribué), exécutez le contrôle d’intégrité et vérifiez le statut des nœuds des travailleurs. Une fois que vous avez vérifié le statut des nœuds, exécutez les étapes mentionnées à la rubriqueProblèmes GeoAnalytics Server courants et solutions.

Remarque :

Le contrôle de l’intégrité de GeoAnalytics Server est également disponible avec ArcGIS Monitor.

Pour en savoir plusArcGIS Monitor

Le contrôle de l’intégrité de la plateforme de calcul utilise la terminologie de la structure sous-jacente qui distribue l’analyse. Les conditions et les concepts utilisés dans cette documentation sont soulignés dans le tableau ci-après :

TermeDescription

Nœud

Machine serveur.

Travailleur

Machine utilisée pour le calcul. La machine travailleur reçoit les instructions de la machine principale et les exécute. Il peut y avoir une ou plusieurs machines travailleur pour une machine principale.

Principal

Serveur qui supervise les nœuds travailleur. Un serveur peut être à la fois un nœud principal et un nœud travailleur.

Tâche

Une tâche fait référence à l’exécution d’un outil GeoAnalytics Server.

Le contrôle de l’intégrité est composé de clés qui sont soit une valeur unique, soit un éventail de valeurs. Lorsqu’une tâche GeoAnalytics Server a été exécutée ou est terminée, le contrôle de l’intégrité a les clés suivantes pour chaque machine GeoAnalytics Server sur le site :

{
  "<geoanalytics server machine name>":{
  {.. url ..},
  {.. workers ..},
  {.. cores ..},
  {.. coresused ..},
  {.. memory ..},
  {.. memoryused ..},
  {.. activeapps ..},
  {.. completedapps ..},
  {.. activedrivers ..},
  {.. status ..}
}

Lorsqu’il y a plusieurs machines sur un site, il y a plusieurs geoanalytics service machine name keys. Seule la machine de nœud principal contient des informations sur les ressources et sur les tâches. Les machines de nœud principal ne contiennent que des valeurs null et 0. Au sein de chaque objet serveur de niveau supérieur, les clés suivantes contiennent tout un éventail de valeurs : workers, activeapps, completedapps et activedrivers. Les clés de niveau supérieur url, cores, coresused, memory, memoryused et status ont une valeur unique.

Chaque clé est explorée plus en détails à l’aide des exemples suivants :

  • Exemple 1 : site GeoAnalytics Server à une seule machine
    • Chaque machine dispose de 32 Go (32768 Mo) de mémoire RAM et de 8 cœurs.
    • Les propriétés du système sont définies pour utiliser le maximum de 90 pour cent de la mémoire RAM et des cœurs disponibles.
      • L’instance GeoAnalytics Server utilise 29491 Mo de RAM par machine. Ce calcul est effectué à l’aide de l’équation suivante :
         floor(32768 x .90) = 29491 
      • L’instance GeoAnalytics Server utilise 7 cœurs. Ce calcul est effectué à l’aide de l’équation suivante :
        floor(8 cores x 1 machines x .90) = 7 
  • Exemple 2 : site GeoAnalytics Server à trois machines
    • Chaque machine dispose de 16 Go (16384 Mo) de mémoire RAM et de 4 cœurs.
    • Les propriétés du système utilisent le paramètre par défaut indiquant un maximum de 80 pour cent de la mémoire RAM et des cœurs disponibles.
      • L’instance GeoAnalytics Server utilise 13107 Mo de RAM par machine. Ce calcul est effectué à l’aide de l’équation suivante :
         floor(16384 x .80)= 13107
      • L’instance GeoAnalytics Server utilise 9 cœurs sur toutes les machines. Ce calcul est effectué à l’aide de l’équation suivante :
        floor(4 cores x 3 machines x .80) = 9 

Informations et ressources du site

Les clés url, cores, coresused, memory, memoryused et status sont décrites dans cette section. Si vous avez plusieurs machines sur votre site GeoAnalytics Server, il y a plusieurs clés url. Une des clés url sera complétée par les valeurs comme indiqué dans les exemples suivants. Toutes les autres clés url auront des valeurs nulles et aucun travailleur ne sera répertorié. L’URL avec les valeurs renseignées représente le nœud principal ; les autres URL sont les machines qui sont représentées comme des travailleurs et qui ne sont pas le nœud principal. La clé activedrivers reste toujours un ensemble vide.

Exemple 1 : site à une seule machineExemple 2 : site à trois machines

{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [
           {
               ...worker1...
           }
       ],
       "cores": 7,
       "coresused": 7,
       "memory": 29491,
       "memoryused": 29491,
       "activeapps": [ ... ],
       "completedapps": [ ... ],
       "activedrivers": [],
       "status": "ALIVE"
   }
}

{
 "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",       "workers": [           {
               ...worker1...           },           {
               ...worker2...           },           {
               ...worker3...           }
       ],       "cores": 9,       "coresused": 9,       "memory": 13107,       "memoryused": 13107,       "activeapps": [ ... ],       "completedapps": [ ... ],       "activedrivers": [],       "status": "ALIVE"
   },   "machine2.example-esri.com": {
       "url": "spark://machine2.example-esri.com:7077",       "workers": [],       "cores": 0,       "coresused": 0,       "memory": 0,       "memoryused": 0,       "activeapps": [],       "completedapps": [],       "activedrivers": [],       "status": "STANDBY"
   },   "machine3.example-esri.com": {
       "url": "spark://machine3.example-esri.com:7077",       "workers": [],       "cores": 0,       "coresused": 0,       "memory": 0,       "memoryused": 0,       "activeapps": [],       "completedapps": [],       "activedrivers": [],       "status": "STANDBY"
   }
}

Description

  • url : l’URL de la machine GeoAnalytics Server avec le préfixe Spark et le port Spark. Seule une URL peut être répertoriée par machine.
  • cores : le nombre total des cœurs disponibles sur GeoAnalytics Server à travers toutes les machines GeoAnalytics Server du site. Cela représente le total des nœuds disponibles multiplié par le paramètre percentageMaxAllowedComputeCores, défini sur 80 pour cent par défaut.

    En savoir plus sur la définition de percentageMaxAllowedComputeCores.

  • coresused : le nombre total de cœurs actuellement utilisés dans l’analyse GeoAnalytics Server à travers toutes les machines du site GeoAnalytics Server.
  • memory : l’espace total de mémoire (Mo) disponible sur GeoAnalytics Server à travers toutes les machines GeoAnalytics Server du site. Cela représente l’espace de mémoire sur chaque machine multiplié par la valeur percentageMaxAllowedComputeMemoryet le nombre de machines.
  • memoryused : l’espace total de mémoire actuellement utilisée dans l’analyse GeoAnalytics Server à travers toutes les machines du site GeoAnalytics Server.
  • activedrivers : il s’agit toujours d’un ensemble vide.

Opérateurs

La clé workers identifie les machines et les informations du site GeoAnalytics Server.

Exemple 1 : site à une seule machineExemple 2 : site à trois machines
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [
           {
               "id": "worker-20180302114515-10.33.9.162-56544",
               "host": "10.33.9.162",
               "port": 56544,
               "cores": 3,
               "coresused": 3,
               "coresfree": 0,
               "memory": 29491,
               "memoryused": 29491,
               "memoryfree": 0,
               "state": "ALIVE",
               "lastheartbeat": 1520469707880,
               "lastheartbeatString": "2018-03-07T04:41:47,880",
               "hostname": "machine1.example-esri.com"
           }
       ],
    ...
    }
   }
}
{
   "machine1.example-esri.com": {
       "url": "machine1.example-esri.com:7077",       "workers": [           {
               "id": "worker-20180302114515-10.33.9.162-56544",               "host": "10.33.9.162",               "port": 56544,               "cores": 3,               "coresused": 3,               "coresfree": 0,               "memory": 13107,               "memoryused": 13107,               "memoryfree": 0,               "state": "ALIVE",               "lastheartbeat": 1520469707880,               "lastheartbeatString": "2018-03-07T04:41:47,880",               "hostname": "machine1.example-esri.com"
           },           {
               "id": "worker-20180302114111-10.33.10.149-56543",               "host": "10.33.10.149",               "port": 56543,               "cores": 3,               "coresused": 3,               "coresfree": 0,               "memory": 13107,               "memoryused": 13107,               "memoryfree": 0,               "state": "ALIVE",               "lastheartbeat": 1520469712961,               "lastheartbeatString": "2018-03-07T04:41:52,961",               "hostname": "machine2.example-esri.com"
           },           {
               "id": "worker-20180302113155-10.33.9.165-56540",               "host": "10.33.9.165",               "port": 56540,               "cores": 3,               "coresused": 3,               "coresfree": 0,               "memory": 13107,               "memoryused": 13107,               "memoryfree": 0,               "state": "ALIVE",               "lastheartbeat": 1520469712874,               "lastheartbeatString": "2018-03-07T04:41:52,874",               "hostname": "machine3.example-esri.com"
           }
       ],    ...    },       "machine2.example-esri.com": {...},
   "machine3.example-esri.com": {...}
   }
}

Description

  • id : un identifiant unique pour le travailleur.
  • host : adresse hôte de la machine.
  • port : le port sur la machine utilisé pour l’analyse GeoAnalytics Server. Chaque travailleur a son propre port qui lui est assigné. Il est nécessaire que ces ports soient ouverts pour la communication.
  • cores : le nombre de cœurs attribués à l’analyse GeoAnalytics Server sur la machine. Il est défini à l’aide des paramètres GeoAnalytics Server et représente le paramètre percentageMaxAllowedComputeCores.
  • coresused : le nombre de cœurs actuellement utilisés pour l’analyse GeoAnalytics Server. Si des Outils GeoAnalytics sont en cours d’exécution, cette valeur devrait être supérieure à 0.
  • coresfree : le nombre de cœurs actuellement disponibles et pouvant être utilisés immédiatement pour l’analyse GeoAnalytics Server sur cette machine. Si ce nombre est égal au total des cores sur toutes les machines, aucun des Outils GeoAnalytics n’est en cours d’exécution.
  • memory : l’espace de la mémoire (Mo) alloué à l’analyse GeoAnalytics Server sur la machine. Il est défini à l’aide des paramètres GeoAnalytics Server et représente le paramètre percentageMaxAllowedComputeMemory.
  • memoryused : l’espace de la mémoire (Mo) actuellement alloué à l’analyse GeoAnalytics Server par la machine spécifiée.
  • memoryfree : l’espace de la mémoire (Mo) actuellement disponible et pouvant être utilisé immédiatement pour l’analyse GeoAnalytics Server sur cette machine. La quantité de memoryfree doit être supérieure ou égale à la quantité définie dans le paramètre de serveur sur chaque machine pour l’exécution de Outils GeoAnalytics.
  • state : l’état de la machine actuelle. ALIVE est actif, prêt à exécuter une tâche ou exécute actuellement une tâche. STANDBY bascule sur ALIVE lorsqu’une tâche est lancée. DEAD peut avoir une erreur, et GeoAnalytics Server doit être redémarré. UNKNOWN peut avoir une erreur, et GeoAnalytics Server doit être redémarré. Si une machine ne peut pas basculer sur ALIVE ou STANDBY depuis DEAD ou UNKNOWN, contactez le support Esri.
  • lastheartbeat : la dernière fois où la machine actuelle a contacté le nœud principal en millisecondes depuis epoch. Ce calcul est effectué en heure locale de la machine.
  • lastheartbeatString : la dernière fois où la machine actuelle a contacté le nœud principal au format chaîne. Ce calcul est effectué en heure locale de la machine.
  • hostname : nom d’hôte de la machine de traitement.

Applications terminées

La clé completedapps identifie les outils et les informations GeoAnalytics Server terminés. Cela inclut les outils qui ont été exécutés avec succès, et ceux qui ont abouti à un échec. Les informations des applications terminées sont effacées au redémarrage de GeoAnalytics Server.

Exemple 1 : site à une seule machineExemple 2 : site à trois machines
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [...],
       ...,
       "activeapps": [...],
       "completedapps": [
           {
               "starttime": 1520469691617,
               "id": "app-20180307164131-0008",
               "name": "ArcGIS GeoAnalytics (jcb8bda25a3f14dc7835dca0b3267b42c)",
               "cores": 7,
               "user": "agstest",
               "memoryperslave": 29491,
               "submitdate": "Wed Mar 07 16:41:31 PST 2018",
               "state": "FINISHED",
               "duration": 21947
           }
       ],
       "activedrivers": [],
       "status": "ALIVE"
   }
}
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",       "workers": [...],       ...,       "activeapps": [...],       "completedapps": [           {
               "starttime": 1520469691617,               "id": "app-20180307164131-0008",               "name": "ArcGIS GeoAnalytics (jcb8bda25a3f14dc7835dca0b3267b42c)",               "cores": 9,               "user": "agstest",               "memoryperslave": 13107,               "submitdate": "Wed Mar 07 16:41:31 PST 2018",               "state": "FINISHED",               "duration": 21947           }
       ],       "activedrivers": [],       "status": "ALIVE"
   },   "machine2.example-esri.com": {...},   "machine3.example-esri.com": {...}
}

Description

  • starttime : l’heure à laquelle la tâche Outils GeoAnalytics a été exécutée en millisecondes depuis epoch.
  • id : un identifiant unique pour la tâche.
  • name : le nom de la tâche. Il est toujours au format ArcGIS GeoAnalytics (<jobID>). Le jobID est identique au jobID utilisé à l’extrémité REST lors de l’exécution d’une tâche.
  • cores : le nombre total de cœurs utilisés pour analyse sur toutes les machines.
  • user : l’utilisateur qui a exécuté la tâche. Il s’agit de l’utilisateur qui a configuré ArcGIS Server et qui sera toujours le même sur votre site. Il ne s’agit pas du membre du portail qui a exécuté la tâche.
  • memoryperslave : l’espace de la mémoire utilisé sur chaque machine.
  • submitdate : l’heure à laquelle la tâche Outils GeoAnalytics a été exécutée dans un format texte lisible.
  • state : l’état de la machine actuelle. FINISHED signifie que la tâche est terminée. La tâche a peut être été exécutée avec succès ou a généré une erreur.
  • duration : la durée totale de cette tâche en millisecondes.

Applications actives

La clé activeapps identifie les Outils GeoAnalytics actuellement en cours d’exécution et leurs informations. Une fois cette tâche terminée, les informations sont déplacées vers l’objet completedapps.

Exemple 1 : site à une seule machineExemple : site à trois machines
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [...],
       ...,
       "activeapps": [
           {
               "starttime": 1520464610794,
               "id": "app-20180307151650-0007",
               "name": "ArcGIS GeoAnalytics (j4b986eb5c603426fae7abe8e9d5d7afa)",
               "cores": 7,
               "user": "agstest",
               "memoryperslave": 29491,
               "submitdate": "Wed Mar 07 15:16:50 PST 2018",
               "state": "RUNNING",
               "duration": 5105025
           }
       ],
       "completedapps": [...]
   }
}
{
   "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",       "workers": [...],       ...,       "activeapps": [           {
               "starttime": 1520464610794,               "id": "app-20180307151650-0007",               "name": "ArcGIS GeoAnalytics (j4b986eb5c603426fae7abe8e9d5d7afa)",               "cores": 9,               "user": "agstest",               "memoryperslave": 13107,               "submitdate": "Wed Mar 07 15:16:50 PST 2018",               "state": "RUNNING",               "duration": 5105025           }
       ],       "completedapps": [...]   },   "machine2.example-esri.com": {...},   "machine3.example-esri.com": {...}
}

Description

  • starttime : l’heure à laquelle Outils GeoAnalytics a été exécuté en millisecondes depuis epoch.
  • id : un identifiant unique pour la tâche.
  • name : le nom de la tâche. Il est toujours au format ArcGIS GeoAnalytics (<jobID>). La valeur jobID est identique à l’ID de tâche utilisé à l’extrémité REST lors de l’exécution d’une tâche.
  • cores : le nombre total de cœurs utilisés pour analyse sur toutes les machines.
  • user : l’utilisateur qui a exécuté la tâche. Il s’agit de l’utilisateur qui a configuré ArcGIS Server et qui sera toujours le même sur votre site. Il ne s’agit pas du membre du portail qui a exécuté la tâche.
  • memoryperslave : l’espace de la mémoire utilisé sur chaque machine.
  • submitdate : l’heure à laquelle Outils GeoAnalytics a été exécuté dans un format texte lisible.
  • state : l’état de la machine actuelle. RUNNING signifie que la tâche a commencé. WAITING signifie que la tâche attendra une minute pour déterminer s’il y a suffisamment de ressources. S’il n’y a pas suffisamment de ressources estimées sous une minute, la tâche est annulée. S’il y a les ressources requises, elle est RUNNING.
  • duration : la durée actuelle de la tâche en millisecondes.