khi

GoogleCloudPlatformApache-2.0活跃维护

把 Kubernetes 集群日志按时间线可视化,帮助快速定位故障根因,排查 K8s 问题比翻原始日志高效得多。

A log viewer for Kubernetes troubleshooting

v0.61.1发布于 2026-10-29 08:09 UTC2,087star100fork同步于 2026-11-10 17:47 UTC

怎么上手

由 README 提炼,执行前请确认
docker run -p 127.0.0.1:8080:8080 gcr.io/kubernetes-history-inspector/release:latest
硬件要求按 README 说明

README 未说明硬件要求;运行环境需 docker 命令和最新版 Google Chrome,未提及 GPU 或显存。

有 Docker 镜像
下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

把 Kubernetes 海量日志转成可交互时间线的无代理排障工具

把 Kubernetes 集群日志按时间线可视化,帮助快速定位故障根因,排查 K8s 问题比翻原始日志高效得多。

核心能力

  • 将审计日志与资源状态变化渲染成时间线图表和 manifest diff
  • 仅凭 kube-apiserver 审计日志绘制资源关系拓扑图
  • 无需在集群内部署 agent 即可采集日志
  • 支持 Cloud Logging 或直接上传 JSONlines 日志文件
  • 提供 Job 模式,可在 CI/CD 和告警触发中无界面运行

容易踩的坑

本地 PC 等无 metadata server 的环境需先执行 gcloud auth application-default login 并挂载 ADC 凭据文件;KHI 无认证授权机制,切勿把 8080 端口暴露到公网;仅测试并支持最新版 Chrome,其他浏览器不提供支持。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.61.1
  1. v0.61.1KHI v0.61.1最新正式版2026-10-29 · 2026-10-29 08:09 UTC

    What's Changed

    New features 🎉

    Other Changes 🛠

    Full Changelog: https://github.com/GoogleCloudPlatform/khi/compare/v0.61.0...v0.61.1

  2. v0.61.0KHI v0.61.02026-10-29 · 2026-10-29 03:58 UTC
    查看更新说明

    What's Changed

    New features 🎉

    Bug Fixes 🐛

    Refactoring ♻️

    Documentation 📝

    Other Changes 🛠

    Maintenance 🧹

    Full Changelog: https://github.com/GoogleCloudPlatform/khi/compare/v0.60.1...v0.61.0

  3. v0.60.1KHI v0.60.12026-10-22 · 2026-10-22 05:53 UTC
    查看更新说明

    What's Changed

    New features 🎉

    Bug Fixes 🐛

    Refactoring ♻️

    CI/CD ⚙️

    Development Environment 💻

    Documentation 📝

    Other Changes 🛠

    Maintenance 🧹

    • chore(agent): remove requirement for user approval before push by @kyasbal in https://github.c
  4. v0.59.0KHI v0.59.02026-09-18 · 2026-09-18 14:18 UTC
    查看更新说明

    What's Changed

    New features 🎉

    Bug Fixes 🐛

    Refactoring ♻️

  5. v0.58.2KHI v0.58.22026-09-03 · 2026-09-03 11:35 UTC
    查看更新说明

    We've migrated the majority of the features from frontend heavy architecture to backend side. This enables us to gather logs even over 10M logs. In addition to this big architecture change, we've implemented full text search index in backend side. This allows us to search resources containing logs with specific keywords really faster. It would return the full text search query for 10M logs in few secounds!

    Note I'll skip v0.58.0 and v0.58.1 for OSS release for some reasons. This v0.58.2 is our first release of v0.58.x.

    What's Changed

    Bug Fixes 🐛

    Development Environment 💻

    Documentation 📝

    Other Changes 🛠

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    Kubernetes History Inspector Demo

    Kubernetes History Inspector

    Kubernetes History Inspector (KHI) is a rich log visualization tool for Kubernetes clusters. KHI transforms vast quantities of logs into an interactive, comprehensive timeline view. This makes it an invaluable tool for troubleshooting complex issues that span multiple components within your Kubernetes clusters. Also, KHI is agentless, allowing anyone to access its features without a complicated process.

    Getting started

    The easiest way to try KHI is using Cloud Shell, where the metadata server is available without requiring initial credential setup.

    Running in Cloud Shell

    1. Open Cloud Shell

    2. Run the following command:

      docker run -p 127.0.0.1:8080:8080 gcr.io/kubernetes-history-inspector/release:latest
      
    3. Click the link http://localhost:8080 on the terminal and start working with KHI!

    Running in environment without a metadata server (Local PC, etc.)

    If you want to run KHI in an environment where the metadata server is not available, you can use Application Default Credentials (ADC) by mounting your ADC file from your host filesystem to the container.

    For Linux, MacOS or WSL
    gcloud auth application-default login
    docker run \
     -p 127.0.0.1:8080:8080 \
     -v ~/.config/gcloud/application_default_credentials.json:/root/.config/gcloud/application_default_credentials.json:ro \
     gcr.io/kubernetes-history-inspector/release:latest
    
    For Windows PowerShell
    gcloud auth application-default login
    docker run `
    -p 127.0.0.1:8080:8080 `
    -v $env:APPDATA\gcloud\application_default_credentials.json:/root/.config/gcloud/application_default_credentials.json:ro `
    gcr.io/kubernetes-history-inspector/release:latest
    

    Supported Products & Environments

    Kubernetes cluster

    Logging backend

    • Google Cloud

      • Cloud Logging (Primary log source for all clusters on Google Cloud)
      • Cloud Asset Inventory (Supplementary: used optionally to reconstruct initial state snapshots for pre-existing resources)
    • Other

    Supported environment

    • Latest Google Chrome
    • docker command

    [!IMPORTANT] We only test KHI on the latest version of Google Chrome. KHI may work with other browsers, but we do not provide support if it does not.

    Environment Setup Guide

    Google Cloud

    Read Google Cloud Permissions & Configuration Guide.

    OSS Kubernetes

    Read Using KHI with OSS Kubernetes Clusters - Example with Loki.

    User Guide

    Please refer to the User Guide for detailed usage.

    Development Contribution Guide

    If you'd like to contribute to the project KHI, read Contribution Guide and then follow Development Guide

    Disclaimer

    Please note that this tool is not an officially supported Google Cloud product. If you find any issues and have a feature request, file a Github issue on this repository and we are happy to check them on best-effort basis.

    [!IMPORTANT] Do not expose KHI port on the internet. KHI itself is not providing any authentication or authorization features and KHI is intended to be accessed from its local user.