GeoAnalytics 상태 확인

상태 확인 작업은 GeoAnalytics Server 계산 플랫폼(GeoAnalytics Server가 여러 GeoAnalytics Server 코어와 머신에 분석을 배포할 수 있는 기본 프레임워크) 내의 계산 리소스와 작업의 상태를 나타냅니다.

문제 해결 및 모니터링에 사용할 수 있는 이 작업은 서버 또는 포털 관리자에게 제공되며 URL 형식(https://gis_geoanalytics_server.domain.com:6443/arcgis/admin)을 사용하여 ArcGIS Server 관리자 디렉터리에 로그인하여 접근할 수 있습니다. 상태 확인을 열려면 GeoAnalytics Server 사이트에서 시스템 > 플랫폼 서비스 > 계산 플랫폼 > 상태를 클릭합니다.

상태 확인 작업을 사용하여 다음을 수행할 수 있습니다.

• 분석에 사용되는 GeoAnalytics Server 머신을 확인하고 식별합니다.
• 분석을 실행할 때(또는 도구를 실행할 때) 할당된 메모리와 코어가 사용되는지 확인합니다.
• GeoAnalytics Server 머신의 사용 가능한 코어 또는 메모리의 양을 확인합니다. 이는 GeoAnalytics Server 설정을 사용할 때 유용합니다.

  GeoAnalytics Server 설정에 대한 자세한 정보

• GeoAnalytics Server 작업의 jobID를 찾아 REST 엔드포인트를 확인합니다.
• 문제를 해결하고 오류 메시지를 해결합니다.

  비고:

  분산 계산 플랫폼 서비스를 초기화할 수 없습니다.라는 오류 메시지가 표시된 경우 상태 확인 작업을 완료하여 작업자 노드의 상태를 확인합니다. 노드 상태를 확인한 후 일반적인 GeoAnalytics Server 문제와 해결 방법에 나와 있는 단계를 완료합니다.

비고:

GeoAnalytics Server 상태 확인은 ArcGIS Monitor를 통해서도 제공됩니다.

ArcGIS Monitor에 대한 자세한 정보

계산 플랫폼 상태 확인에는 분석이 분산된 기본 프레임워크의 용어가 사용됩니다. 이 설명서 전반에 사용된 용어와 개념이 다음 테이블에 요약되어 있습니다.

기간	설명
노드	서버 머신입니다.
작업자	계산에 사용되는 머신입니다. 작업자 머신은 마스터 머신의 지침을 받아 실행합니다. 한 마스터 머신에 대해 하나 이상의 작업자 머신이 있을 수 있습니다.
마스터	작업자 노드를 감독하는 서버입니다. 서버는 마스터 노드나 작업자 노드일 수 있습니다.
작업(J)	작업은 GeoAnalytics Server 도구 실행을 나타냅니다.

상태 확인은 단일 값 또는 배열 키로 구성됩니다. GeoAnalytics Server 작업이 실행되어 완료되면 사이트의 각 GeoAnalytics Server 머신에 대한 다음 키가 상태 확인에 포함됩니다.

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

사이트에 머신이 2개 이상 있는 경우 여러 개의 geoanalytics service machine name keys가 있습니다. 마스터 노드 머신만 리소스 및 작업 정보를 포함하며 작업자 노드 머신은 null 및 0 값만 포함합니다. 각 최상위 서버 객체 내에서 workers, activeapps, completedapps, activedrivers 키는 값 배열을 포함합니다. 최상위 키의 url, cores, coresused, memory, memoryused, status는 단일 값을 포함합니다.

다음 예시를 통해 각 키에 대해 자세히 알아봅니다.

• 예시 1: 단일 머신 GeoAnalytics Server 사이트입니다.
  • 각 머신은 32GB(32768MB)의 RAM과 8개의 CPU 코어가 있습니다.
  • 시스템 등록정보는 사용 가능한 RAM 및 코어의 최대 90%를 사용하도록 설정되었습니다.
    • GeoAnalytics Server는 머신당 29491MB의 RAM을 사용합니다. 이 값은 다음 방정식을 통해 계산되었습니다.

       floor(32768 x .90) = 29491 

    • GeoAnalytics Server는 7개의 코어를 사용합니다. 이 값은 다음 방정식을 통해 계산되었습니다.

      floor(8 cores x 1 machines x .90) = 7 

• 예시 2: 3개 머신 GeoAnalytics Server 사이트입니다.
  • 각 머신은 16GB(16384MB)의 RAM과 4개의 CPU 코어가 있습니다.
  • 시스템 등록정보는 사용 가능한 RAM 및 코어의 최대 80%(기본값)를 사용하도록 설정되었습니다.
    • GeoAnalytics Server는 머신당 13107MB의 RAM을 사용합니다. 이 값은 다음 방정식을 통해 계산되었습니다.

       floor(16384 x .80)= 13107

    • GeoAnalytics Server는 모든 머신에 걸쳐 9개의 코어를 사용합니다. 이 값은 다음 방정식을 통해 계산되었습니다.

      floor(4 cores x 3 machines x .80) = 9 

사이트 정보와 리소스

이 섹션에는 url, cores, coresused, memory, memoryused, status 키에 대해 설명되어 있습니다. GeoAnalytics Server 사이트에 머신이 2개 이상 있는 경우 여러 개의 url 키가 있습니다. url 키 중 하나는 다음 예시와 같이 값으로 채워지며, 나머지 모든 url 키에는 0 값이 지정됩니다. 작업자는 나열되지 않습니다. 채워진 값이 있는 URL이 마스터 노드이며 나머지 URL은 작업자를 나타내는 머신으로 마스터 노드가 아닙니다. activedrivers 키는 항상 빈 배열입니다.

예시 1 - 단일 머신 사이트

예시 2 - 3개 머신 사이트

{ "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" } }

