Debian 패키지로 Kibana 설치

edit

Debian 패키지로 Kibana 설치

edit

Kibana를 위한 Debian 패키지는 웹사이트에서 다운로드하거나 APT 리포지토리에서 다운로드할 수 있습니다. Debian, Ubuntu 등 어떤 Debian 기반 시스템에서도 Kibana를 설치하는 데 사용할 수 있습니다.

Kibana의 최신 안정 버전은 Kibana 다운로드 페이지에서 구할 수 있습니다. 다른 버전은 이전 릴리스 페이지에서 구할 수 있습니다.

Elastic PGP 키 가져오기

edit

모든 패키지는 Elastic Signing Key(PGP 키 D88E42B4, https://pgp.mit.edu에서 사용 가능)와 핑거프린트로 서명됩니다.

4609 5ACC 8548 582C 1A26 99A9 D27D 666C D88E 42B4

공개 서명 키를 다운로드하고 설치합니다.

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

APT 리포지토리에서 설치

edit

계속하기 전에 Debian에 apt-transport-https 패키지를 설치해야 할 수도 있습니다.

sudo apt-get install apt-transport-https

리포지토리 정의를 +/etc/apt/sources.list.d/elastic-5.x.list+에 저장합니다.

echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list

add-apt-repository`는 사용하지 마십시오. 이는 `deb-src 항목도 추가하는데 소스 패키지가 제공되지 않습니다. deb-src 항목을 추가하면 다음과 같은 오류가 표시됩니다.

릴리스 파일에서 예상된 항목 'main/source/Sources'를 찾을 수 없음
(잘못된 sources.list 항목 또는 잘못된 형식의 파일)

/etc/apt/sources.list 파일에서 deb-src 항목을 삭제하면 설치가 정상적으로 진행됩니다.

다음 방법으로 Kibana Debian 패키지를 설치할 수 있습니다.

sudo apt-get update && sudo apt-get install kibana

동일한 Kibana 리포지토리에 대해 2개의 항목이 있을 경우 apt-get update 과정에서 다음과 같은 오류가 표시됩니다.

sources.list 항목 중복 https://artifacts.elastic.co/packages/5.x/apt/ ...`

+/etc/apt/sources.list.d/kibana-5.x.list+에 중복되는 항목이 있는지 조사하거나 /etc/apt/sources.list.d/`의 파일 및 `/etc/apt/sources.list 파일에서 중복되는 항목을 찾으십시오.

Debian 패키지 다운로드 및 수동 설치

edit

Kibana v5.4.0 Debian 패키지는 다음과 같이 웹 사이트에서 다운로드하고 설치할 수 있습니다.

64비트:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.4.0-amd64.deb
sha1sum kibana-5.4.0-amd64.deb 
sudo dpkg -i kibana-5.4.0-amd64.deb

sha1sum 또는 `shasum`으로 생성된 SHA를 published SHA와 비교합니다.

32비트:

wget https://artifacts.elastic.co/downloads/kibana/kibana-5.4.0-i386.deb
sha1sum kibana-5.4.0-i386.deb 
sudo dpkg -i kibana-5.4.0-i386.deb

sha1sum 또는 `shasum`으로 생성된 SHA를 published SHA와 비교합니다.

SysV init`와 `systemd

edit

Kibana는 설치 후 자동으로 시작하지 않습니다. Kibana를 시작하고 중지하는 방법은 시스템에서 SysV init 또는 systemd(최신 배포판에서 사용)를 사용하느냐에 따라 달라집니다. 다음 명령을 실행하여 어느 쪽이 사용되는지 확인할 수 있습니다.

ps -p 1

SysV `init`로 Kibana 실행

edit

시스템이 부팅될 때 Kibana가 자동으로 시작하도록 구성하려면 update-rc.d 명령을 사용합니다.

sudo update-rc.d kibana defaults 95 10

Kibana는 service 명령을 사용하여 시작하고 중지할 수 있습니다.

sudo -i service kibana start
sudo -i service kibana stop

어떤 이유로든 Kibana가 시작하지 못하면 실패 이유가 STDOUT에 출력됩니다. 로그 파일은 `/var/log/kibana/`에서 찾을 수 있습니다.

`systemd`로 Kibana 실행

edit

시스템이 부팅될 때 Kibana가 자동으로 시작하도록 구성하려면 다음 명령을 실행합니다.

sudo /bin/systemctl daemon-reload
sudo /bin/systemctl enable kibana.service

Kibana는 다음과 같이 시작하고 중지할 수 있습니다.

sudo systemctl start kibana.service
sudo systemctl stop kibana.service

이 명령은 Kibana가 성공적으로 시작되었는지 여부와 관련하여 어떤 피드백도 제공하지 않습니다. 그 대신 이 정보는 `/var/log/kibana/`의 로그 파일에 기록됩니다.

구성 파일을 통해 Kibana 구성

edit

Kibana는 기본적으로 /etc/kibana/kibana.yml 파일로부터 구성을 로드합니다. 이 구성 파일의 형식에 대해서는 설정의 설명을 참조하십시오.

Debian 패키지의 디렉토리 레이아웃

edit

Debian 패키지는 Debian 기반 시스템에 적합한 위치에 구성 파일, 로그, 데이터 디렉토리를 배치합니다.

유형 설명 기본 위치 설정

Kibana 홈 디렉토리, 즉 $KIBANA_HOME

/usr/share/kibana

bin

Kibana 서버를 시작하기 위한 kibana 및 플러그인 설치를 위한 `kibana-plugin`을 포함하는 바이너리 스크립트

/usr/share/kibana/bin

구성

`kibana.yml`을 포함하는 구성 파일

/etc/kibana

데이터

Kibana 및 그 플러그인이 디스크에 기록하는 데이터 파일의 위치

/var/lib/kibana

최적화

트랜스컴파일된 소스 코드. 일부 관리 작업(예: 플러그인 설치)에서는 소스 코드가 즉시 다시 트랜스컴파일됩니다.

/usr/share/kibana/optimize

플러그인

플러그인 파일 위치. 각 플러그인은 하위 디렉토리에 위치합니다.

/usr/share/kibana/plugins