Skip To Content

GeoAnalytics-Integritätsprüfung

Die Integritätsprüfung gibt Aufschluss über den Status der Rechenressourcen und Aufträge in der GeoAnalytics Server-Rechenplattform. 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 Operation dient dem Server- oder Portal-Administrator 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. Um die Integritätsprüfung zu öffnen, beginnen Sie auf der GeoAnalytics Server-Site, und 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üfung, ob beim Ausführen der Analyse (oder eines Werkzeugs) der zugewiesene Speicher und die zugewiesenen Kerne verwendet werden
  • Ü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

  • 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 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:

BegriffBeschreibung

Knoten

Ein Servercomputer.

Worker

Ein Rechencomputer. Ein Worker-Computer empfängt Anweisungen vom primären Computer und führt diese aus. Mit einem primären Computer können mehrere Worker-Computer verbunden sein.

Primär

Der Server zur Überwachung der Worker-Knoten. Ein Server kann sowohl primärer Knoten als auch Worker-Knoten sein. In Spark wird dies als "Master" bezeichnet.

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 ..},
  {.. aliveworkers ..},
  {.. cores ..},
  {.. coresused ..},
  {.. memory ..},
  {.. memoryused ..},
  {.. activeapps ..},
  {.. completedapps ..},
  {.. activedrivers ..},
  {.. completeddrivers ..},
  {.. status ..}
}

Befinden sich in einer Site mehrere Computer, gibt es mehrere geoanalytics service machine name keys. Nur der primäre 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 der obersten Ebene url, cores, coresused, memory, memoryused und status weisen einen einzelnen Wert auf.

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

  • Beispiel 1: Eine GeoAnalytics Server-Site-Konfiguration mit einem Computer
    • Die Computer sind mit 32 GB (32768 MB) RAM und 8 CPU-Kernen ausgestattet.
    • Die Systemeigenschaften sind so eingestellt, dass maximal 90 Prozent des verfügbaren RAM und der verfügbaren Kerne verwendet werden.
      • Der GeoAnalytics Server verwendet 29.491 MB RAM pro Computer. Dieser Wert wurde mit der folgenden Gleichung berechnet:
        floor(32.768 x 0,90) = 29.491
      • Der GeoAnalytics Server verwendet 7 Kerne. Dieser Wert wurde mit der folgenden Gleichung berechnet:
        floor(8 Kerne x 1 Computer x 0,90) = 7
  • Beispiel 2: Eine GeoAnalytics Server-Site-Konfiguration mit drei Computern
    • Die Computer sind mit 16 GB (16384 MB) 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.
      • Der GeoAnalytics Server verwendet 13.107 MB RAM pro Computer. Dieser Wert wurde mit der folgenden Gleichung berechnet:
        floor(16.384 x 0,80) = 13.107
      • Der GeoAnalytics Server verwendet computerübergreifend 9 Kerne. Dieser Wert wurde mit der folgenden Gleichung berechnet:
        floor(4 Kerne x 3 Computer x 80) = 9

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 primären Knoten; bei den übrigen URLs handelt es sich um Computer, die als Worker dargestellt werden und die kein primärer Knoten sind. Der Schlüssel activedrivers ist immer ein leeres Array.

Beispiel 1: Site mit einem ComputerBeispiel 2: Site mit drei Computern

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

{
 "machine1.example-esri.com": {
       "url": "spark://machine1.example-esri.com:7077",
       "workers": [
           {
               ...worker1...
           },
           {
               ...worker2...
           },
           {
               ...worker3...
           }
       ],
       "aliveworkers": 3,
       "cores": 9,
       "coresused": 9,
       "memory": 13107,
       "memoryused": 13107,
       "activeapps": [ ... ],
       "completedapps": [ ... ],
       "activedrivers": [],
       "completeddrivers": [],
       "status": "ALIVE"
   },
   "machine2.example-esri.com": {
       "url": "spark://machine2.example-esri.com:7077",
       "workers": [],
       "aliveworkers": 0,
       "cores": 0,
       "coresused": 0,
       "memory": 0,
       "memoryused": 0,
       "activeapps": [],
       "completedapps": [],
       "activedrivers": [],
       "completeddrivers": [],
       "status": "STANDBY"
   },
   "machine3.example-esri.com": {
       "url": "spark://machine3.example-esri.com:7077",
       "workers": [],
       "aliveworkers": 0,
       "cores": 0,
       "coresused": 0,
       "memory": 0,
       "memoryused": 0,
       "activeapps": [],
       "completedapps": [],
       "activedrivers": [],
       "completeddrivers": [],
       "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.

    Weitere Informationen zum Einrichten von percentageMaxAllowedComputeCores.

  • coresused: Gesamtzahl der Kerne, die für GeoAnalytics Server-Analysen derzeit von allen Computern in der GeoAnalytics Server-Site belegt werden.
  • memory: Gesamtspeichermenge (in MB), 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, dem Wert für percentageMaxAllowedComputeMemory und der Computeranzahl.
  • memoryused: Gesamtmenge an Arbeitsspeicher, der für GeoAnalytics Server-Analysen 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: Site mit einem ComputerBeispiel 2: Site mit drei Computern
{
   "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": {...}
   }
}

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 Anzahl 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 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 primären Knoten in Millisekunden von der Unixzeit. Die Berechnung richtet sich nach der Ortszeit des Computers.
  • lastheartbeatString: Zeitpunkt der letzten Verbindung des aktuellen Computers mit dem primären Knoten im Zeichenfolgenformat. Die Berechnung richtet sich nach der Ortszeit des Computers.
  • hostname: Der Hostname des Worker-Computers.

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: Site mit einem ComputerBeispiel 2: Site mit drei Computern
{
   "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": [],
       "completeddrivers": [],
       "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": [],
       "completeddrivers": [],
       "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.
  • memoryperslave: 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 das Objekt completedapps verschoben.

Beispiel 1: Site mit einem ComputerBeispiel 2: Site mit drei Computern
{
   "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": {...}
}

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.
  • memoryperslave: 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.