Kubetail

Kubetail es un panel de registro en tiempo real para Kubernetes

Demo: https://www.kubetail.com/demo

English | 简体中文 | 日本語 | 한국어 | Deutsch | Español | Português | Français

Introducción

Kubetail es un panel de registro de propósito general para Kubernetes, optimizado para seguir logs en tiempo real a través de cargas de trabajo con múltiples contenedores. Con Kubetail, puedes ver los logs de todos los contenedores de una carga de trabajo (por ejemplo, un Deployment o un DaemonSet) combinados en una única línea temporal cronológica, disponible en el navegador o en la terminal.

El punto de entrada principal de Kubetail es la herramienta CLI kubetail, que puede abrir un panel web local en tu escritorio o transmitir logs sin procesar directamente a tu terminal. Por debajo, Kubetail usa la API de Kubernetes de tu clúster para obtener los logs directamente, por lo que funciona desde el primer momento sin necesidad de reenviar tus logs a un servicio externo. Kubetail también usa la API de Kubernetes para seguir eventos del ciclo de vida de los contenedores y mantener sincronizada la línea temporal de logs cuando los contenedores arrancan, se detienen o son reemplazados. Esto facilita seguir los logs sin interrupciones cuando las solicitudes de usuario pasan de un contenedor efímero a otro entre servicios.

Nuestro objetivo es construir la plataforma de logging para Kubernetes más potente y fácil de usar, y nos encantaría contar con tu ayuda. Si detectas un bug o tienes una sugerencia, crea un GitHub Issue o escríbenos a [email protected].

Características

• Interfaz limpia y fácil de usar
• Ver mensajes de log en tiempo real
• Filtrar logs por:
  • Carga de trabajo (por ejemplo, Deployment, CronJob, StatefulSet)
  • Rango de tiempo absoluto o relativo
  • Propiedades del nodo (por ejemplo, zona de disponibilidad, arquitectura de CPU, ID del nodo)
  • Grep
• Usa tu API de Kubernetes para recuperar mensajes de log, así que los datos nunca salen de tu control (privado por defecto)
• Cambia entre varios clústeres (solo escritorio)
• Ejecútalo en cualquier lugar: Desktop, Cluster, Docker

Inicio rápido

Instalación

Para instalar kubetail, puedes usar Homebrew:

brew install kubetail

# Krew
kubectl krew install kubetail

# Snap
sudo snap install kubetail

# Winget
winget install kubetail

# Chocolatey
choco install kubetail

# Scoop
scoop install kubetail

# MacPorts
sudo port install kubetail

# Ubuntu/Mint (apt)
sudo add-apt-repository ppa:kubetail/kubetail
sudo apt update && sudo apt install kubetail-cli

# Fedora/CentOS/RHEL/Amazonlinux/Mageia (copr)
dnf copr enable kubetail/kubetail
dnf install kubetail

# SUSE (zypper)
zypper addrepo 'https://download.opensuse.org/repositories/home:/kubetail/$releasever/' kubetail
zypper refresh && zypper install kubetail-cli

# Alpine (apk)
apk add kubetail --repository=https://dl-cdn.alpinelinux.org/alpine/edge/testing

# Arch Linux (AUR)
yay -S --noconfirm kubetail-cli

# Gentoo (GURU)
ACCEPT_KEYWORDS="~$(portageq envvar ARCH)" emerge dev-util/kubetail

# Nix (Flake)
nix profile add github:kubetail-org/kubetail-nix

# Nix (Classic)
nix-env -i -f https://github.com/kubetail-org/kubetail-nix/archive/refs/heads/main.tar.gz

# asdf
asdf plugin add kubetail https://github.com/kubetail-org/asdf-kubetail.git
asdf install kubetail latest

Si lo prefieres, también puedes descargarlo desde los binarios de las versiones o usar nuestro script de instalación:

curl -sS https://www.kubetail.com/install.sh | bash

Uso

Estas son algunas formas de usar kubetail:

1. Inicia el panel web (GUI)

kubetail serve

2. Ve los logs en tu terminal

kubetail logs -f deployments/my-app

3. Habilita funciones avanzadas (instalando la API de Kubetail)

kubetail cluster install

4. Inicializa un archivo de configuración local

kubetail config init

Consulta la documentación para ver la lista completa de commands. Disfruta siguiendo tus logs.

Ejecútalo en cualquier lugar

Además de ejecutar Kubetail en tu escritorio, también puedes usarlo en estos entornos:

• Cluster
• Docker
• Minikube

Documentación

Visita la documentación completa en https://www.kubetail.com.

Hoja de ruta y estado

Este es nuestro plan de alto nivel para el proyecto Kubetail, en orden:

Y aquí tienes algunos detalles adicionales:

Logs de contenedores en tiempo real

Los usuarios pueden ver rápida y fácilmente los logs de contenedores de los pods que se están ejecutando en sus clústeres mediante un panel web. Pueden ver los logs organizados por cargas de trabajo y seguirlos mientras se crean y eliminan contenedores efímeros. También pueden reducir la ventana de visualización por marca de tiempo y filtrar los logs por propiedades de origen como región, zona y nodo.

Búsqueda en tiempo real y experiencia de usuario pulida

