GeoAnalytics-Integritätsprüfung

Die Integritätsprüfung gibt Aufschluss über den Status der Rechenressourcen und Aufträge in der GeoAnalytics Server-Plattform. Hierbei handelt es sich um die zugrunde liegende Umgebung, die die Veröffentlichung von Analysen über mehrere GeoAnalytics Server-Kerne und -Computer durch GeoAnalytics Server ermöglicht. Die Integritätsprüfung dient dem Server- oder Portaladministrator zur Fehlerbehebung und Überwachung. Der Zugriff erfolgt durch Anmeldung beim ArcGIS Server-Administratorverzeichnis über das URL-Format https://gis_geoanalytics_server.domain.com:6443/arcgis/admin. Die Navigation zur Integritätsprüfung beginnt in der GeoAnalytics Server-Site. Klicken Sie auf System > Platform Services > Compute Platform > Health.

Die Integritätsprüfung bietet folgende Möglichkeiten:

• Überprüfung und Ermittlung der GeoAnalytics Server-Computer, die für die Analyse verwendet werden.
• Überprüfen, ob der verfügbare Speicher und die verfügbaren Kerne belegt sind.
• Überprüfung der Anzahl der auf den GeoAnalytics Server-Computern verfügbaren Kerne bzw. die Menge an verfügbarem Speicher. Das kann bei Verwendung der GeoAnalytics Server-Einstellungen hilfreich sein.

  Weitere Informationen zu den GeoAnalytics Server-Einstellungen

• Überprüfung der Anzahl der GeoAnalytics Server-Aufträge, die aktuell ausgeführt werden oder bereits abgeschlossenen sind.
• Suchen der jobID eines GeoAnalytics Server-Auftrags, um den REST-Endpunkt anzuzeigen.
• Fehlerbehebung und Lösung von Fehlermeldungen.

  Hinweis:

  Wenn Sie den Fehler Die verteilte Verarbeitungsplattform konnte nicht initialisiert werden erhalten, schließen Sie die Integritätsprüfung ab, und prüfen Sie den Status der Worker-Knoten. Wenn Sie den Status der Knoten überprüft haben, führen Sie die Schritte unter Allgemeine Probleme und Lösungen im Zusammenhang mit GeoAnalytics Server aus.

Hinweis:

Die GeoAnalytics Server-Integritätsprüfung ist auch in ArcGIS Monitor 10.6.1 verfügbar.

Weitere Informationen zu ArcGIS Monitor

In der Integritätsprüfung für die Plattform werden Begriffe aus der zugrunde liegenden Umgebung verwendet, über die die Analyse verteilt wird. Die in dieser Dokumentation verwendeten Begriffe und Konzepte entnehmen Sie der folgenden Tabelle:

Begriff	Beschreibung
Knoten	Ein Servercomputer.
Worker	Ein Rechencomputer. Ein Worker-Computer empfängt Anweisungen vom Master-Computer und führt diese aus. Mit einem Master können mehrere Worker-Computer verbunden sein.
Master	Der Server zur Überwachung der Worker-Knoten. Ein Server kann sowohl Master- als auch Worker-Knoten sein.
Auftrag	Die Ausführung eines GeoAnalytics Server-Werkzeugs.

Die Integritätsprüfung besteht aus Schlüsseln, die sich aus einem einzelnen Wert oder einem Array zusammensetzen. Wenn ein GeoAnalytics Server-Auftrag ausgeführt und abgeschlossen wurde, weist die Integritätsprüfung für die einzelnen GeoAnalytics Server-Computer in der Site die folgenden Schlüssel auf:

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

Befinden sich in einer Site mehrere Computer, gibt es mehrere geoanalytics service machine name keys. Nur der Master-Knoten enthält Informationen zu Ressourcen und Aufträgen. Die Worker-Knoten enthalten lediglich null- und 0-Werte. In jedem Serverobjekt der obersten Ebene enthalten folgende Schlüssel ein Werte-Array: workers, activeapps, completedapps und activedrivers. Die Schlüssel url, cores, coresused, memory, memoryused und status der Schlüssel der obersten Ebene weisen einen einzelnen Wert auf.

Die Schlüssel werden in den folgenden Beispielen eingehender beschrieben.

• Beispiel 1: In einer aus drei Computern bestehenden GeoAnalytics Server-Site wird ein einzelner Auftrag ausgeführt.
  • Die Computer sind mit 16 GB RAM und 4 CPU-Kernen ausgestattet.
  • In den Systemeigenschaften werden standardmäßig maximal 80 Prozent des verfügbaren Arbeitsspeichers und der verfügbaren Kerne verwendet.
  • GeoAnalytics Server ist so konfiguriert, dass je Computer 12 GB RAM verwendet werden.
  • GeoAnalytics Server ist so konfiguriert, dass alle Computer zusammen 9 Kerne verwenden.
