v2.1

v2.1
v2.0
v1.0
Express
  1. Release Notes
  1. 产品介绍
  1. 安装指南
    1. 安装说明
    1. 在 Linux 快速安装 KubeSphere
    1. 安装可插拔的功能组件
    1. 集群高可用配置安装
    1. 在 Kubernetes 安装 KubeSphere
    1. 相关工具与插件
    1. 认证与安全
    1. 运维指南
  1. 快速入门
  1. 管理员指南
    1. 多租户管理
    1. 平台管理
    1. 基础设施
    1. 监控中心
    1. 平台设置
    1. 工具箱
    1. 通用配置
    1. FAQ
  1. 用户指南
    1. 应用
    1. 工作负载
    1. 存储
    1. 网络与服务
    1. 监控告警
    1. 配置中心
    1. 项目设置
    1. DevOps 工程
  1. 开发者指南
    1. Helm 应用开发
  1. API 文档
  1. 常见问题
  1. 附录
KubeSphere®️ 2019 All Rights Reserved.

KubeSphere 日志系统编辑此页面

KubeSphere 提供了 强大且易用的日志查询、接收与管理功能,比如多租户日志管理、多级别日志查询 (包括项目、工作负载、容器组、容器以及关键字)、灵活方便的日志收集配置选项等。相较于 Kibana,KubeSphere 日志系统提供了 基于多租户的日志查询,不同的租户只能看到属于自己的日志信息。KubeSphere 内置的日志系统作为可插拔的功能组件,主要的功能如下:

安装前如何开启安装日志系统

注意:开启可选功能组件之前,请先参考 可插拔功能组件列表确认集群的可用 CPU 与内存空间是否充足,否则可能会因为资源不足而导致的机器崩溃或其它问题。

安装前,在 installer 目录下编辑 conf/common.yaml 文件,然后参考如下开启。

提示:KubeSphere 支持对接外置的 Elasticsearch,若您已有外置的 ES 集群,建议在以下参数中配置对接,可减少 KubeSphere 集群的资源消耗。

# Logging
logging_enabled: true # 是否安装内置的日志系统
elasticsearch_master_replica: 1  # es 主节点副本数,主节点数不能为偶数
elasticsearch_data_replica: 2  # 数据节点副本数
elasticsearch_volume_size: 20Gi # Elasticsearch 存储卷大小
log_max_age: 7 # 集群内置的 Elasticsearch 中日志保留时间,默认是 7 天
elk_prefix: logstash # 自定义 index 命名方式,index 将以 ks-<elk_prefix>-log 形式命名
kibana_enabled: false # 是否部署内置的 Kibana
logsidecar_injector_enabled: true # 是否安装和增加落盘日志收集器到用户创建的工作负载副本中
#external_es_url: SHOULD_BE_REPLACED # 安装支持对接外部的 Elasticsearch 7.x,可减少资源消耗,此处填写 ES 服务的地址
#external_es_port: SHOULD_BE_REPLACED # 此处填写 ES 服务暴露的端口号

安装后如何开启安装日志系统

通过修改 ks-installer 的 configmap 可以选装组件,执行以下命令。

$ kubectl edit cm -n kubesphere-system ks-installer

参考如下修改 ConfigMap

logging:
     enabled: True
     elasticsearchMasterReplica: 1
     elasticsearchDataReplica: 2
     elasticsearchVolumeSize: 20Gi
     logMaxAge: 7
     elkPrefix: logstash
     containersLogMountedPath: ""
     kibana:
       enabled: False  ## 是否开启安装 Kibana

保存退出,参考 验证可插拔功能组件的安装 ,通过查询 ks-installer 日志或 Pod 状态验证功能组件是否安装成功。

如何开启安装 Kibana

KubeSphere 内置的日志系统已经足够满足大多数应用场景,并支持了基于多租户的日志查询。

若需要结合 Kibana 使用,可参考上述文档,在 Kibana enable 的对应参数值设置为 "true"。

待安装完成后,在项目 kubesphere-logging-system 下的 elasticsearch-logging-kibana 服务中,将服务类型设置为 NodePort,即可通过 {$NodeIP}:{$NodePort} 访问 Kibana。