agrozyme/kibana

Kibana 镜像文档

镜像概述

Kibana是Elasticsearch官方提供的开源数据可视化与分析平台，旨在为Elasticsearch中索引的各类数据（包括结构化和非结构化数据）提供直观的可视化展示、实时分析及交互式探索能力，是Elastic Stack（ELK Stack）的核心组件之一。

核心功能与特性

• 数据可视化：支持多种图表类型（折线图、柱状图、饼图、热力图等）及自定义仪表盘，直观展示数据趋势与关联。
• 搜索与分析：提供强大的全文搜索功能，支持复杂查询语句，可对Elasticsearch中的数据进行实时分析。
• 日志分析：针对日志数据提供专门的分析工具，支持日志过滤、聚合及异常检测，助力问题排查与监控。
• 安全与监控：集成安全功能（如角色权限控制），并可监控Elasticsearch集群状态、性能指标及数据流量。
• 可扩展性：支持通过插件扩展功能，满足特定业务场景需求（如机器学习、APM等）。

使用场景与适用范围

• 日志集中分析：用于收集、存储并可视化应用系统、服务器的日志数据，实现故障排查与系统监控。
• 业务指标监控：实时展示关键业务指标（如用户访问量、订单量、转化率等），支持业务决策。
• 安全事件分析：分析安全日志、入侵检测数据，识别潜在安全威胁与异常行为。
• 数据探索与研究：对海量结构化/非结构化数据进行交互式探索，发现数据规律与价值。

目录结构

• 主目录：/usr/share/kibana
• 默认配置目录：/etc/kibana（包含kibana.yml等配置文件）
• 默认数据目录：/var/lib/kibana（存储Kibana运行时数据）
• 默认日志目录：/var/log/kibana（存储Kibana日志文件）

使用方法与配置说明

基本运行命令

通过Docker快速启动Kibana容器（需先运行Elasticsearch）：

bash
docker run -d \
  --name kibana \
  -p 5601:5601 \
  -e ELASTICSEARCH_HOSTS=http://elasticsearch:9200 \
  docker.elastic.co/kibana/kibana:8.11.3

参数说明：

• -p 5601:5601：映射Kibana默认端口（5601）到宿主机。
• -e ELASTICSEARCH_HOSTS：指定Elasticsearch服务地址（需与Elasticsearch容器网络互通）。

环境变量配置

常用环境变量：

• ELASTICSEARCH_HOSTS：Elasticsearch服务地址（默认：[***]
• KIBANA_PORT：Kibana监听端口（默认：5601）。
• LOG_LEVEL：日志级别（可选：debug、info、warn、error，默认：info）。
• SERVER_NAME：Kibana服务名称（默认：kibana）。

数据持久化

为避免容器重启后配置与数据丢失，可挂载目录：

bash
docker run -d \
  --name kibana \
  -p 5601:5601 \
  -e ELASTICSEARCH_HOSTS=http://elasticsearch:9200 \
  -v /path/to/kibana/config:/etc/kibana \
  -v /path/to/kibana/data:/var/lib/kibana \
  -v /path/to/kibana/logs:/var/log/kibana \
  docker.elastic.co/kibana/kibana:8.11.3

Docker Compose示例

与Elasticsearch联动部署的docker-compose.yml：

yaml
version: '3'
services:
  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:8.11.3
    container_name: elasticsearch
    environment:
      - discovery.type=single-node
      - ES_JAVA_OPTS=-Xms512m -Xmx512m
    ports:
      - "9200:9200"
    volumes:
      - esdata:/usr/share/elasticsearch/data
    networks:
      - elk-network

  kibana:
    image: docker.elastic.co/kibana/kibana:8.11.3
    container_name: kibana
    environment:
      - ELASTICSEARCH_HOSTS=http://elasticsearch:9200
    ports:
      - "5601:5601"
    depends_on:
      - elasticsearch
    volumes:
      - kibana-config:/etc/kibana
      - kibana-data:/var/lib/kibana
      - kibana-logs:/var/log/kibana
    networks:
      - elk-network

networks:
  elk-network:
    driver: bridge

volumes:
  esdata:
  kibana-config:
  kibana-data:
  kibana-logs:

启动命令：docker-compose up -d

检查Kibana是否运行正常：访问http://localhost:5601