• Beispiel 2: In einer aus drei Computern bestehenden GeoAnalytics Server-Site werden zwei Aufträge gleichzeitig ausgeführt.
  • Die Computer sind mit 16 GB RAM und 4 CPU-Kernen ausgestattet.
  • In den Systemeigenschaften werden standardmäßig maximal 80 Prozent des verfügbaren Arbeitsspeichers und der verfügbaren Kerne verwendet.
  • GeoAnalytics Server ist so konfiguriert, dass je Computer 6 GB RAM verwendet werden.
  • GeoAnalytics Server ist so konfiguriert, dass alle Computer zusammen 4 Kerne verwenden.

Site-Informationen und -Ressourcen

In diesem Abschnitt werden die Schlüssel url, cores, coresused, memory, memoryused und status beschrieben. Befinden sich in Ihrer GeoAnalytics Server-Site mehrere Computer, gibt es mehrere url-Schlüssel. Einer der url-Schlüssel wird gemäß den folgenden Beispielen mit Werten gefüllt. Alle anderen url-Schlüssel erhalten den Wert 0, und es werden keine Worker aufgeführt. Die URL mit ausgefüllten Werten entspricht dem Master-Knoten; bei den übrigen URLs handelt es sich um Computer, die als Worker dargestellt werden und die kein Master-Knoten sind. Der Schlüssel activedrivers ist immer ein leeres Array.

Beispiel 1	Beispiel 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" } }
Beschreibung
url – Die URL des GeoAnalytics Server-Computers mit Spark-Präfix und Spark-Port. Je Computer darf nur eine URL aufgeführt werden. cores – Gesamtzahl der Knoten, die dem GeoAnalytics Server auf allen GeoAnalytics Server-Computern in der Site zur Verfügung stehen. Hierbei handelt es sich um das Produkt aus der Gesamtanzahl der verfügbaren Knoten und der Einstellung für percentageMaxAllowedComputeCores, die standardmäßig bei 80 Prozent liegt. Beispiel: Bei einem einzelnen Computer mit 16 Kernen ist percentageMaxAllowedComputeCores auf 80 Prozent und die Anzahl der zu belegenden Kerne auf 2 eingestellt; der Wert beträgt also floor(16 * .8) = 12.8. coresused – Gesamtzahl der Kerne, die gemäß GeoAnalytics Server-Analyse derzeit von allen Computern in der GeoAnalytics Server-Site belegt werden. memory – Gesamtspeichermenge (in GB), die dem GeoAnalytics Server auf allen GeoAnalytics Server-Computern in der Site zur Verfügung steht. Hierbei handelt es sich um das Produkt aus der Speichermenge der einzelnen Computer, der Einstellung für percentageMaxAllowedComputeMemory und der Computeranzahl. Beispiel: Bei einem einzelnen Computer mit 32 GB RAM ist percentageMaxAllowedComputeCores auf 50 Prozent und die Anzahl des zu belegenden Arbeitsspeichers auf 12 GB eingestellt; der Wert beträgt also floor(32 * .5) = 16. memoryused – Gesamtmenge an Arbeitsspeicher, der gemäß GeoAnalytics Server-Analyse derzeit von allen Computern in der GeoAnalytics Server-Site belegt wird. activedrivers – Ist immer ein leeres Array.

Workers

Der Schlüssel workers ermittelt die Computer der GeoAnalytics Server-Site und erfasst die zugehörigen Informationen.

Beispiel 1	Beispiel 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": {...} } }
Beschreibung
id – Eindeutige Kennung für den Worker. host – Hostadresse des Computers. port – Port auf dem für die GeoAnalytics Server-Analyse verwendeten Computer. Jedem Worker ist ein eigener Port zugewiesen. Die Ports müssen für die Kommunikation geöffnet sein. cores – Anzahl der Kerne, die der GeoAnalytics Server-Analyse auf dem Computer zugewiesen sind. Diese Anzahl wird über die GeoAnalytics Server-Einstellungen festgelegt und entspricht der Einstellung für percentageMaxAllowedComputeCores. coresused – Anzahl der Kerne, die aktuell für die GeoAnalytics Server-Analyse verwendet werden. Falls GeoAnalytics Tools ausgeführt werden, sollte der Wert größer sein als 0. coresfree – Anzahl der Kerne, die derzeit nicht belegt sind und somit unmittelbar für die GeoAnalytics Server-Analyse auf diesem Computer verwendet werden können. Wenn dieser Wert der cores-Anzahl auf allen Computern entspricht, werden aktuell keine GeoAnalytics Tools ausgeführt. memory – Speichermenge (in MB), die der GeoAnalytics Server-Analyse auf dem Computer zugewiesen ist. Diese Menge wird über die GeoAnalytics Server-Einstellungen festgelegt und entspricht der Einstellung für percentageMaxAllowedComputeMemory. memoryused – Speichermenge (in MB), die derzeit von der GeoAnalytics Server-Analyse auf dem angegebenen Computer belegt wird. memoryfree – Speichermenge (in MB), die derzeit nicht belegt ist und somit unmittelbar für die GeoAnalytics Server-Analyse auf diesem Computer verwendet werden kann. memoryfree muss größer oder gleich der Menge sein, die in der Servereinstellung (Maximal zulässiger Speicher pro Auftrag pro Computer (GB)) auf den einzelnen Computern festgelegt wurde, damit die GeoAnalytics Tools ausgeführt werden können. state – Status des aktuellen Computers. ALIVE steht für "Eingeschaltet", "Bereit für die Ausführung eines Auftrags" oder "Ausführung eines Auftrags läuft". STANDBY ändert sich in ALIVE, wenn ein Auftrag gestartet wurde. DEAD kann auf einen Fehler hinweisen, sodass ein Neustart von GeoAnalytics Server empfohlen wird. UNKNOWN kann auf einen Fehler hinweisen, sodass ein Neustart von GeoAnalytics Server empfohlen wird. Sollte sich der Status eines Computers nicht von DEAD oder UNKNOWN in ALIVE oder STANDBY ändern, wenden Sie sich an den Support von Esri. lastheartbeat – Zeitpunkt der letzten Verbindung des aktuellen Computers mit dem Master-Knoten in Millisekunden von der Unixzeit.