설명

• url - Spark 접두어와 Spark 포트가 포함된 GeoAnalytics Server 머신의 URL입니다. 머신당 하나의 URL만 나열할 수 있습니다.
• cores - 사이트 내의 모든 GeoAnalytics Server 머신에 걸쳐 GeoAnalytics Server에 제공되는 총 코어 수입니다. 이는 사용 가능한 총 코어 수와 percentageMaxAllowedComputeCores 설정(기본 설정에 따라 80%)을 곱한 값입니다.

  percentageMaxAllowedComputeCores 설정에 대해 자세히 알아봅니다.

• coresused - GeoAnalytics Server 사이트 내의 모든 머신에 걸쳐 현재 GeoAnalytics Server 분석에 사용되고 있는 총 코어 수입니다.
• memory - 사이트 내의 모든 GeoAnalytics Server 머신에 걸쳐 GeoAnalytics Server에 제공되는 총 메모리 양(MB)입니다. 이는 각 머신의 메모리 양을 percentageMaxAllowedComputeMemory와 곱한 다음 머신 수를 곱한 값입니다.
• memoryused - GeoAnalytics Server 사이트 내의 모든 머신에 걸쳐 현재 GeoAnalytics Server 분석에 사용되고 있는 총 메모리 양입니다.
• activedrivers - 항상 빈 배열입니다.

작업자

workers 키는 머신과 정보를 GeoAnalytics Server 사이트의 일부로 식별합니다.

예시 1 - 단일 머신 사이트

예시 2 - 3개 머신 사이트

{ "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": {...} } }

설명

• id - 작업자의 고유 ID입니다.
• host - 머신의 호스트 주소입니다.
• port - GeoAnalytics Server 분석에 사용되는 머신의 포트입니다. 각 작업자는 고유 포트가 할당됩니다. 해당 포트는 통신을 위해 열려 있어야 합니다.
• cores - 머신의 GeoAnalytics Server 분석에 할당된 코어 수입니다. 이 값은 GeoAnalytics Server 설정을 통해 지정되며 percentageMaxAllowedComputeCores 설정을 나타냅니다.
• coresused - 현재 GeoAnalytics Server 분석에 사용되는 코어 수입니다. 실행 중인 GeoAnalytics 도구가 있는 경우 이 값은 0보다 커야 합니다.
• coresfree - 현재 사용 가능한 코어 수로, 해당 머신의 GeoAnalytics Server 분석에 바로 사용할 수 있습니다. 이 개수가 모든 머신의 cores와 같은 경우에는 현재 실행 중인 GeoAnalytics 도구가 없습니다.
• memory - 머신의 GeoAnalytics Server 분석에 할당된 메모리 양(MB)입니다. 이 값은 GeoAnalytics Server 설정을 통해 지정되며 percentageMaxAllowedComputeMemory 설정을 나타냅니다.
• memoryused - 지정된 머신의 현재 GeoAnalytics Server 분석에 사용되는 메모리 양(MB)입니다.
• memoryfree - 현재 사용 가능한 메모리 양(MB)으로, 해당 머신의 GeoAnalytics Server 분석에 바로 사용할 수 있습니다. GeoAnalytics 도구 실행을 위해 이 memoryfree 값은 각 머신의 서버 설정에 설정된 메모리 양보다 크거나 같아야 합니다.
• state - 현재 머신의 상태입니다. ALIVE가 켜진 경우 작업을 실행할 준비가 되었거나 실행 중인 작업이 있는 것입니다. 작업이 시작되면 STANDBY가 ALIVE로 전환됩니다. DEAD의 경우 오류가 발생하여 GeoAnalytics Server를 다시 시작해야 할 수 있습니다. UNKNOWN의 경우에도 오류가 발생하여 GeoAnalytics Server를 다시 시작해야 할 수 있습니다. 머신 상태를 DEAD 또는 UNKNOWN에서 ALIVE 또는 STANDBY로 전환할 수 없는 경우 Esri 지원에 문의하세요.
• lastheartbeat - 현재 머신이 마스터 노드에 마지막으로 연결된 시간(에포크부터 밀리초 단위)입니다. 이 값은 머신의 로컬 시간으로 계산됩니다.
• lastheartbeatString - 현재 머신이 마스터 노드에 마지막으로 연결된 시간(문자열 형식)입니다. 이 값은 머신의 로컬 시간으로 계산됩니다.
• hostname - 작업자 머신의 호스트 이름입니다.

