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 et est le cadre sous-jacent qui permet à GeoAnalytics Server de fournir une analyse sur plusieurs machines et cœurs GeoAnalytics Server. L’opération de contrôle de l’intégrité, 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 en se connectant à votre répertoire d’administrateur ArcGIS Server à l’aide du format d’URL https://gis_geoanalytics_server.domain.com:6443/arcgis/admin. Pour accéder au 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.
• 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

• Vérifiez le nombre de tâches GeoAnalytics Server actuellement en cours d’exécution ou terminées.
• 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 à compter de la version 10.6.1.

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 :

Période	Description
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 : un site GeoAnalytics Server de trois machines exécutant une tâche unique.
  • Chaque machine dispose de 16 Go 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.
  • GeoAnalytics Server est défini pour utiliser 12 Go de mémoire RAM par machine.
  • GeoAnalytics Server est défini pour utiliser 9 cœurs sur toutes les machines.
• Exemple 2 : un site GeoAnalytics Server de trois machines exécutant deux tâches en simultané.
  • Chaque machine dispose de 16 Go 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.
  • GeoAnalytics Server est défini pour utiliser 6 Go de mémoire RAM par machine.
  • GeoAnalytics Server est défini pour utiliser 4 cœurs sur toutes les machines.

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	Exemple 2
{ "machine1.example-esri.com": { "url": "spark://machine1.example-esri.com:7077", "workers": [ { ...worker1... }, { ...worker2... }, { ...worker3... } ], "cores": 9, "coresused": 9, "memory": 36864, "memoryused": 36864, "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" } }	{ "machine1.example-esri.com": { "url": "spark://machine1.example-esri.com:7077", "workers": [ { ...worker1... }, { ...worker2... }, { ...worker3... } ], "cores": 9, "coresused": 8, "memory": 36864, "memoryused": 36864, "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. Par exemple, si vous avez une machine unique avec 16 cœurs, si le paramètre percentageMaxAllowedComputeCores est défini sur 80 pour cent, et si le nombre de cœurs à utiliser est défini sur 2, les valeurs seront floor(16 * .8) = 12.8. 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. Par exemple, si vous avez une machine unique avec 32 Go de RAM, si la valeur percentageMaxAllowedComputeCores est définie sur 50 pour cent, et si la mémoire RAM à utiliser est définie sur 12 Go, les valeurs seront floor(32 * .5) = 16. 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	Exemple 2
{ "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": 12288, "memoryused": 12288, "memoryfree": 0, "state": "ALIVE", "lastheartbeat": 1520469707880 }, { "id": "worker-20180302114111-10.33.10.149-56543", "host": "10.33.10.149", "port": 56543, "cores": 3, "coresused": 3, "coresfree": 0, "memory": 12288, "memoryused": 12288, "memoryfree": 0, "state": "ALIVE", "lastheartbeat": 1520469712961 }, { "id": "worker-20180302113155-10.33.9.165-56540", "host": "10.33.9.165", "port": 56540, "cores": 3, "coresused": 3, "coresfree": 0, "memory": 12288, "memoryused": 12288, "memoryfree": 0, "state": "ALIVE", "lastheartbeat": 1520469712874 } ], ... }, "machine2.example-esri.com": {...}, "machine3.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": 2, "coresfree": 1, "memory": 12288, "memoryused": 12288, "memoryfree": 0, "state": "ALIVE", "lastheartbeat": 1520469707880 }, { "id": "worker-20180302114111-10.33.10.149-56543", "host": "10.33.10.149", "port": 56543, "cores": 3, "coresused": 3, "coresfree": 0, "memory": 12288, "memoryused": 12288, "memoryfree": 0, "state": "ALIVE", "lastheartbeat": 1520469712961 }, { "id": "worker-20180302113155-10.33.9.165-56540", "host": "10.33.9.165", "port": 56540, "cores": 3, "coresused": 3, "coresfree": 0, "memory": 12288, "memoryused": 12288, "memoryfree": 0, "state": "ALIVE", "lastheartbeat": 1520469712874 } ], ... }, "machine2.example-esri.com": {...}, "machine3.example-esri.com": {...} } }
Description
id : un identifiant unique pour le travailleur. host : l’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. L’espace de la memoryfree doit être supérieur ou égal à l’espace défini dans le paramètre de serveur ( Maximum allowed memory per job per machine (GB) (Mémoire maximale autorisée par tâche par machine (Go))) sur chaque machine pour l’exécution des 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.

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	Exemple 2
{ "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": 12288, "submitdate": "Wed Mar 07 16:41:31 PST 2018", "state": "FINISHED", "duration": 21947 } ], "activedrivers": [], "status": "ALIVE" }, "machine2.example-esri.com": {...}, "machine3.example-esri.com": {...} }	{ "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": 4, "user": "agstest", "memoryperslave": 6144, "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. memoryslavepernode : 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	Exemple
{ "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": 12288, "submitdate": "Wed Mar 07 15:16:50 PST 2018", "state": "RUNNING", "duration": 5105025 } ], "completedapps": [...] }, "machine2.example-esri.com": {...}, "machine3.example-esri.com": {...} }	{ "machine1.example-esri.com": { "url": "spark://machine1.example-esri.com:7077", "workers": [...], ..., "activeapps": [ { "starttime": 1520464610794, "id": "app-20180307151650-0007", "name": "ArcGIS GeoAnalytics (j4b986eb5c603426fae7abe8e9d5d7afa)", "cores": 4, "user": "agstest", "memoryperslave": 6144, "submitdate": "Wed Mar 07 15:16:50 PST 2018", "state": "RUNNING", "duration": 5105025 }, { "starttime": 1520469713951, "id": "app-20180307164153-0009", "name": "ArcGIS GeoAnalytics (j739627e916b34533be918fe98b0fcb90)", "cores": 4, "user": "agstest", "memoryperslave": 6144, "submitdate": "Wed Mar 07 16:41:53 PST 2018", "state": "RUNNING", "duration": 1868 } ], "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. memoryslavepernode : 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.