OpenSearch 대시보드 문제 해결

대시보드가 표시되고OpenSearch Dashboards server is not ready yet(HTTP 503 준비되지 않음 오류) 로드가 완료되지 않습니다. 대시보드는 시작이 완료되지 않은 경우이 페이지를 표시합니다. 짧은 버전은 재시작, 업그레이드 또는 블루/그린 배포 중에 정상이며 자체적으로 지워집니다. 문제가 지속되면 문제로 취급합니다. 원인을 좁히려면 도메인의 클러스터 상태와 구성 변경 또는 업그레이드가 진행 중인지 확인합니다.

Dashboards는 모든 코어 서비스 초기화가 완료될 때까지 "서버가 아직 준비되지 않음"을 보고합니다. 따라서 시작 및 블루/그린 배포 중에 메시지의 임시 버전이 예상됩니다. 그린 클러스터와 함께 지속되면 가장 일반적인 원인은 OpenSearch Dashboards 인덱스의 마이그레이션이 차단되기 때문입니다. 시작 시 Dashboards는 저장된 객체를 별칭 뒤의 새 인덱스로 마이그레이션하고, 마이그레이션을 완료할 수 없는 경우 Dashboards는 준비 상태가 되지 않기 때문입니다. 차단된 마이그레이션에 대한 일반적인 트리거:

도메인을 현재 서비스 소프트웨어 버전에 유지하고 각 업그레이드 전에 스냅샷을 생성합니다. 프로덕션 모니터링을 위해 대시보드를 사용하는 경우 단일 도메인의 도메인별 OpenSearch Dashboards 인덱스 마이그레이션과 연결Amazon OpenSearch Service에서 OpenSearch UI 사용되지 않은 중앙 집중식를 고려하세요.

대시보드가 로드되지 않고 다음과 유사한 메시지가 표시됩니다.

Kibana must be able to specify the index within Elasticsearch multi-requests (rest.action.multi.allow_explicit_index=true).

rest.action.multi.allow_explicit_index 고급 클러스터 옵션은 로 설정됩니다false. Dashboards가 대량, mget 및 msearch 작업을 수행할 수 true 있도록이 옵션을 로 설정합니다.

도메인의 고급 옵션true에서 로 rest.action.multi.allow_explicit_index 다시 설정합니다. 이는 콘솔(도메인 열기, 고급 클러스터 설정 편집 및 업데이트) 또는 AWS 명령줄 인터페이스(AWS CLI)에서 자체 AWS 자격 증명을 사용하여 수행하는 관리 영역 변경 사항입니다.

aws opensearch update-domain-config \
  --domain-name my-domain \
  --advanced-options rest.action.multi.allow_explicit_index=true

고급 옵션을 변경하면 블루/그린 배포가 트리거되므로 변경 사항을 적용하는 데 몇 분 정도 걸립니다. 고급 클러스터 설정에 대한 자세한 내용은 섹션을 참조하세요고급 클러스터 설정.

리소스 기반 정책을 통해 인덱스 액세스를 제한하려는 false 경우가 아니면를 rest.action.multi.allow_explicit_index로 설정하지 마십시오. 기본값(true)으로 두면 대시보드가 계속 작동합니다.

특히 큰 대시보드를 열거나 저장된 객체를 많이 로드할 때 대시보드가 다시 시작되거나 충돌하거나 로드 시 응답하지 않습니다.

대시보드 프로세스는 저장된 객체를 너무 많이 로드하거나 대시보드를 많이 렌더링하여 사용 가능한 메모리를 소진했습니다.

대시보드의 메모리가 부족해지기 전에 이를 파악하려면 OpenSearchDashboardsHeapUtilization CloudWatch 지표를 확인하세요. CloudWatch 지표가 지속적으로 80%를 초과하면 더 큰 인스턴스 유형으로 확장합니다. 대시보드 사용량에 맞게 인스턴스 유형을 적절하게 조정하고, 대시보드를 린 상태로 유지하고, 필요한 것 savedObjects:listingLimit 이상으로 늘리지 마세요.

