Kibana 업그레이드

Kibana를 업그레이드하면 Kibana를 기본 인터페이스로 사용하는 Observability 및 Elastic Security 솔루션도 함께 업그레이드됩니다.

Kibana는 항상 Elasticsearch를 업그레이드한 후 동일한 버전으로 업그레이드해야 합니다. 버전이 일치하지 않거나 잘못된 순서로 업그레이드하면 장애 또는 예기치 않은 동작이 발생할 수 있습니다.

동일한 Elasticsearch 클러스터에 연결된 여러 Kibana 인스턴스를 업그레이드할 때는 업그레이드를 시작하기 전에 오래된 인스턴스를 모두 종료해야 합니다.

Kibana에서는 롤링 업그레이드가 지원되지 않습니다. 그러나 오래된 인스턴스를 종료한 후에는 업그레이드된 모든 인스턴스를 병렬로 시작할 수 있으므로 모든 인스턴스가 업그레이드에 동시에 참여할 수 있습니다.

Kibana 인스턴스가 10개를 초과하고 저장된 객체가 10,000개를 초과하는 대규모 배포에서는 Kibana 인스턴스 하나를 시작하고 해당 인스턴스가 업그레이드를 완료할 때까지 기다린 후 나머지 인스턴스를 시작하여 업그레이드 중단 시간을 줄일 수 있습니다.

시작하기 전에 업그레이드 계획 지침을 따르고, 업그레이드 준비 단계를 완료했으며, Elasticsearch 클러스터를 업그레이드했는지 확인하세요.

Elasticsearch 클러스터에 문제가 있으면 Kibana 업그레이드가 성공하지 못할 수 있습니다.

업그레이드 과정에서 Kibana는 업데이트된 문서를 기록할 새 인덱스를 생성합니다. 클러스터가 낮은 워터마크에 가까워지면 Kibana가 이러한 인덱스를 생성하지 못할 위험이 큽니다. 업데이트된 문서를 읽고 변환하고 쓰는 작업에는 많은 메모리가 필요할 수 있으며, 일상적인 운영 때보다 더 많은 가용 힙을 사용할 수 있습니다. 요청 시간이 초과되거나 회로 차단기 예외로 오류가 발생하지 않도록 충분한 힙을 확보해야 합니다. 또한 모든 샤드가 복제되고 할당되었는지 확인해야 합니다.

정상적인 클러스터의 조건은 다음과 같습니다.

• 충분한 디스크 여유 공간(.kibana 및 .kibana_task_manager 인덱스가 차지하는 저장 공간의 최소 두 배)
• 충분한 힙 크기
• "green" 클러스터 상태

서로 다른 Kibana 버전을 업그레이드하면 업그레이드가 실패할 수 있습니다. 모든 Kibana 인스턴스가 동일한 버전, 구성 및 플러그인으로 실행되고 있는지 확인하세요.

Kibana를 업그레이드하려면 다음 단계를 따르세요.

1. 모든 Kibana 인스턴스를 종료합니다. Kibana는 롤링 업그레이드를 지원하지 않습니다. 이전 Kibana 인스턴스가 실행 중인 상태에서 업그레이드하면 데이터 손실 또는 업그레이드 실패가 발생할 수 있습니다.

2. deb 또는 rpm 패키지를 설치하려면 다음 단계를 따르세요.

   1. rpm 또는 dpkg를 사용합니다. 그러면 모든 파일이 적절한 위치에 설치되며 구성 파일을 덮어쓰지 않습니다.
   2. 기존 플러그인을 제거한 다음 kibana-plugin 스크립트를 사용하여 적절한 버전을 다시 설치해 모든 플러그인을 업그레이드합니다. 자세한 내용은 Kibana 플러그인을 참조하세요.

3. zip 또는 tar.gz 아카이브에서 설치하려면 다음 단계를 따르세요.

   1. 아카이브를 새 디렉터리에 추출하여 config 또는 data 디렉터리를 덮어쓰지 않도록 합니다.
   2. 이전 설치의 config 디렉터리에 있는 파일을 새 설치로 복사합니다.
   3. 이전 설치의 data 디렉터리에 있는 파일을 새 설치로 복사합니다.
   중요

   모니터링 기능을 사용하는 경우 Kibana를 업그레이드할 때 데이터 디렉터리를 재사용해야 합니다. 그렇지 않으면 Kibana 인스턴스에 새로운 영구 UUID가 할당되고 모니터링 데이터에서 새 인스턴스로 표시됩니다.

   4. kibana-plugin 스크립트를 사용하여 새 설치에 맞는 모든 플러그인 버전을 설치합니다. 자세한 내용은 Kibana 플러그인을 참조하세요.

4. Kibana를 시작합니다.

Kibana 업그레이드를 성공적으로 완료한 후 Elastic APM을 업그레이드하고, 이어서 수집 구성 요소를 업그레이드하세요.