Kibana 설치
원본 보기Kibana 설치
Kibana는 모든 Elastic 솔루션의 사용자 인터페이스를 제공합니다. 데이터를 시각화하고 분석하며 Elastic Stack을 관리하고 모니터링하는 데 유용한 강력한 도구입니다. Elasticsearch를 사용하는 데 Kibana가 반드시 필요한 것은 아니지만, 대부분의 사용 사례에서는 필요합니다.
이 섹션에는 Kibana를 설정하고 실행하는 방법에 대한 정보가 포함되어 있으며, 다음 내용을 다룹니다:
- Kibana 다운로드 및 설치
- Kibana를 Elasticsearch 클러스터에 등록
- Kibana 구성
로컬 개발이나 테스트를 위해 Docker에서 Elasticsearch와 Kibana를 빠르게 설정하려면 Elasticsearch 로컬 설치(빠른 시작)로 이동하세요.
Kibana 패키지는 Linux, Darwin, Windows용으로 제공되며 해당 플랫폼에서 테스트됩니다. Kibana는 Node.js에서 실행되므로 이러한 플랫폼에 필요한 Node.js 바이너리가 함께 포함되어 있습니다. 별도로 관리되는 버전의 Node.js에서 Kibana를 실행하는 것은 지원되지 않습니다.
일부 오래된 Linux 플랫폼(특히 CentOS7/RHEL7)을 지원하기 위해, Linux용 Kibana에는 glibc 2.17을 지원하는 맞춤 빌드 Node.js가 포함되어 있습니다. 자세한 내용은 Node.js 맞춤 빌드를 참조하세요.
Kibana는 다음 패키지 형식으로 제공됩니다:
| 형식 | 설명 | 안내 |
|---|---|---|
tar.gz |
tar.gz 패키지는 Linux와 Darwin에 설치할 수 있도록 제공되며, Kibana를 처음 시작하기에 가장 쉬운 선택입니다. |
Linux 또는 macOS에서 아카이브로 설치 |
zip |
zip 패키지는 Windows에서 지원되는 유일한 패키지입니다. |
Windows에 설치 |
deb |
deb 패키지는 Debian, Ubuntu 및 기타 Debian 기반 시스템에 적합합니다. Debian 패키지는 Elastic 웹사이트 또는 Elastic의 Debian 저장소에서 다운로드할 수 있습니다. |
Debian 패키지로 설치 |
rpm |
rpm 패키지는 Red Hat, SLES, OpenSuSE 및 기타 RPM 기반 시스템에 설치하기 적합합니다. RPM은 Elastic 웹사이트 또는 Elastic의 RPM 저장소에서 다운로드할 수 있습니다. |
RPM으로 설치 |
docker |
Kibana를 Docker 컨테이너로 실행할 수 있는 이미지가 제공됩니다. Elastic Docker Registry에서 다운로드할 수 있습니다. | Docker에서 Kibana 실행 |
Elastic Stack을 설치할 때는 스택 전체에서 동일한 버전을 사용해야 합니다. 예를 들어 Elasticsearch 9.5.1을 사용한다면 Beats 9.5.1, APM Server 9.5.1, Elasticsearch Hadoop 9.5.1, Kibana 9.5.1, Logstash 9.5.1을 설치합니다.
기존 설치를 업그레이드하는 경우, 9.5.1과의 호환성을 확보하는 방법은 배포, 클러스터 또는 오케스트레이터 업그레이드를 참조하세요.
Kibana와 Elasticsearch를 서로 다른 메이저 버전으로 실행하는 것(예: Kibana 9.x와 Elasticsearch 8.x)은 지원되지 않으며, Elasticsearch보다 높은 마이너 버전의 Kibana를 실행하는 것(예: Kibana 8.14와 Elasticsearch 8.13)도 지원되지 않습니다.
Kibana보다 높은 마이너 버전의 Elasticsearch를 실행하는 것은 Elasticsearch를 먼저 업그레이드하는 업그레이드 절차를 위해 일반적으로 동작합니다(예: Kibana 8.14와 Elasticsearch 8.15). 이 구성에서는 Kibana 서버 시작 시 경고가 로그에 기록되므로, Kibana를 Elasticsearch와 동일한 버전으로 업그레이드할 때까지의 임시 상태로만 사용해야 합니다.
Kibana와 Elasticsearch를 서로 다른 패치 버전으로 실행하는 것(예: Kibana 9.0.0과 Elasticsearch 9.0.1)은 일반적으로 지원되지만, Kibana와 Elasticsearch를 패치 버전까지 동일하게 맞춰 실행하는 것을 권장합니다.
자체 관리 클러스터에 Elastic Stack을 배포하는 경우, 사용하려는 Elastic Stack 제품을 다음 순서로 설치하세요:
이 순서대로 설치하면 각 제품이 의존하는 구성 요소가 먼저 준비됩니다.
운영 환경을 배포하면서 Elasticsearch에 신뢰할 수 있는 CA 서명 인증서를 사용할 계획이라면, Fleet과 Elastic Agent를 배포하기 전에 먼저 설정해야 합니다. 새 보안 인증서를 구성하면 모든 Elastic Agent를 다시 설치해야 하므로, 적절한 인증서를 갖춘 상태에서 Fleet과 Elastic Agent를 설정할 것을 권장합니다.
이 표는 Elasticsearch 클러스터를 운영하기 위해 접근 가능해야 하는 포트를 보여줍니다. 클러스터를 사용할 수 있으려면 Elasticsearch REST 인터페이스와 Kibana 인터페이스가 외부 사용자에게 열려 있어야 합니다. transport API는 클러스터 내 Elasticsearch 노드 간에, 그리고 transport API를 사용하는 모든 외부 클라이언트에서 접근 가능해야 합니다.
기본적으로 Elasticsearch는 지정된 범위의 첫 번째 포트를 수신하려고 시도합니다. 해당 포트가 사용 중이면 다음 포트를 시도합니다.
이 설정은 해당 구성 파일에서 재정의할 수 있습니다.
| 포트 | 접근 유형 | 용도 | 설정 |
|---|---|---|---|
| 9200 이상 | HTTP (REST) | Elasticsearch용 REST API. Kibana와 Logstash를 포함한 외부 소스에서 클러스터에 접근하는 데 사용되는 기본 인터페이스입니다. | Elasticsearch http.port |
| 9300 이상 | TCP | Transport API. 클러스터 내부 통신과 transport API(Java 클라이언트)를 통한 클라이언트 접근에 사용됩니다. | Elasticsearch transport.port |
| 5601 | HTTP | Kibana 기본 접근 포트. | Kibana server.port |
선택적 Elastic Stack 구성 요소에는 추가 포트가 필요할 수 있습니다. 설치하려는 구성 요소의 설치 가이드를 참조하세요.
전체 의존성 목록은 Elastic Stack 서드파티 의존성을 참조하세요.