요청 페이로드가 대시보드 페이로드 제한(server.maxPayloadBytes기본값은 1MB/1,048,576바이트)을 초과하기 때문에 특정 대시보드 페이지가 로드되지 않습니다.

매우 많은 수의 인덱스 또는 필드와 일치하는 인덱스 패턴은 페이로드 제한보다 큰 요청을 생성합니다.

요청이 페이로드 한도 내에 유지되도록 인덱스 패턴의 범위를 실제로 사용하는 인덱스 및 필드로 유지합니다.

대시보드는 대부분의 엔진 버전 업그레이드 블루/그린 배포 기간 동안 사용할 수 없습니다. 이는 장애가 아닌 예상되는 동작이며 업그레이드가 완료되면 자체적으로 해결됩니다.

대시보드는 이전 환경과 새 환경 간의 버전 확인 레이스 조건을 방지하기 위해 대부분의 버전 업그레이드 동안 오프라인 상태로 유지됩니다.

업그레이드가 완료될 때까지 기다립니다. 대시보드를 자동으로 다시 사용할 수 있게 됩니다. 버전 업그레이드를 계획된 대시보드 유지 관리 기간으로 취급하고 업무상 중요한 시간 외에 예약합니다. 구성 변경에 대한 자세한 내용은 섹션을 참조하세요Amazon OpenSearch Service에서 구성 변경.

트래픽이 적은 기간 동안 업그레이드를 예약합니다. 단일 도메인의 업그레이드 기간에 연결되지 않은 대시보드 가용성이 필요한 경우 중앙 집중식를 고려하세요Amazon OpenSearch Service에서 OpenSearch UI 사용.

엔진 버전 업그레이드를 시작(또는 업그레이드 자격 검사 실행)하면 업그레이드가 시작되기 전에 업그레이드 전 검사에서 실패합니다. 검증 알림은 하나 이상의 호환되지 않는 인덱스를 나열하며, 특히 OpenSearch Dashboards 인덱스의 이름을 지정할 수 있습니다. 이는 일반적으로 도메인에 OpenSearch 대시보드 인덱스를 포함하여 OpenSearch 1.3, Elasticsearch 7.10 이하에서 생성된 인덱스가 있는 상태에서 OpenSearch 3.x로 업그레이드할 때 발생합니다. (OpenSearch 1.3 또는 2.x에서 업그레이드하려면 먼저 OpenSearch 2.19로 이동한 다음 OpenSearch 3.x로 이동해야 합니다.)

OpenSearch는 바로 앞의 메이저 버전에서만 인덱스를 읽을 수 있으므로 OpenSearch 3.x는 OpenSearch 1.3, Elasticsearch 7.10 또는 이전 버전에서 생성된 인덱스를 지원하지 않습니다. 업그레이드 전 검사는 업그레이드를 차단하고 의도적으로 이러한 인덱스를 나열하므로 데이터가 손실되지 않습니다. 메이저 버전 업그레이드 전에 이전 인덱스를 다시 인덱싱하거나 제거해야 합니다. 서비스는 자동으로 인덱스를 다시 인덱싱하지 않습니다. OpenSearch Dashboards 인덱스는 동일한 규칙을 따릅니다.

두 개 이상의 메이저 버전에 걸쳐 있지 않도록 이전 인덱스를 다시 인덱싱하거나 사용 중지합니다. 여러 업그레이드에 남아 있는 인덱스는 결국 하나를 차단합니다. 업그레이드하기 전에 수동 스냅샷을 만들고 OpenSearch Dashboards에 저장된 객체를 주기적으로 백업으로 내보냅니다.

단일 사용자 또는 브라우저에는 빈 페이지, 빈 보고서 또는 라는 빨간색 배너가 표시되는 반면OpenSearch Dashboards did not load properly. Check the server output for more information., 다른 사용자는 영향을 받지 않습니다. 프라이빗(incognito) 창 또는 다른 브라우저에서 복제하여 확인합니다.

오래된 브라우저 캐시는 특히 서비스 소프트웨어 업데이트 후 또는 보고 기능을 사용할 때이 문제를 일으킵니다.

서비스 소프트웨어 업데이트 후 브라우저 캐시를 지우고 지원되는 up-to-date 브라우저를 사용합니다.