Abgeschlossene Apps

Der Schlüssel completedapps ermittelt die abgeschlossenen GeoAnalytics Server-Werkzeuge und erfasst die zugehörigen Informationen. Dazu gehören sowohl die erfolgreich als auch die fehlerhaft ausgeführten Werkzeuge. Die Informationen über abgeschlossene Apps werden beim Neustart von GeoAnalytics Server gelöscht.

Beispiel 1	Beispiel 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": {...} }
Beschreibung
starttime – Startzeit des GeoAnalytics Tools-Auftrags in Millisekunden von der Unixzeit. id – Eindeutige Kennung für den Auftrag. name – Name des Auftrags. Dieser weist immer das Format ArcGIS GeoAnalytics (<jobID>) auf. Die jobID entspricht der jobID, die im REST-Endpunkt bei Ausführung eines Auftrags verwendet wird. cores – Gesamtzahl der Kerne, die computerübergreifend für die Analyse belegt werden. user – Benutzer, der den Auftrag ausgeführt hat. Dies ist der Benutzer, der ArcGIS Server eingerichtet hat; er bleibt für Ihre Site jeweils unverändert. Er ist nicht zu verwechseln mit dem Mitglied des Portals, das den Auftrag ausgeführt hat. memoryslavepernode – Auf den einzelnen Computern belegte Speichermenge. submitdate – Startzeit des GeoAnalytics Tools-Auftrags in einem lesbaren Textformat. state – Status des aktuellen Auftrags. FINISHED bedeutet, dass der Auftrag abgeschlossen ist. Der Auftrag kann erfolgreich oder fehlerhaft abgeschlossen werden. duration – Gesamtdauer des Auftrags in Millisekunden.

Aktive Apps

Der Schlüssel activeapps ermittelt die derzeit ausgeführten GeoAnalytics Tools und erfasst die zugehörigen Informationen. Nach Abschluss eines Auftrags werden die Informationen in den Schlüssel completedapps verschoben.

Beispiel 1	Beispiel
{ "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": {...} }
Beschreibung
starttime – Startzeit des GeoAnalytics Tools-Auftrags in Millisekunden von der Unixzeit. id – Eindeutige Kennung für den Auftrag. name – Name des Auftrags. Dieser weist immer das Format ArcGIS GeoAnalytics (<jobID>) auf. Die jobID entspricht der jobID, die im REST-Endpunkt bei Ausführung eines Auftrags verwendet wird. cores – Gesamtzahl der Kerne, die computerübergreifend für die Analyse belegt werden. user – Benutzer, der den Auftrag ausgeführt hat. Dies ist der Benutzer, der ArcGIS Server eingerichtet hat; er bleibt für Ihre Site jeweils unverändert. Sie ist nicht zu verwechseln mit dem Mitglied des Portals, das den Auftrag ausgeführt hat. memoryslavepernode – Auf den einzelnen Computern belegte Speichermenge. submitdate – Startzeit des GeoAnalytics Tools-Auftrags in einem lesbaren Textformat. state – Status des aktuellen Auftrags. RUNNING bedeutet, dass der Auftrag gestartet wurde. WAITING bedeutet, dass ermittelt wird, ob genügend Ressourcen zur Verfügung stehen, und dass der Auftrag dafür für eine Minute angehalten wird. Falls innerhalb dieser Minute nicht genügend Ressourcen frei werden, wird der Auftrag abgebrochen. Wenn genügend Ressourcen zur Verfügung stehen, beginnt die Ausführung (RUNNING). duration – Aktuelle Dauer des Auftrags in Millisekunden.