Hướng dẫn Cài đặt Kibana 6.6.0 và Khắc phục Lỗi Môi trường

Tổng quan về Kibana

Kibana là một nền tảng mã nguồn mở chuyên dùng để phân tích và trực quan hóa dữ liệu, được thiết kế để hoạt động đồng bộ với Elasticsearch. Công cụ này cho phép người dùng tương tác trực tiếp với các chỉ mục (index) lưu trữ trong Elasticsearch, biến dữ liệu thô thành các biểu đồ, bảng biểu hoặc bản đồ dễ hiểu thông qua giao diện web.

Quy trình Triển khai và Khởi chạy

Để sử dụng Kibana, bạn cần đảm bảo môi trường JDK và một cụm Elasticsearch đơn节点 (single-node) đã được cài đặt và vận hành ổn định. Dưới đây là các bước thiết lập Kibana phiên bản 6.6.0 trên hệ điều hành Linux.

1. Chuẩn bị và Giải nén

Truy cập trang chủ của Elastic để tải về gói cài đặt phù hợp. Trong hướng dẫn này, chúng ta sử dụng tệp kibana-6.6.0-linux-x86_64.tar.gz. Giả sử thư mục làm việc chính là /opt/elastic-stack.

# Tạo thư mục chứa ứng dụng
mkdir -p /opt/elastic-stack
cd /opt/elastic-stack

# Giải nén gói cài đặt vào thư mục hiện tại
tar -xzf kibana-6.6.0-linux-x86_64.tar.gz

# Đổi tên thư mục để dễ quản lý
mv kibana-6.6.0-linux-x86_64 kibana-6.6

2. Cấu hình Hệ thống

Tệp cấu hình chính nằm tại $KIBANA_HOME/config/kibana.yml. Bạn cần chỉnh sửa các tham số sau để đảm bảo Kibana có thể kết nối đúng với Elasticsearch và cho phép truy cập từ bên ngoài.

# Cấu hình cổng dịch vụ, mặc định là 5601
server.port: 5601

# Địa chỉ IP mà Kibana sẽ lắng nghe. 
# Để truy cập từ máy khác, không sử dụng localhost mà hãy dùng IP thực tế của server.
# Ví dụ sử dụng IP: 192.168.1.105
server.host: "192.168.1.105"

# Đường dẫn index lưu trữ cấu hình của Kibana trên Elasticsearch
kibana.index: ".kibana"

# Địa chỉ kết nối tới Elasticsearch
elasticsearch.url: "http://192.168.1.105:9200"

3. Khởi động và Dừng Dịch vụ

Di chuyển vào thư mục bin để thực thi lệnh khởi động. Bạn có thể chạy ở chế độ foreground (chiếm dụng terminal) hoặc background (chạy nền).

cd /opt/elastic-stack/kibana-6.6/bin

# Chạy nền để không bị ngắt khi đóng terminal
nohup ./kibana > kibana.log 2>&1 &

# Kiểm tra log để đảm bảo không có lỗi khởi tạo
tail -f kibana.log

Sau khi khởi động thành công, truy cập http://192.168.1.105:5601 trên trình duyệt để xác nhận giao diện đã hiển thị.

Để dừng dịch vụ, tìm tiến trình node đang chạy và终止 nó:

# Tìm PID của tiến trình kibana
ps -ef | grep kibana

# Dừng tiến trình (thay <pid> bằng ID thực tế)
kill -TERM <pid>

Xác thực Hoạt động Cluster

Sử dụng công cụ Dev Tools trong Kibana để gửi các yêu cầu kiểm tra trạng thái cụm Elasticsearch.

Kiểm tra sức khỏe Cluster

Thực thi lệnh GET _cluster/health để nhận thông tin JSON về trạng thái hiện tại.

GET _cluster/health

Kết quả trả về sẽ chứa các trường quan trọng như status, number_of_nodes, và unassigned_shards.

Giải thích trạng thái Status

  • Green: Tất cả các shard chính (primary) và shard phụ (replica) đều đã được phân bổ. Cluster hoạt động hoàn hảo.
  • Yellow: Các shard chính đã sẵn sàng, nhưng thiếu một số shard phụ. Dữ liệu vẫn an toàn và có thể truy vấn, nhưng khả năng dự phòng bị giảm.
  • Red: Một số shard chính không thể phân bổ. Dữ liệu bị thiếu, một số thao tác ghi có thể thất bại. Cần khắc phục ngay lập tức.

Kiểm tra Node và Shard

Để xem danh sách các node trong cụm, sử dụng API sau:

GET _cat/nodes?v

Trường unassigned_shards trong kết quả health check cho biết số lượng shard chưa được gán vào node nào. Trong cụm đơn node, các shard replica thường sẽ ở trạng thái này vì không có node khác để sao chép.

Xử lý Sự cố Thường Gặp

Một lỗi phổ biến khi chạy Kibana trên các phiên bản Linux cũ là thiếu thư viện glibc phù hợp. Dưới đây là cách khắc phục lỗi liên quan đến phiên bản GLIBC_2.14.

1. Mô tả Lỗi

Khi khởi động, console có thể hiển thị thông báo lỗi như sau:

Error: /lib64/libc.so.6: version `GLIBC_2.14' not found

Điều này cho thấy thư viện C chuẩn của hệ thống quá cũ so với yêu cầu của Kibana.

2. Giải pháp Nâng cấp GLIBC

Cần biên dịch và cài đặt phiên bản glibc mới hơn (ví dụ 2.17) từ mã nguồn. Lưu ý thao tác này cần quyền root và có thể ảnh hưởng đến hệ thống nếu làm sai.

# Tải mã nguồn glibc 2.17
wget http://ftp.gnu.org/gnu/glibc/glibc-2.17.tar.gz
tar -xzf glibc-2.17.tar.gz
cd glibc-2.17

# Tạo thư mục build riêng biệt
mkdir build_dir
cd build_dir

# Cấu hình biên dịch
../configure --prefix=/usr --disable-profile --enable-add-ons --with-headers=/usr/include --with-binutils=/usr/bin

# Biên dịch song song để tăng tốc độ (sử dụng 8 luồng)
make -j8

# Cài đặt vào hệ thống
make install

3. Xác minh Phiên bản

Sau khi cài đặt xong, kiểm tra lại phiên bản thư viện để đảm bảo lỗi đã được khắc phục:

# Kiểm tra các phiên bản GLIBC khả dụng
strings /lib64/libc.so.6 | grep GLIBC

# Hoặc sử dụng lệnh ldd
ldd --version

Nếu đầu ra hiển thị phiên bản 2.17 hoặc cao hơn, bạn có thể khởi động lại Kibana mà không gặp phải lỗi thiếu thư viện nữa.

Thẻ: kibana Elasticsearch linux-installation glibc-update data-visualization

Đăng vào ngày 2 tháng 6 lúc 21:51

Thẻ Phổ Biến

©2026 Thành phố Cuồng loạn