완료된 앱

completedapps 키는 완료된 GeoAnalytics Server 도구와 정보를 식별합니다. 이는 성공적으로 완료된 도구와 오류가 발생한 도구를 포함합니다. 완료된 앱 정보는 GeoAnalytics Server가 다시 시작될 때 지워집니다.

예시 1 - 단일 머신 사이트

예시 2 - 3개 머신 사이트

{ "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": {...} }

설명

• starttime - GeoAnalytics 도구 작업 실행이 시작된 시간(에포크부터 밀리초 단위)입니다.
• id - 작업의 고유 ID입니다.
• name - 작업 이름입니다. 이름은 항상 ArcGIS GeoAnalytics (<jobID>) 형식입니다. jobID는 작업을 실행할 때 REST 엔드포인트에 사용된 동일한 jobID입니다.
• cores - 모든 머신에 걸쳐 분석에 사용된 총 코어 수입니다.
• user - 작업을 실행한 사용자입니다. 이 사용자는 ArcGIS Server를 설정한 사용자로 사이트에서 항상 동일합니다. 작업을 실행한 포털 구성원이 아닙니다.
• memoryperslave - 각 머신에 사용된 메모리 양입니다.
• submitdate - GeoAnalytics 도구 작업 실행이 시작된 시간(읽을 수 있는 텍스트 형식)입니다.
• state - 현재 작업의 상태입니다. FINISHED는 작업이 완료되었음을 나타냅니다. 작업은 성공적으로 완료되었거나 오류가 발생했을 수 있습니다.
• duration - 총 작업 기간(밀리초 단위)입니다.

활성 앱

activeapps 키는 현재 실행 중인 GeoAnalytics 도구와 해당 정보를 식별합니다. 작업이 완료되면 정보가 completedapps 객체로 이동됩니다.

예시 1 - 단일 머신 사이트

예시 - 3개 머신 사이트

{ "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": {...} }

설명

• starttime - GeoAnalytics 도구 실행이 시작된 시간(에포크부터 밀리초 단위)입니다.
• id - 작업의 고유 ID입니다.
• name - 작업 이름입니다. 이름은 항상 ArcGIS GeoAnalytics (<jobID>) 형식입니다. jobID는 작업을 실행할 때 REST 엔드포인트에 사용된 동일한 작업 ID입니다.
• cores - 모든 머신에 걸쳐 분석에 사용된 총 코어 수입니다.
• user - 작업을 실행한 사용자입니다. 이 사용자는 ArcGIS Server를 설정한 사용자로 사이트에서 항상 동일합니다. 작업을 실행한 포털 구성원이 아닙니다.
• memoryperslave - 각 머신에 사용된 메모리 양입니다.
• submitdate - GeoAnalytics 도구 실행이 시작된 시간(읽을 수 있는 텍스트 형식)입니다.
• state - 현재 작업의 상태입니다. RUNNING은 작업이 시작되었음을 나타내며 WAITING은 리소스가 충분한지 확인하기 위해 작업이 1분간 대기됨을 나타냅니다. 1분 내 리소스가 부족한 것으로 확인되면 작업이 취소됩니다. 리소스가 있으면 RUNNING이 시작됩니다.
• duration - 현재 작업 기간(밀리초 단위)입니다.