Los usuarios pueden instalar Kubetail fácilmente en sus escritorios y en sus clústeres. De forma predeterminada, Kubetail usa solo la API de Kubernetes para obtener datos básicos como las cargas de trabajo en ejecución y los logs de contenedores. Si un usuario necesita funcionalidad más avanzada, puede instalar servicios personalizados de Kubetail en su clúster (es decir, "Kubetail Cluster API" y "Kubetail Cluster Agent", conocidos en conjunto como la "Kubetail API") y obtener acceso a funciones como búsqueda de logs, tamaños de archivos de log y marcas de tiempo del último evento. Toda la experiencia de instalar, actualizar y desinstalar la Kubetail API está muy cuidada, y los usuarios pueden ver sus logs con herramientas igual de potentes en el navegador y en la terminal mediante el panel web y la CLI de Kubetail.

Logs del sistema en tiempo real

Los usuarios que instalen la Kubetail API obtendrán acceso inmediato a logs a nivel de nodo (por ejemplo, systemd) y a nivel de clúster (por ejemplo, Kubernetes events), y podrán verlos en una interfaz integrada que muestra sus logs de contenedores en contexto con otra información del sistema como uso de CPU, uso de memoria y espacio en disco. Los logs del sistema se pueden ver en tiempo real, en la misma línea temporal combinada que el resto de logs. Los usuarios pueden filtrar los logs del sistema por marca de tiempo y propiedades de origen.

Personalización básica

Los usuarios podrán personalizar por completo su experiencia con Kubetail al usar el panel web y la CLI modificando sus ajustes de usuario. Estos ajustes se podrán cambiar manualmente mediante un archivo de configuración o desde la interfaz del panel. La experiencia estará muy pulida y funcionará sin problemas incluso cuando las actualizaciones añadan, eliminen o modifiquen ajustes. Los usuarios también tendrán la opción de sincronizar sus ajustes entre varios dispositivos.

Desarrollo

Estructura del repositorio

Este monorepo contiene los siguientes módulos:

• Kubetail CLI (modules/cli)
• Kubetail Cluster API (modules/cluster-api)
• Kubetail Cluster Agent (crates/cluster_agent)
• Kubetail Dashboard (modules/dashboard)

También contiene el código fuente del frontend de Kubetail Dashboard:

• Dashboard UI (dashboard-ui)

Configurar el entorno de desarrollo

Dependencias

• Go
• pnpm
• Tilt
• Clúster compatible con Tilt (por ejemplo, minikube, kind, docker-desktop)
• ctlptl (opcional)

Siguientes pasos

1. Crea un clúster de desarrollo de Kubernetes compatible con Tilt:

# minikube
ctlptl apply -f hack/ctlptl/minikube.yaml

# kind
ctlptl apply -f hack/ctlptl/kind.yaml

# docker-desktop
ctlptl apply -f hack/ctlptl/docker-desktop.yaml

1. Inicia el entorno de desarrollo:

tilt up

1. Inicia el servidor del Dashboard:

cd modules/dashboard
go run cmd/main.go -c hack/config.yaml

1. Ejecuta la Dashboard UI localmente:

cd dashboard-ui
pnpm install
pnpm dev

Ahora puedes acceder al dashboard en http://localhost:5173.

KUBETAIL_RUST_DEV_MODE=docker tilt up

# x86_64
rustup target add x86_64-unknown-linux-musl

# aarch64
rustup target add aarch64-unknown-linux-musl

# macOS (Homebrew)
brew install FiloSottile/musl-cross/musl-cross

# Linux (Ubuntu)
apt-get install musl-tools

[target.x86_64-unknown-linux-musl]
linker = "x86_64-linux-musl-gcc"

[target.aarch64-unknown-linux-musl]
linker = "aarch64-linux-musl-gcc"

KUBETAIL_RUST_DEV_MODE=local tilt up

Build

Herramienta CLI

Para compilar el ejecutable de la herramienta CLI de Kubetail (kubetail), ejecuta el siguiente comando:

make

Cuando termine el proceso de compilación, encontrarás el ejecutable en el directorio local bin/.

Dashboard

Para compilar una imagen Docker para un despliegue en producción del servidor Kubetail Dashboard, ejecuta el siguiente comando:

docker build -f build/package/Dockerfile.dashboard -t kubetail-dashboard:latest .

Cluster API

Para compilar una imagen Docker para un despliegue en producción del servidor Kubetail Cluster API, ejecuta el siguiente comando:

docker build -f build/package/Dockerfile.cluster-api -t kubetail-cluster-api:latest .

Cluster Agent

Para compilar una imagen Docker para un despliegue en producción de Kubetail Cluster Agent, ejecuta el siguiente comando:

docker build -f build/package/Dockerfile.cluster-agent -t kubetail-cluster-agent:latest .

Participa

Estamos construyendo la plataforma de logging para Kubernetes más fácil de usar, rentable y segura, y nos encantaría contar con tus contribuciones. Así es como puedes ayudar:

• Diseño UI/UX
• Desarrollo frontend con React
• Reportar problemas y sugerir funcionalidades

Escríbenos a [email protected] o únete a nuestro servidor de Discord o canal de Slack.