KubeBolt docs
ENES GitHub

Conceptos

Vistas de recursos

26 vistas de lista de recursos con búsqueda, paginación y métricas en vivo, más Namespaces, Events, el RBAC del clúster y las releases de Helm, y una página de detalle con pestañas para cada objeto.

En esta página
  1. Recursos compatibles
  2. Vistas de detalle de recursos
  3. Acciones
  4. Gráficos de Monitor en rangos largos
  5. Revelar el valor de un Secret

Recursos compatibles

KubeBolt tiene 26 vistas de lista de recursos, agrupadas en la barra lateral del clúster igual que en la tabla de abajo. Cada una admite búsqueda, filtro por namespace, paginación en el servidor (50 por página) y, donde aplica, CPU y memoria en vivo de Metrics Server. La barra lateral muestra un recuento junto a cada una y marca las que tu identidad no puede listar (consulta RBAC).

Grupo de la barra lateralRecursos
PinnedPods, Nodes (más Insights, Applications y, en KubeBolt Cloud, Autopilot)
WorkloadsDeployments, StatefulSets, DaemonSets, Jobs, CronJobs
TrafficServices, Ingresses, NetworkPolicies, Cilium Policies (CiliumNetworkPolicies), Cilium Cluster Policies (CiliumClusterwideNetworkPolicies), PodDisruptionBudgets, Gateways, HTTPRoutes, Endpoints (EndpointSlices)
StoragePVCs, PVs, StorageClasses
ConfigConfigMaps, Secrets (las claves por defecto; los valores solo a través de la revelación auditada), Service Accounts, HPAs
ExtensionsCertificates (cert-manager), ArgoCD Apps, VPA (VerticalPodAutoscalers)

El grupo Cluster añade tres vistas que no son simples listas: Namespaces, Events y RBAC (ClusterRoles y ClusterRoleBindings), junto a Clusters, donde se añaden, renombran y eliminan clústeres (Multiclúster). Las vistas de extensiones y de Cilium solo muestran datos cuando el CRD está instalado; un CRD que falta se indica con una nota neutra, «Optional integrations not detected», no como un problema de permisos, y un CRD instalado más tarde se detecta en menos de dos minutos. Los ReplicaSets no tienen lista propia: aparecen en el historial de un Deployment, en la pestaña Related y en el Cluster Map.

Namespaces pagina de 50 en 50, cuenta todos los namespaces y filtra por nombre. Cuando las credenciales de KubeBolt no pueden listar eventos, Events muestra Access Restricted en lugar de fallar, y a Kobi se le indica que no ver eventos no significa que no los haya.

Applications lista las releases de Helm del clúster: estado, chart, values, manifest, notas, los recursos que posee cada release y su historial de revisiones. Es de solo lectura: KubeBolt no instala, actualiza ni revierte releases de Helm. Consulta Aplicaciones de Helm.

En un clúster solo de métricas (un agente que envía métricas pero no da a KubeBolt acceso a la API) estas vistas están desactivadas; el panel sigue funcionando.

Vistas de detalle de recursos

Cada recurso tiene una página de detalle con pestañas en /:type/:namespace/:name (_ ocupa el lugar del namespace en los recursos de ámbito de clúster). Las pestañas disponibles varían según el tipo:

Un Deployment: acciones, pods, historial y eventos sin salir de la página.
Un Deployment: acciones, pods, historial y eventos sin salir de la página. KubeBolt 2.1.1
RecursoPestañas además de Overview, YAML y Events
PodsContainers, Logs, Terminal, Files, Volumes, Related, Monitor
Deployments, StatefulSets, DaemonSetsPods, Logs, Terminal, Related, History, Monitor
JobsPods, Logs, Related
CronJobsJobs, Related
ServicesRelated
NodesPods, Monitor
NetworkPolicies, Cilium policies, PodDisruptionBudgetsMatched Pods, Related
PersistentVolumeClaimsMonitor

Qué hace cada pestaña:

Acciones

La barra de herramientas que hay sobre las pestañas tiene Describe (la salida de kubectl describe, que oculta los mismos valores que la pestaña YAML) y, cuando Kobi está configurado, Ask Kobi, para cualquier rol. Las escrituras necesitan Editor, los borrados necesitan Admin, y todas quedan auditadas:

RecursoAcciones
Deployments, StatefulSets, DaemonSetsSet image, Restart; en Actions ▾: Set resources, Set env, Scale (no en DaemonSets), Pause / Resume rollout (Deployments). El rollback se hace desde la pestaña History
PodsRestart (borra el pod para que su controlador lo vuelva a crear); en Actions ▾: Evict pod (respeta los PodDisruptionBudgets), Debug (un contenedor de depuración efímero). Port-forward desde los puertos de un contenedor
CronJobsTrigger now, Suspend / Resume
NodesCordon / Uncordon; Drain (Admin)
SecretsReveal (ver abajo)
Cualquier tipoEdit metadata (etiquetas y anotaciones), Delete (Admin)

En un clúster al que se llega a través del agente, las escrituras, el exec, el port-forward y el explorador de archivos necesitan el agente en modo operator; en modo reader vuelven como errores de permisos. Consulta Conectar clústeres.

Gráficos de Monitor en rangos largos

Un gráfico histórico dibuja un punto por intervalo, y el intervalo crece con el rango:

RangoUn punto cada
5m, 15m, 1h15 o 30 s
6h2 min
24h10 min
7d1 h
14d2 h
30d6 h

Desde 6h, los gráficos de CPU y memoria de pods, workloads y nodos dibujan el valor más alto dentro de cada intervalo, leído una vez por minuto, así que una subida entre dos puntos sigue viéndose. Las estadísticas que acompañan a esos gráficos cambian de nombre en consecuencia:

La herramienta get_workload_metrics de Kobi lee esos mismos máximos y dice cuándo se produjo el máximo.

Los gráficos de red no usan máximos: cada punto es la tasa del minuto anterior, así que en un rango largo una ráfaga entre dos puntos no se ve.

Dimensiona un request a partir del uso típico (el P95 del rightsizing) y el margen de un límite de memoria a partir de max.

Un pod que corre con hostNetwork comparte la red de su nodo, así que no tiene tráfico propio que dibujar. Su pestaña Monitor muestra Uses the node’s network con un enlace a la pestaña Monitor de cada nodo, y lo mismo hace un workload cuyos pods corren así. Desde el agente 1.4.8, un pod así no envía red de pod en absoluto; su tráfico se cuenta una sola vez, en el nodo. Consulta Compatibilidad.

Revelar el valor de un Secret

La vista YAML nunca muestra los valores de los Secrets. Cuando de verdad necesitas uno (para validar una rotación, por ejemplo), hay un camino aparte y deliberadamente estrecho en lugar de bajar a kubectl get secret -o yaml | base64 -d:

POST /api/v1/resources/secrets/{namespace}/{name}/reveal

Está diseñado para ser auditable, no cómodo:

Cuerpo de la petición: {"keys": ["…"], "reason": "…"}. Si se omite keys, se revelan todas las claves y la amplitud se audita como <all>. Los valores que no son UTF-8 imprimible vuelven como un sha256 más un recuento de bytes, en lugar de como texto ilegible.