Kubernetes MCP Server

Sigue la guía dedicada de primeros pasos con Claude Code en nuestra documentación para usuarios.

Para una configuración segura de producción con una ServiceAccount dedicada y acceso de solo lectura, consulta también la guía de configuración de Kubernetes.

• configuration_contexts_list - Lista todos los nombres de contexto disponibles y las URLs de servidor asociadas del archivo kubeconfig

• targets_list - Lista todos los objetivos disponibles

• configuration_view - Obtiene el contenido actual de la configuración de Kubernetes como un kubeconfig YAML

  • minified (boolean) - Devuelve una versión minificada de la configuración. Si se establece en true, conserva solo el contexto actual y las partes relevantes de la configuración para ese contexto. Si se establece en false, se devuelven todos los contextos, clústeres, auth-infos y usuarios en la configuración. (Opcional, predeterminado true)

• events_list - Lista eventos de Kubernetes (advertencias, errores, cambios de estado) para depuración y solución de problemas en el clúster actual de todos los namespaces

  • fieldSelector (string) - Selector de campo de Kubernetes opcional para filtrar eventos por valores de campo (p. ej., 'type=Warning', 'involvedObject.name=my-pod'). Campos admitidos: involvedObject.kind, involvedObject.name, involvedObject.namespace, involvedObject.uid, involvedObject.apiVersion, involvedObject.resourceVersion, involvedObject.fieldPath, reason, reportingComponent, source, type. Ver https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/
  • namespace (string) - Namespace opcional para recuperar los eventos. Si no se proporciona, se listarán eventos de todos los namespaces

• namespaces_list - Lista todos los namespaces de Kubernetes en el clúster actual

  • fieldSelector (string) - Selector de campo de Kubernetes opcional para filtrar namespaces por valores de campo (p. ej., 'metadata.name=default', 'status.phase=Active'). Campos admitidos: metadata.name, status.phase. Ver https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/

• projects_list - Lista todos los proyectos de OpenShift en el clúster actual

• nodes_log - Obtiene logs de un nodo de Kubernetes (kubelet, kube-proxy u otros logs del sistema). Esto accede a los logs del nodo a través del proxy de la API de Kubernetes hacia el kubelet

  • name (string) (obligatorio) - Nombre del nodo del cual obtener logs
  • query (string) (obligatorio) - query especifica servicios o archivos de los cuales devolver logs (obligatorio). Ejemplo: "kubelet" para obtener logs de kubelet, "/" para obtener un archivo de log específico del nodo (p. ej., "/var/log/kubelet.log" o "/var/log/kube-proxy.log")
  • tailLines (integer) - Número de líneas a recuperar desde el final de los logs (Opcional, 0 significa todos los logs)

• nodes_stats_summary - Obtiene estadísticas detalladas de uso de recursos de un nodo de Kubernetes a través de la API Summary del kubelet. Proporciona métricas completas que incluyen uso de CPU, memoria, sistema de archivos y red a nivel de nodo, pod y contenedor. En sistemas con cgroup v2 y kernel 4.20+, también incluye métricas PSI (Pressure Stall Information) que muestran la presión de recursos para CPU, memoria y E/S. Ver https://kubernetes.io/docs/reference/instrumentation/understand-psi-metrics/ para detalles sobre métricas PSI

  • name (string) (obligatorio) - Nombre del nodo del cual obtener estadísticas

• nodes_top - Lista el consumo de recursos (CPU y memoria) registrado por el Kubernetes Metrics Server para los nodos de Kubernetes especificados o todos los nodos del clúster

  • label_selector (string) - Selector de etiquetas de Kubernetes (p. ej., 'node-role.kubernetes.io/worker=') para filtrar nodos por etiqueta (Opcional, solo aplicable cuando no se proporciona el nombre)
  • name (string) - Nombre del nodo del cual obtener el consumo de recursos (Opcional, todos los nodos si no se proporciona)

• pods_list - Lista todos los pods de Kubernetes en el clúster actual de todos los namespaces

  • fieldSelector (string) - Selector de campo de Kubernetes opcional para filtrar pods por valores de campo (p. ej., 'status.phase=Running', 'spec.nodeName=node1'). Campos admitidos: metadata.name, metadata.namespace, spec.nodeName, spec.restartPolicy, spec.schedulerName, spec.serviceAccountName, status.phase (Pending/Running/Succeeded/Failed/Unknown), status.podIP, status.nominatedNodeName. Nota: CrashLoopBackOff es un estado de contenedor, no una fase de pod, por lo que no se puede filtrar directamente. Ver https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/
  • labelSelector (string) - Selector de etiquetas de Kubernetes opcional (p. ej., 'app=myapp,env=prod' o 'app in (myapp,yourapp)'), usa esta opción cuando quieras filtrar los pods por etiqueta

• pods_list_in_namespace - Lista todos los pods de Kubernetes en el namespace especificado en el clúster actual

  • fieldSelector (string) - Selector de campo de Kubernetes opcional para filtrar pods por valores de campo (p. ej., 'status.phase=Running', 'spec.nodeName=node1'). Campos admitidos: metadata.name, metadata.namespace, spec.nodeName, spec.restartPolicy, spec.schedulerName, spec.serviceAccountName, status.phase (Pending/Running/Succeeded/Failed/Unknown), status.podIP, status.nominatedNodeName. Nota: CrashLoopBackOff es un estado de contenedor, no una fase de pod, por lo que no se puede filtrar directamente. Ver https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/
  • labelSelector (string) - Selector de etiquetas de Kubernetes opcional (p. ej., 'app=myapp,env=prod' o 'app in (myapp,yourapp)'), usa esta opción cuando quieras filtrar los pods por etiqueta
  • namespace (string) (obligatorio) - Namespace del cual listar pods

• pods_get - Obtiene un Pod de Kubernetes en el namespace actual o proporcionado con el nombre proporcionado

  • name (string) (obligatorio) - Nombre del Pod
  • namespace (string) - Namespace del cual obtener el Pod

• pods_delete - Elimina un Pod de Kubernetes en el namespace actual o proporcionado con el nombre proporcionado

  • name (string) (obligatorio) - Nombre del Pod a eliminar
  • namespace (string) - Namespace del cual eliminar el Pod

• pods_top - Lista el consumo de recursos (CPU y memoria) registrado por el Kubernetes Metrics Server para los Pods de Kubernetes especificados en todos los namespaces, el namespace proporcionado o el namespace actual

  • all_namespaces (boolean) - Si es true, lista el consumo de recursos para todos los Pods en todos los namespaces. Si es false, lista el consumo de recursos para los Pods en el namespace proporcionado o el namespace actual
  • label_selector (string) - Selector de etiquetas de Kubernetes (p. ej., 'app=myapp,env=prod' o 'app in (myapp,yourapp)'), usa esta opción cuando quieras filtrar los pods por etiqueta (Opcional, solo aplicable cuando no se proporciona el nombre)
  • name (string) - Nombre del Pod del cual obtener el consumo de recursos (Opcional, todos los Pods en el namespace si no se proporciona)
  • namespace (string) - Namespace del cual obtener el consumo de recursos de los Pods (Opcional, namespace actual si no se proporciona y all_namespaces es false)

• pods_exec - Ejecuta un comando en un Pod de Kubernetes (acceso a shell, ejecutar comandos en el contenedor) en el namespace actual o proporcionado con el nombre y comando proporcionados

  • command (array) (obligatorio) - Comando a ejecutar en el contenedor del Pod. El primer elemento es el comando a ejecutar, y el resto son los argumentos de ese comando. Ejemplo: ["ls", "-l", "/tmp"]
  • container (string) - Nombre del contenedor del Pod donde se ejecutará el comando (Opcional)
  • name (string) (obligatorio) - Nombre del Pod donde se ejecutará el comando
  • namespace (string) - Namespace del Pod donde se ejecutará el comando

• pods_log - Obtiene los logs de un Pod de Kubernetes en el namespace actual o proporcionado con el nombre proporcionado

  • container (string) - Nombre del contenedor del Pod del cual obtener logs (Opcional)
  • name (string) (obligatorio) - Nombre del Pod del cual obtener logs
  • namespace (string) - Namespace del cual obtener los logs del Pod
  • previous (boolean) - Devuelve logs de contenedores terminados anteriormente (Opcional)
  • tail (integer) - Número de líneas a recuperar desde el final de los logs (Opcional, predeterminado: 100)

• pods_run - Ejecuta un Pod de Kubernetes en el namespace actual o proporcionado con la imagen de contenedor proporcionada y un nombre opcional

  • image (string) (obligatorio) - Imagen del contenedor para ejecutar en el Pod
  • name (string) - Nombre del Pod (opcional, nombre aleatorio si no se proporciona)
  • namespace (string) - Namespace donde ejecutar el Pod
  • port (number) - Puerto TCP/IP para exponer desde el contenedor del Pod (opcional, no se expone ningún puerto si no se proporciona)

• resources_list - Lista los recursos y objetos de Kubernetes en el clúster actual proporcionando su apiVersion y kind, y opcionalmente el namespace y el selector de etiquetas (los apiVersion y kind comunes incluyen: v1 Pod, v1 Service, v1 Node, apps/v1 Deployment, networking.k8s.io/v1 Ingress, route.openshift.io/v1 Route)

  • apiVersion (string) (obligatorio) - apiVersion de los recursos (ejemplos de apiVersion válidos son: v1, apps/v1, networking.k8s.io/v1)
  • fieldSelector (string) - Selector de campo de Kubernetes opcional para filtrar recursos por valores de campo (p. ej. 'status.phase=Running', 'metadata.name=myresource'). Los campos admitidos varían según el tipo de recurso. Para Pods: metadata.name, metadata.namespace, spec.nodeName, spec.restartPolicy, spec.schedulerName, spec.serviceAccountName, status.phase (Pending/Running/Succeeded/Failed/Unknown), status.podIP, status.nominatedNodeName. Ver https://kubernetes.io/docs/concepts/overview/working-with-objects/field-selectors/
  • kind (string) (obligatorio) - kind de los recursos (ejemplos de kind válidos son: Pod, Service, Deployment, Ingress)
  • labelSelector (string) - Selector de etiquetas de Kubernetes opcional (p. ej. 'app=myapp,env=prod' o 'app in (myapp,yourapp)'), use esta opción cuando desee filtrar los recursos por etiqueta
  • namespace (string) - Namespace opcional para recuperar los recursos con espacio de nombres (se ignora en caso de recursos de ámbito de clúster). Si no se proporciona, se listarán los recursos de todos los namespaces

• resources_get - Obtiene un recurso de Kubernetes en el clúster actual proporcionando su apiVersion, kind, opcionalmente el namespace, y su nombre (los apiVersion y kind comunes incluyen: v1 Pod, v1 Service, v1 Node, apps/v1 Deployment, networking.k8s.io/v1 Ingress, route.openshift.io/v1 Route)

  • apiVersion (string) (obligatorio) - apiVersion del recurso (ejemplos de apiVersion válidos son: v1, apps/v1, networking.k8s.io/v1)
  • kind (string) (obligatorio) - kind del recurso (ejemplos de kind válidos son: Pod, Service, Deployment, Ingress)
  • name (string) (obligatorio) - Nombre del recurso
  • namespace (string) - Namespace opcional para recuperar el recurso con espacio de nombres (se ignora en caso de recursos de ámbito de clúster). Si no se proporciona, se obtendrá el recurso del namespace configurado

• resources_create_or_update - Crea o actualiza un recurso de Kubernetes mediante Server-Side Apply. El manifiesto es el estado deseado completo: cualquier campo que esta herramienta haya establecido previamente y que el nuevo manifiesto omita se elimina. Para editar un recurso existente, obténgalo con resources_get, modifíquelo y luego vuelva a aplicar el recurso completo. (los apiVersion y kind comunes incluyen: v1 Pod, v1 Service, v1 Node, apps/v1 Deployment, networking.k8s.io/v1 Ingress, route.openshift.io/v1 Route)

  • resource (string) (obligatorio) - Representación YAML o JSON completa del recurso de Kubernetes (estado deseado completo, no un parche parcial). Incluya apiVersion, kind, metadata y la especificación completa.

• resources_delete - Elimina un recurso de Kubernetes en el clúster actual proporcionando su apiVersion, kind, opcionalmente el namespace, y su nombre (los apiVersion y kind comunes incluyen: v1 Pod, v1 Service, v1 Node, apps/v1 Deployment, networking.k8s.io/v1 Ingress, route.openshift.io/v1 Route)

  • apiVersion (string) (obligatorio) - apiVersion del recurso (ejemplos de apiVersion válidos son: v1, apps/v1, networking.k8s.io/v1)
  • gracePeriodSeconds (integer) - Duración opcional en segundos antes de que el objeto deba eliminarse. El valor debe ser un entero no negativo. El valor cero indica eliminación inmediata. Si este valor es nulo, se utilizará el período de gracia predeterminado para el tipo especificado
  • kind (string) (obligatorio) - kind del recurso (ejemplos de kind válidos son: Pod, Service, Deployment, Ingress)
  • name (string) (obligatorio) - Nombre del recurso
  • namespace (string) - Namespace opcional para eliminar el recurso con espacio de nombres (se ignora en caso de recursos de ámbito de clúster). Si no se proporciona, se eliminará el recurso del namespace configurado

• resources_scale - Obtiene o actualiza la escala de un recurso de Kubernetes en el clúster actual proporcionando su apiVersion, kind, nombre y opcionalmente el namespace. Si la escala se establece en la llamada a la herramienta, la escala se actualizará a ese valor. Siempre devuelve la escala actual del recurso

  • apiVersion (string) (obligatorio) - apiVersion del recurso (ejemplos de apiVersion válidos son apps/v1)
  • kind (string) (obligatorio) - kind del recurso (ejemplos de kind válidos son: StatefulSet, Deployment)
  • name (string) (obligatorio) - Nombre del recurso
  • namespace (string) - Namespace opcional para obtener/actualizar la escala del recurso con espacio de nombres (se ignora en caso de recursos de ámbito de clúster). Si no se proporciona, se obtendrá/actualizará la escala del recurso del namespace configurado
  • scale (integer) - Escala opcional para actualizar la escala del recurso. Si no se proporciona, se devolverá la escala actual del recurso y no se actualizará

• helm_install - Instala (despliega) un chart de Helm para crear un release en el namespace actual o proporcionado

  • chart (string) (obligatorio) - Referencia del chart para instalar (por ejemplo: stable/grafana, oci://ghcr.io/nginxinc/charts/nginx-ingress)
  • name (string) - Nombre del release de Helm (opcional, nombre aleatorio si no se proporciona)
  • namespace (string) - Namespace donde instalar el chart de Helm (opcional, namespace actual si no se proporciona)
  • values (object) - Valores para pasar al chart de Helm (opcional)

• helm_list - Lista todos los releases de Helm en el namespace actual o proporcionado (o en todos los namespaces si se especifica)

  • all_namespaces (boolean) - Si es verdadero, lista todos los releases de Helm en todos los namespaces ignorando el argumento de namespace (opcional)
  • namespace (string) - Namespace para listar los releases de Helm (opcional, todos los namespaces si no se proporciona)

• helm_uninstall - Desinstala un release de Helm en el namespace actual o proporcionado

  • name (string) (obligatorio) - Nombre del release de Helm para desinstalar
  • namespace (string) - Namespace desde el cual desinstalar el release de Helm (opcional, namespace actual si no se proporciona)

• kcp_workspaces_list - Lista todos los workspaces kcp disponibles en el clúster actual

• kcp_workspace_describe - Obtiene información detallada sobre un workspace kcp específico

  • workspace (string) (obligatorio) - Nombre o ruta del workspace para describir

• kiali_get_mesh_traffic_graph - Devuelve la topología de tráfico servicio a servicio, dependencias y métricas de red (rendimiento, tiempo de respuesta, mTLS) para los namespaces especificados. Use esto para diagnosticar problemas de enrutamiento, latencia o encontrar dependencias ascendentes/descendentes.

  • graphType (string) - Granularidad del gráfico. 'app' agrega por nombre de aplicación, 'versionedApp' separa por versiones, 'workload' mapea pods/deployments específicos. Predeterminado: versionedApp.
  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (p. ej. west). Cuando se omite, Kiali usa su clúster local por defecto.
  • namespaces (string) (obligatorio) - Lista separada por comas de namespaces para mapear

• kiali_get_mesh_status - Recupera los detalles de salud, topología y entorno de alto nivel de la malla de servicios Istio. Devuelve el estado del plano de control multinúcleo (istiod), la salud de los namespaces del plano de datos (incluido el estado de la malla ambiental), la salud de la pila de observabilidad (Prometheus, Grafana...) y la conectividad de los componentes. Use esta herramienta como primer paso para diagnosticar problemas en toda la malla, verificar versiones de Istio/Kiali o comprobar la salud general antes de profundizar en cargas de trabajo específicas.

• kiali_manage_istio_config_read - Lee la configuración de Istio, Gateway API e Inference API. 'list' agrupa por namespace→'group/version/kind'→{valid:[...],invalid:[...]} donde los arreglos valid/invalid contienen nombres de recursos; omita group/kind para recuperar TODOS los tipos de configuración en una sola llamada. Admite Istio (networking.istio.io, security.istio.io), Gateway API (gateway.networking.k8s.io) e Inference API (inference.networking.k8s.io) cuando están instalados. 'get' devuelve el YAML completo. Para escrituras use manage_istio_config.

  • action (string) (obligatorio) - Acción a realizar (solo lectura)
  • group (string) - Grupo de API del objeto Istio. Requerido SOLO para la acción 'get'. Para 'list', OMITA group y kind para recuperar TODOS los tipos de configuración en una sola llamada. Use 'gateway.networking.k8s.io' para recursos de Gateway API. Use 'inference.networking.k8s.io' para recursos de Inference API.
  • kind (string) - Kind del objeto Istio. Requerido SOLO para la acción 'get'. Para 'list', OMÍTALO para devolver todos los kinds a la vez — no llame por separado para cada kind.
  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (p. ej. west). Cuando se omite, Kiali usa su clúster local por defecto.
  • namespace (string) - Namespace que contiene el objeto Istio. Para 'list', si no se proporciona, devuelve objetos de todos los namespaces. Para 'get', es obligatorio.
  • object (string) - Nombre del objeto Istio. Requerido para la acción 'get'.
  • serviceName (string) - Filtra las configuraciones de Istio (VirtualServices, DestinationRules y sus Gateways referenciados) que afectan a un servicio específico. Solo aplicable para la acción 'list'
  • version (string) - Versión de API. Use 'v1' para todos los tipos de recursos. Requerido para la acción 'get'.

• kiali_manage_istio_config - Crear, parchear o eliminar configuración de Istio, Gateway API e Inference API. Admite recursos de Istio (networking.istio.io, security.istio.io), recursos de Gateway API (gateway.networking.k8s.io) y recursos de Inference API (inference.networking.k8s.io) cuando están instalados en el clúster. Para listar y obtener (solo lectura), use manage_istio_config_read.

  • action (string) (obligatorio) - Acción a realizar (escritura)
  • data (string) - Datos JSON o YAML para el recurso. Obligatorio para acciones de crear y parchear. Para crear, puede proporcionar contenido parcial (por ejemplo, solo spec) y se fusionará con una plantilla válida con valores predeterminados. Los arreglos (como servers, http, etc.) se REEMPLAZAN por completo, así que incluya TODOS los elementos que desee.
  • group (string) (obligatorio) - Grupo de API del objeto Istio. Use 'gateway.networking.k8s.io' para recursos de Gateway API. Use 'inference.networking.k8s.io' para recursos de Inference API.
  • kind (string) (obligatorio) - Tipo del objeto Istio (por ejemplo, 'VirtualService', 'DestinationRule').
  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (por ejemplo, west). Cuando se omite, Kiali usa su clúster local por defecto.
  • namespace (string) (obligatorio) - Namespace que contiene el objeto Istio.
  • object (string) (obligatorio) - Nombre del objeto Istio.
  • version (string) (obligatorio) - Versión de API. Use 'v1' para todos los tipos de recursos.

• kiali_list_mesh_clusters - Devuelve la lista de clústeres de malla Istio a los que Kiali puede acceder. Cada entrada incluye su nombre y si es el clúster local (donde está desplegado Kiali). Llame a esta herramienta antes de usar meshCluster en otras herramientas de Kiali cuando el clúster de destino sea desconocido.

• kiali_get_resource_details - Obtiene una lista de recursos O recupera datos detallados de un recurso específico. Si se omite 'resourceName', devuelve una lista. Si se proporciona 'resourceName', devuelve detalles de ese recurso específico.

  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (por ejemplo, west). Cuando se omite, Kiali usa su clúster local por defecto.
  • namespaces (string) - Lista separada por comas de namespaces para consultar (por ejemplo, 'bookinfo' o 'bookinfo,default'). Si no se proporciona, consultará en todos los namespaces accesibles.
  • resourceName (string) - Opcional. El nombre específico del recurso. Si se deja vacío, la herramienta devuelve una lista de todos los recursos del tipo especificado. Si se proporciona, la herramienta devuelve detalles profundos de este recurso específico.
  • resourceType (string) (obligatorio) - El tipo de recurso a consultar. Use 'app' para aplicaciones de Kiali (agrupadas por la etiqueta 'app' de Kubernetes). Use 'argoapp' para CRDs de aplicaciones ArgoCD (requiere ArgoCD instalado y la cuenta de servicio de Kiali debe tener permisos de lectura en applications.argoproj.io).

• kiali_list_traces - Lista trazas distribuidas para un servicio en un namespace. Devuelve un resumen (namespace, service, total_found, avg_duration_ms) y una lista de trazas con id, duration_ms, spans_count, root_op, slowest_service, has_errors. Use get_trace_details con un id de traza para obtener la jerarquía completa.

  • errorOnly (boolean) - Si es true, solo considera trazas que contengan errores. Por defecto false.
  • limit (integer) - Número máximo de trazas a devolver. Por defecto 10.
  • lookbackSeconds (integer) - Cuánto tiempo hacia atrás buscar. Por defecto 600 (10m).
  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (por ejemplo, west). Cuando se omite, Kiali usa su clúster local por defecto.
  • namespace (string) (obligatorio) - Namespace de Kubernetes del servicio.
  • serviceName (string) (obligatorio) - Nombre del servicio para buscar trazas (obligatorio). Devuelve múltiples trazas hasta el límite.

• kiali_get_trace_details - Obtiene una sola traza distribuida por trace_id y devuelve su jerarquía de llamadas (árbol de servicios con duración, estado y llamadas anidadas). Use esto después de list_traces para profundizar en una traza específica.

  • traceId (string) (obligatorio) - ID de traza para obtener y resumir. Si se proporciona, namespace/service_name se ignoran.

• kiali_get_pod_performance - Devuelve un resumen de texto legible con el uso actual de CPU/memoria del Pod (de Prometheus) comparado con los requests/limits de Kubernetes (de la especificación del Pod). Útil para responder preguntas como '¿Está esta carga de trabajo usando demasiada memoria?'

  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (por ejemplo, west). Cuando se omite, Kiali usa su clúster local por defecto.
  • namespace (string) (obligatorio) - Namespace de Kubernetes del Pod.
  • podName (string) - Nombre del Pod de Kubernetes. Si se proporciona workloadName, la herramienta intentará resolver un Pod de esa carga de trabajo primero.
  • queryTime (string) - Marca de tiempo final opcional (RFC3339) para la consulta. Por defecto es ahora.
  • timeRange (string) - Ventana de tiempo usada para calcular la tasa de CPU (duración de Prometheus como '5m', '10m', '1h', '1d'). Por defecto '10m'.
  • workloadName (string) - Nombre de la carga de trabajo de Kubernetes (por ejemplo, Deployment/StatefulSet/etc). La herramienta buscará la carga de trabajo y elegirá uno de sus Pods. Si no se encuentra, tratará este valor como un podName.

• kiali_get_logs - Obtiene los logs de un Pod de Kubernetes (o nombre de carga de trabajo que se resolverá a un pod) en un namespace. La salida es texto plano, coincidiendo con kubernetes-mcp-server pods_log. El campo line_count indica el número total de líneas de log devueltas. Analice TODAS ellas, pero resuma los resultados a menos que el usuario pida explícitamente la salida sin procesar. No omita ninguna línea de error o advertencia.

  • container (string) - Opcional. Nombre del contenedor del Pod del que obtener los logs.
  • format (string) - Formato de salida para el chat. 'codeblock' envuelve los logs en cercas ~~~ (recomendado). 'plain' devuelve texto sin procesar como kubernetes-mcp-server pods_log.
  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (por ejemplo, west). Cuando se omite, Kiali usa su clúster local por defecto.
  • name (string) (obligatorio) - Nombre del Pod del que obtener los logs. Si no existe, se tratará como un nombre de carga de trabajo y se seleccionará un pod en ejecución.
  • namespace (string) (obligatorio) - Namespace del que obtener los logs del Pod
  • previous (boolean) - Opcional. Devuelve logs de contenedores terminados anteriormente
  • severity (string) - Filtro de severidad opcional aplicado en el lado del cliente. Acepta 'ERROR', 'WARN' o combinaciones como 'ERROR,WARN'.
  • tail (integer) - Número de líneas a recuperar desde el final de los logs (Opcional, por defecto 50). No puede exceder 200 líneas.
  • workload (string) - Opcional. Anulación del nombre de la carga de trabajo (usado cuando falla la búsqueda por nombre).

• kiali_get_metrics - Devuelve un resumen JSON compacto de métricas de Istio (cuantiles de latencia, tendencias de tráfico, rendimiento, tamaños de payload) para el recurso dado.

  • byLabels (string) - Lista separada por comas de etiquetas para agrupar métricas (por ejemplo, 'source_workload,destination_service'). Opcional
  • direction (string) - Dirección del tráfico. Opcional, por defecto 'outbound'
  • meshCluster (string) - Nombre opcional del clúster de malla Istio de kiali_list_mesh_clusters (por ejemplo, west). Cuando se omite, Kiali usa su clúster local por defecto.
  • namespace (string) (obligatorio) - Namespace del que obtener métricas
  • quantiles (string) - Lista separada por comas de cuantiles para métricas de histograma (por ejemplo, '0.5,0.95,0.99'). Opcional
  • rateInterval (string) - Intervalo de tasa para métricas (por ejemplo, '1m', '5m'). Opcional, por defecto '10m'
  • reporter (string) - Reportero(s) de métricas. Lista separada por comas de: 'source', 'destination', 'waypoint', o el valor especial 'both' (sin filtro de reportero). Opcional, por defecto 'source'. Ejemplo: 'source,waypoint'
  • requestProtocol (string) - Filtrar por protocolo de solicitud (por ejemplo, 'http', 'grpc', 'tcp'). Opcional
  • resourceName (string) (obligatorio) - Nombre del recurso del que obtener métricas
  • resourceType (string) (obligatorio) - Tipo de recurso del que obtener métricas
  • step (string) - Paso entre puntos de datos en segundos (por ejemplo, '15'). Opcional, por defecto 15 segundos

• vm_clone - Clonar una VirtualMachine en KubeVirt creando un recurso VirtualMachineClone. Esto crea una copia de la VM de origen con un nuevo nombre usando la API de clonación de KubeVirt

  • name (string) (obligatorio) - El nombre de la máquina virtual de origen a clonar
  • namespace (string) (obligatorio) - El namespace de la máquina virtual de origen
  • targetName (string) (obligatorio) - El nombre para la nueva máquina virtual clonada

• vm_console_screenshot - Capturar una captura de pantalla de la consola gráfica (VNC) de una VirtualMachine en KubeVirt como imagen PNG. Use esto para ver lo que se muestra actualmente en la pantalla de la VM (por ejemplo, firmware, un cargador de arranque o un prompt de inicio de sesión). Solo lectura: nunca envía entrada al invitado.

  • name (string) (obligatorio) - El nombre de la máquina virtual
  • namespace (string) (obligatorio) - El namespace de la máquina virtual

• vm_create - Crea una VirtualMachine en KubeVirt con la configuración especificada, resolviendo automáticamente tipos de instancia, preferencias e imágenes de disco contenedor. La VM se creará en estado Halted por defecto; usa el parámetro autostart para iniciarla inmediatamente.

  • autostart (boolean) - Indicador opcional para iniciar automáticamente la VM después de su creación (establece runStrategy en Always en lugar de Halted). El valor predeterminado es false.
  • instancetype (string) - Nombre opcional del tipo de instancia para la VM (p. ej., 'u1.small', 'u1.medium', 'u1.large')
  • name (string) (obligatorio) - El nombre de la máquina virtual
  • namespace (string) (obligatorio) - El namespace de la máquina virtual
  • networks (array) - Interfaces de red secundarias opcionales para adjuntar a la VM. Cada elemento especifica una Multus NetworkAttachmentDefinition para adjuntar. Acepta cadenas simples (nombres de NetworkAttachmentDefinition) u objetos con propiedades 'name' (nombre de la interfaz en la VM) y 'networkName' (nombre de la NetworkAttachmentDefinition). Cada red crea una interfaz bridge en la VM.
  • performance (string) - Sugerencia opcional de familia de rendimiento para el tipo de instancia de la VM (p. ej., 'u1' para propósito general, 'o1' para sobrecomprometido, 'c1' para optimizado en cómputo, 'm1' para optimizado en memoria). El valor predeterminado es 'u1' (propósito general) si no se especifica.
  • preference (string) - Nombre opcional de preferencia para la VM
  • size (string) - Sugerencia opcional de tamaño de carga de trabajo para la VM (p. ej., 'small', 'medium', 'large', 'xlarge'). Se usa para seleccionar automáticamente un tipo de instancia apropiado si no se especifica explícitamente.
  • storage (string) - Tamaño de almacenamiento opcional para el disco raíz de la VM al usar DataSources (p. ej., '30Gi', '50Gi', '100Gi'). El valor predeterminado es 30Gi. Se ignora al usar discos contenedor.
  • workload (string) - La carga de trabajo para la VM. Acepta nombres de sistemas operativos (p. ej., 'fedora' (predeterminado), 'ubuntu', 'centos', 'centos-stream', 'debian', 'rhel', 'opensuse', 'opensuse-tumbleweed', 'opensuse-leap') o URLs completas de imágenes de disco contenedor

• vm_guest_info - Obtiene información del sistema operativo invitado desde el agente invitado QEMU de una VirtualMachine. Requiere que el agente invitado esté instalado y ejecutándose dentro de la VM. Proporciona información detallada sobre el sistema operativo, sistemas de archivos, interfaces de red y usuarios conectados.

  • info_type (string) - Tipo de información a recuperar: 'all' (predeterminado: toda la información disponible), 'os' (detalles del sistema operativo), 'filesystem' (información de disco y sistemas de archivos), 'users' (usuarios conectados), 'network' (interfaces de red e IPs)
  • name (string) (obligatorio) - El nombre de la máquina virtual
  • namespace (string) (obligatorio) - El namespace de la máquina virtual

• vm_lifecycle - Gestiona el ciclo de vida de la VirtualMachine de KubeVirt: iniciar, detener, reiniciar, pausar o reanudar una VM

  • action (string) (obligatorio) - La acción de ciclo de vida a realizar: 'start' (cambia runStrategy a Always), 'stop' (cambia runStrategy a Halted), 'restart' (detiene y luego inicia la VM), 'pause' (suspende la VMI en ejecución en su lugar) o 'unpause' (reanuda una VMI pausada)
  • name (string) (obligatorio) - El nombre de la máquina virtual
  • namespace (string) (obligatorio) - El namespace de la máquina virtual

• vm_create_from_template - Crea una VirtualMachine a partir de una VirtualMachineTemplate (virt-template) en KubeVirt. Procesa la plantilla en el servidor para sustituir parámetros (valores obligatorios, valores predeterminados y valores generados automáticamente como contraseñas), y luego crea la VirtualMachine resultante en el mismo namespace. No se admite el uso de plantillas entre namespaces.

  • namespace (string) (obligatorio) - El namespace de la VirtualMachineTemplate y de la VirtualMachine resultante (deben ser el mismo)
  • parameters (object) - Valores de parámetros para sustituir en la plantilla. Las claves son nombres de parámetros (p. ej., VM_NAME), los valores son cadenas. Los parámetros obligatorios deben proporcionarse; los parámetros opcionales usan sus valores predeterminados si se omiten; los parámetros con generate/from se generarán automáticamente si no se proporcionan.
  • template_name (string) (obligatorio) - El nombre de la VirtualMachineTemplate desde la cual crear la VM

• vm_troubleshoot - Diagnostica problemas de la VirtualMachine de KubeVirt con detección automatizada de causa raíz. Recopila el estado de la VM, el estado de la VMI, volúmenes, estado de DataVolume/PVC, configuración de cloud-init, estado del pod, registros y eventos, y luego ejecuta comprobaciones heurísticas para identificar problemas específicos y sugerir correcciones. Devuelve una sección 'Detected Issues' con hallazgos CRITICAL/WARNING y pasos de remediación accionables, seguida de datos de diagnóstico sin procesar. Usa esta herramienta PRIMERO siempre que un usuario pregunte por qué una VM no se inicia, está atascada en Provisioning, en crashloop, falla al migrar o muestra comportamiento inesperado. Detecta automáticamente: StorageClasses faltantes, especificaciones de PVC inválidas, comandos peligrosos de cloud-init (shutdown/halt), bloqueadores de migración por nodeSelector, migraciones fallidas y crashloops de pods. Si el usuario pide corregir o remediar el problema, usa las Suggested Fixes del informe con vm_lifecycle (restart) o resources_create_or_update.

  • name (string) (obligatorio) - El nombre de la VirtualMachine a diagnosticar
  • namespace (string) (obligatorio) - El namespace de la VirtualMachine a diagnosticar

• netobserv_list_flows - Lista los registros de flujo de red NetObserv desde Loki. Úsalo al investigar tráfico entre cargas de trabajo, IPs, puertos o protocolos en un namespace o ventana de tiempo.
  • endTime (integer) - Fin del rango de tiempo como segundos de época Unix. El valor predeterminado es ahora.
  • filters (string) - Expresión de filtro de NetObserv pasada al plugin de consola (texto plano; el cliente la codifica en URL).

Sintaxis:

• key=value — coincidencia exacta; key=a,b — OR de múltiples valores para la misma clave
• key~pattern — coincidencia por regex / contiene; key!~pattern — NO regex
• key!=value — no igual; key>number — numérico mayor o igual (p. ej., Bytes>1000)
• AND dentro de un grupo: & (p. ej., SrcK8S_Namespace=default&Proto=6)
• OR entre grupos: | (p. ej., SrcK8S_Name=pod-a|SrcK8S_Name=pod-b)

Prefiere el parámetro dedicado "namespace" para el alcance por namespace cuando sea posible. Usa las herramientas de listado de Kubernetes (namespaces, pods, deployments, etc.) para descubrir valores de filtro.

Campos comunes de Kubernetes (los prefijos Src/Dst se reflejan entre sí):

• SrcK8S_Namespace, DstK8S_Namespace, SrcK8S_Name, DstK8S_Name
• SrcK8S_Type, DstK8S_Type (p. ej., Pod, Service, Node)
• SrcK8S_OwnerName, DstK8S_OwnerName, SrcK8S_OwnerType, DstK8S_OwnerType (para Deployment, StatefulSet, etc.)
• SrcK8S_HostName, DstK8S_HostName, SrcK8S_Zone, DstK8S_Zone, K8S_ClusterName, UDN

Red y flujo:

• SrcAddr, DstAddr (IPs), SrcPort, DstPort, Proto (número IANA, p. ej., 6=TCP, 17=UDP)
• FlowDirection (0=Ingress, 1=Egress, 2=Inner), Bytes, Packets, Dscp, Flags

Pérdida de paquetes (a menudo con recordType flowLog y packetLoss dropped/hasDrops):

• PktDropPackets, PktDropBytes, PktDropLatestState, PktDropLatestDropCause

DNS:

• DnsName, DnsId, DnsLatencyMs, DnsErrno, DnsFlagsResponseCode

Ejemplos:

• SrcK8S_Namespace=openshift-netobserv&SrcK8S_Name~my-app

• Proto=6&DstPort=443

• SrcK8S_Name=pod-a|SrcK8S_Name=pod-b

  • limit (integer) - Número máximo de registros de flujo a devolver. El valor predeterminado es 100.
  • namespace (string) - Restringe los resultados a flujos donde el namespace de origen o destino coincida (tenant de Loki con alcance de desarrollo).
  • packetLoss (string) - Filtro de pérdida de paquetes.
  • recordType (string) - Filtro de tipo de registro de flujo.
  • startTime (integer) - Inicio del rango de tiempo como segundos de época Unix. Anula timeRange cuando se establece.
  • timeRange (integer) - Ventana de retroceso en segundos cuando se omite startTime. El valor predeterminado es 300.

• netobserv_export_flows - Exporta registros de flujo de NetObserv como CSV con los mismos filtros que list_flows. Úsalo cuando el usuario necesite datos de flujo descargables para auditorías o análisis sin conexión.

  • columns (string) - Nombres de columnas opcionales separados por comas para incluir (p. ej., SrcK8S_Namespace,DstK8S_Namespace,Bytes). Omítelo para exportar todas las columnas presentes en el resultado.
  • endTime (integer) - Fin del rango de tiempo como segundos de época Unix. El valor predeterminado es ahora.
  • filters (string) - Expresión de filtro de NetObserv pasada al plugin de consola (texto plano; el cliente la codifica en URL).

Sintaxis:

• key=value — coincidencia exacta; key=a,b — OR de múltiples valores para la misma clave
• key~pattern — coincidencia por regex / contiene; key!~pattern — NO regex
• key!=value — no igual; key>number — numérico mayor o igual (p. ej., Bytes>1000)
• AND dentro de un grupo: & (p. ej., SrcK8S_Namespace=default&Proto=6)
• OR entre grupos: | (p. ej., SrcK8S_Name=pod-a|SrcK8S_Name=pod-b)

Prefiere el parámetro dedicado "namespace" para el alcance por namespace cuando sea posible. Usa las herramientas de listado de Kubernetes (namespaces, pods, deployments, etc.) para descubrir valores de filtro.

Campos comunes de Kubernetes (los prefijos Src/Dst se reflejan entre sí):

• SrcK8S_Namespace, DstK8S_Namespace, SrcK8S_Name, DstK8S_Name
• SrcK8S_Type, DstK8S_Type (p. ej., Pod, Service, Node)
• SrcK8S_OwnerName, DstK8S_OwnerName, SrcK8S_OwnerType, DstK8S_OwnerType (para Deployment, StatefulSet, etc.)
• SrcK8S_HostName, DstK8S_HostName, SrcK8S_Zone, DstK8S_Zone, K8S_ClusterName, UDN

Red y flujo:

• SrcAddr, DstAddr (IPs), SrcPort, DstPort, Proto (número IANA, p. ej., 6=TCP, 17=UDP)
• FlowDirection (0=Ingress, 1=Egress, 2=Inner), Bytes, Packets, Dscp, Flags

Pérdida de paquetes (a menudo con recordType flowLog y packetLoss dropped/hasDrops):

• PktDropPackets, PktDropBytes, PktDropLatestState, PktDropLatestDropCause

DNS:

• DnsName, DnsId, DnsLatencyMs, DnsErrno, DnsFlagsResponseCode

Ejemplos:

• SrcK8S_Namespace=openshift-netobserv&SrcK8S_Name~my-app

• Proto=6&DstPort=443

• SrcK8S_Name=pod-a|SrcK8S_Name=pod-b

  • format (string) - Formato de exportación. Solo se admite csv.
  • limit (integer) - Número máximo de registros de flujo a devolver. El valor predeterminado es 100.
  • namespace (string) - Restringe los resultados a flujos donde el namespace de origen o destino coincida (tenant de Loki con alcance de desarrollo).
  • packetLoss (string) - Filtro de pérdida de paquetes.
  • recordType (string) - Filtro de tipo de registro de flujo.
  • startTime (integer) - Inicio del rango de tiempo como segundos de época Unix. Anula timeRange cuando se establece.
  • timeRange (integer) - Ventana de retroceso en segundos cuando se omite startTime. El valor predeterminado es 300.

• netobserv_get_flow_metrics - Devuelve métricas de flujo de NetObserv agregadas como datos de topología o series temporales. Úsalo para rendimiento, desgloses de TLS/DNS/pérdidas y análisis de tráfico por namespace o carga de trabajo; consulta aggregateBy y groups para opciones de agrupación.

  • aggregateBy (string) (obligatorio) - Dimensión principal para netobserv_get_flow_metrics (plugin de consola /api/flow/metrics).

Dos formas (usa la ortografía exacta):

1. Ámbitos de topología — agregan endpoints para vistas de grafo/topología:

• app — cargas de trabajo de aplicación (pods/services), excluyendo tráfico de infraestructura
• namespace — namespace de Kubernetes (predeterminado)
• owner — controlador propietario (Deployment, StatefulSet, …)
• resource — pod, service o node (granularidad de carga de trabajo más fina)
• host — nombre del nodo
• zone — zona de disponibilidad
• cluster — nombre del clúster (multi-clúster)
• network — nombre de red definida por el usuario / secundaria

2. Campos de registro de flujo — agrupa por un único atributo de flujo (nombre de campo en PascalCase). Úsalo para gráficos de desglose (TLS, DNS, pérdidas, protocolo). Los nombres de campo coinciden con los filtros / registros de flujo.

TLS (requiere seguimiento de TLS en el FlowCollector):

• TLSVersion, TLSCipherSuite, TLSGroup, TLSTypes

DNS:

• DnsName, DnsFlagsResponseCode, DnsErrno

Caídas de paquetes:

• PktDropLatestState, PktDropLatestDropCause

Red / K8s (desglose de un solo lado; combinar con filtros para src/dst):

• Proto, SrcPort, DstPort, FlowDirection, Dscp
• SrcK8S_Namespace, DstK8S_Namespace, SrcK8S_Name, DstK8S_Name
• SrcK8S_Type, DstK8S_Type, SrcK8S_OwnerName, DstK8S_OwnerName
• SrcK8S_HostName, DstK8S_HostName, SrcK8S_Zone, DstK8S_Zone
• K8S_ClusterName, SrcK8S_NetworkName, DstK8S_NetworkName

Combina aggregateBy con type y function:

• Throughput: type=Bytes o Packets, function=rate
• Conteo de flujos: type=Flows, function=count o rate
• Volumen de DNS: type=DnsFlows, function=count
• Latencia de DNS: type=DnsLatencyMs, function=avg, p90 o max
• RTT: type=TimeFlowRttNs, function=avg, min o p90
• Caídas: type=PktDropPackets o PktDropBytes, function=rate

Ejemplos:

• aggregateBy=namespace, type=Bytes, function=rate
• aggregateBy=TLSVersion, type=Bytes, function=rate, filters=TLSTypes!~""
• aggregateBy=TLSGroup, type=Flows, function=count
• aggregateBy=DnsFlagsResponseCode, type=DnsFlows, function=count
• aggregateBy=PktDropLatestState, type=PktDropPackets, function=rate, packetLoss=dropped
• aggregateBy=resource, type=Bytes, function=rate, namespace=netobserv
  • dataSource (string) - Backend de métricas: auto (prefiere Prometheus, con respaldo a Loki), prom o loki.
  • endTime (integer) - Fin del rango de tiempo en segundos de época Unix. Por defecto, ahora.
  • filters (string) - Expresión de filtro de NetObserv pasada al plugin de consola (texto plano; el cliente la codifica en URL).

Sintaxis:

• key=value — coincidencia exacta; key=a,b — OR de múltiples valores para la misma clave
• key~pattern — coincidencia regex / contiene; key!~pattern — NOT regex
• key!=value — no igual; key>number — numérico mayor o igual (p. ej., Bytes>1000)
• AND dentro de un grupo: & (p. ej., SrcK8S_Namespace=default&Proto=6)
• OR entre grupos: | (p. ej., SrcK8S_Name=pod-a|SrcK8S_Name=pod-b)

Prefiere el parámetro dedicado "namespace" para el alcance por namespace cuando sea posible. Usa las herramientas de listado de Kubernetes (namespaces, pods, deployments, etc.) para descubrir valores de filtro.

Campos comunes de Kubernetes (los prefijos Src/Dst se reflejan entre sí):

• SrcK8S_Namespace, DstK8S_Namespace, SrcK8S_Name, DstK8S_Name
• SrcK8S_Type, DstK8S_Type (p. ej., Pod, Service, Node)
• SrcK8S_OwnerName, DstK8S_OwnerName, SrcK8S_OwnerType, DstK8S_OwnerType (para Deployment, StatefulSet, etc.)
• SrcK8S_HostName, DstK8S_HostName, SrcK8S_Zone, DstK8S_Zone, K8S_ClusterName, UDN

Red y flujo:

• SrcAddr, DstAddr (IPs), SrcPort, DstPort, Proto (número IANA, p. ej., 6=TCP, 17=UDP)
• FlowDirection (0=Ingress, 1=Egress, 2=Inner), Bytes, Packets, Dscp, Flags

Caídas de paquetes (a menudo con recordType flowLog y packetLoss dropped/hasDrops):

• PktDropPackets, PktDropBytes, PktDropLatestState, PktDropLatestDropCause

DNS:

• DnsName, DnsId, DnsLatencyMs, DnsErrno, DnsFlagsResponseCode

Ejemplos:

• SrcK8S_Namespace=openshift-netobserv&SrcK8S_Name~my-app
• Proto=6&DstPort=443
• SrcK8S_Name=pod-a|SrcK8S_Name=pod-b
  • function (string) - Función de agregación.
  • groups (string) - Alcances principales opcionales separados por comas cuando aggregateBy es un alcance de topología. Añade dimensiones de etiqueta adicionales (p. ej., desglosar resultados de namespace por clúster o zona). Se ignora o es menos útil cuando aggregateBy ya es un campo de flujo sin procesar (p. ej., TLSVersion); usa filtros en su lugar.

Alcances individuales:

• clusters, networks, zones, hosts, namespaces, owners

Alcances combinados (usa +, sin espacios):

• clusters+zones, clusters+hosts, clusters+namespaces, clusters+owners
• zones+hosts, zones+namespaces, zones+owners
• hosts+namespaces, hosts+owners
• namespaces+owners
• networks+zones, networks+hosts, networks+namespaces, networks+owners

Ejemplos:

• aggregateBy=namespace, groups=clusters
• aggregateBy=resource, groups=namespaces
• aggregateBy=owner, groups=zones,hosts
  • limit (integer) - Número máximo de registros de flujo a devolver. Por defecto, 100.
  • namespace (string) - Restringe los resultados a flujos donde el namespace de origen o destino coincide (tenant de Loki con alcance de desarrollo).
  • packetLoss (string) - Filtro de pérdida de paquetes.
  • rateInterval (string) - Intervalo de tasa de Prometheus (p. ej., 1m, 5m).
  • recordType (string) - Filtro de tipo de registro de flujo.
  • startTime (integer) - Inicio del rango de tiempo en segundos de época Unix. Anula timeRange cuando se establece.
  • step (string) - Paso de resolución de consulta (p. ej., 30s, 1m).
  • timeRange (integer) - Ventana de retroceso en segundos cuando se omite startTime. Por defecto, 300.
  • type (string) - Tipo de métrica a agregar.

• loki_list_instances - Lista las instancias de LokiStack disponibles en el clúster de Kubernetes. Llama a esto primero cuando uses stacks gestionados por Loki Operator para poder pasar lokiNamespace y lokiName a otras herramientas de Loki.

• loki_label_names - Lista los nombres de etiquetas de Loki disponibles para un rango de tiempo. Usa esto antes de escribir consultas LogQL.

  • end (string) - Hora de fin como RFC3339, marca de tiempo Unix, NOW o expresión relativa a NOW (opcional).
  • lokiName (string) - Nombre del LokiStack. Usa loki_list_instances para descubrir valores válidos.
  • lokiNamespace (string) - Namespace de Kubernetes del LokiStack. Usa loki_list_instances para descubrir valores válidos.
  • start (string) - Hora de inicio como RFC3339, marca de tiempo Unix, NOW o expresión relativa a NOW (opcional).
  • tenant (string) - ID de tenant de Loki (X-Scope-OrgID). Para modos de puerta de enlace de LokiStack (p. ej., openshift-network) esto selecciona la ruta /api/logs/v1/<tenant>; usa network para openshift-network.

• loki_label_values - Lista los valores posibles para una clave de etiqueta de Loki. Usa esto para construir coincidencias de etiquetas precisas en LogQL.

  • end (string) - Hora de fin como RFC3339, marca de tiempo Unix, NOW o expresión relativa a NOW (opcional).
  • label (string) (obligatorio) - Clave de etiqueta a inspeccionar (por ejemplo, namespace, pod, container).
  • lokiName (string) - Nombre del LokiStack. Usa loki_list_instances para descubrir valores válidos.
  • lokiNamespace (string) - Namespace de Kubernetes del LokiStack. Usa loki_list_instances para descubrir valores válidos.
  • start (string) - Hora de inicio como RFC3339, marca de tiempo Unix, NOW o expresión relativa a NOW (opcional).
  • tenant (string) - ID de tenant de Loki (X-Scope-OrgID). Para modos de puerta de enlace de LokiStack (p. ej., openshift-network) esto selecciona la ruta /api/logs/v1/<tenant>; usa network para openshift-network.

• loki_query_range - Ejecuta una consulta de rango LogQL de Loki y devuelve los flujos y líneas de registro coincidentes.

Usa primero coincidencias de etiquetas precisas y una ventana de tiempo corta.

• direction (string) - Dirección de búsqueda: backward (por defecto) o forward.
• duration (string) - Duración de retroceso desde ahora cuando se omiten start/end (por ejemplo, 5m, 1h). Por defecto, 15m.
• end (string) - Hora de fin como RFC3339, marca de tiempo Unix, NOW o expresión relativa a NOW (opcional).
• limit (integer) - Número máximo de líneas de registro a devolver. Por defecto, 100, máximo 1000.
• lokiName (string) - Nombre del LokiStack. Usa loki_list_instances para descubrir valores válidos.
• lokiNamespace (string) - Namespace de Kubernetes del LokiStack. Usa loki_list_instances para descubrir valores válidos.
• query (string) (obligatorio) - Cadena de consulta LogQL.
• start (string) - Hora de inicio como RFC3339, marca de tiempo Unix, NOW o expresión relativa a NOW (opcional).
• tenant (string) - ID de tenant de Loki (X-Scope-OrgID). Para modos de puerta de enlace de LokiStack (p. ej., openshift-network) esto selecciona la ruta /api/logs/v1/<tenant>; usa network para openshift-network.

• list_metrics - PASO INICIAL OBLIGATORIO: Lista todos los nombres de métricas disponibles en Prometheus.

DEBES LLAMAR A ESTA HERRAMIENTA ANTES QUE CUALQUIER OTRA HERRAMIENTA DE CONSULTA

Esta herramienta DEBE llamarse primero para CADA pregunta de observabilidad para:

1. Descubrir qué métricas existen realmente en este entorno
2. Encontrar el nombre EXACTO de la métrica para usar en las consultas
3. Evitar consultar métricas inexistentes
4. El parámetro 'name_regex' siempre debe proporcionarse y ser una mejor suposición de cómo se llamaría la métrica.
5. No uses un regex genérico como .* o .+ en el parámetro 'name_regex'. Usa específicos como kube., node., etc.

GUÍA DE PATRONES REGEX:

• Las métricas de Prometheus suelen tener prefijos (p. ej., 'prometheus_tsdb_head_series', 'kube_pod_status_phase')
• Para coincidir métricas que CONTIENEN una subcadena, usa comodines: '.tsdb.' coincide con 'prometheus_tsdb_head_series'
• Sin comodines, el patrón coincide EXACTAMENTE: 'tsdb' solo coincide con una métrica literalmente llamada 'tsdb' (que rara vez existe)
• Patrones comunes: 'kube_pod.' (pods), '.memory.' (relacionado con memoria), 'node_.' (métricas de nodo)
• Si obtienes resultados vacíos, intenta añadir '.*' antes/después de tu término de búsqueda

NUNCA omitas este paso. NUNCA adivines nombres de métricas. Los nombres de métricas varían entre entornos.

Después de llamar a esta herramienta:

1. Busca en la lista devuelta las métricas relevantes
2. Usa el nombre EXACTO de la métrica encontrada en consultas posteriores
3. Si no existe una métrica relevante, informa al usuario

• name_regex (string) (obligatorio) - Patrón regex para filtrar nombres de métricas. IMPORTANTE: Los nombres de métricas suelen tener prefijos (p. ej., 'prometheus_tsdb_head_series'). Usa comodines para coincidir subcadenas: '.tsdb.' coincide con cualquier métrica que contenga 'tsdb', mientras que 'tsdb' solo coincide con la cadena exacta 'tsdb'. Ejemplos: 'http_.' (empieza con http_), '.memory.' (contiene memory), 'node_.' (empieza con node_). Este parámetro es obligatorio. No pases regex genéricos como '.*' o '.+'.

• execute_instant_query - Ejecuta una consulta instantánea PromQL para obtener valores actuales/puntuales.

PRERREQUISITO: DEBES llamar a list_metrics primero para verificar que la métrica existe

CUÁNDO USAR:

• Preguntas de estado actual: "¿Cuál es la tasa de error actual?"
• Instantáneas puntuales: "¿Cuántos pods están en ejecución?"
• Valores más recientes: "¿Qué pods están en estado Pending?"

El parámetro 'query' DEBE usar nombres de métricas devueltos por list_metrics.

• query (string) (obligatorio) - Cadena de consulta PromQL usando nombres de métricas verificados mediante list_metrics

• time (string) - Hora de evaluación como RFC3339 o marca de tiempo Unix. Omite o usa 'NOW' para la hora actual.

• execute_range_query - Ejecuta una consulta de rango PromQL para obtener datos de series temporales durante un período.

PRERREQUISITO: DEBES llamar a list_metrics primero para verificar que la métrica existe

CUÁNDO USAR:

• Tendencias a lo largo del tiempo: "¿Cuál fue el uso de CPU durante la última hora?"
• Cálculos de tasa: "¿Cuántas solicitudes por segundo?"
• Análisis histórico: "¿Hubo reinicios en los últimos 5 minutos?"

PARÁMETROS DE TIEMPO:

• 'duration': Retroceso desde ahora (p. ej., "5m", "1h", "24h")

• 'step': Resolución de puntos de datos (p. ej., "1m" para duración de 1 hora, "5m" para duración de 24 horas) El parámetro 'query' DEBE usar nombres de métricas que fueron devueltos por list_metrics.

  • duration (string) - Duración para mirar hacia atrás desde ahora (ej., '1h', '30m', '1d', '2w') (opcional)
  • end (string) - Tiempo final como RFC3339 o timestamp Unix (opcional). Use NOW para el tiempo actual.
  • query (string) (requerido) - Cadena de consulta PromQL usando nombres de métricas verificados a través de list_metrics
  • start (string) - Tiempo inicial como RFC3339 o timestamp Unix (opcional)
  • step (string) (requerido) - Ancho del paso de resolución de consulta (ej., '15s', '1m', '1h'). Elija según el rango de tiempo: rangos más cortos usan pasos más pequeños.

• show_timeseries - Muestra los resultados como un gráfico de series temporales interactivo.

Esta herramienta funciona como execute_range_query pero renderiza los resultados como un gráfico visual en los clientes de UI. Úsela cuando el usuario quiera ver un gráfico o visualización de datos de series temporales y usar visuales para proporcionar la respuesta. Use show_timeseries como la última llamada de herramienta después de que todas las demás llamadas de herramientas de Prometheus estén finalizadas.

PARÁMETROS DE TIEMPO:

• 'duration': Mirar hacia atrás desde ahora (ej., "5m", "1h", "24h")
• 'step': Resolución de puntos de datos (ej., "1m" para duración de 1 hora, "5m" para duración de 24 horas)
• 'title': Un título descriptivo del gráfico (ej., "Tasa de Errores de API en la Última Hora")
• 'description': Una explicación del significado o contexto del gráfico (ej., "Muestra la tasa de errores HTTP 5xx por segundo, desglosada por pod")

El parámetro 'query' DEBE ser una consulta de rango y debe usar nombres de métricas que fueron devueltos por list_metrics.

• description (string) - Explicación del significado o contexto del gráfico (ej., 'Muestra la tasa de errores HTTP 5xx por segundo, desglosada por pod'). Se muestra debajo del título cuando se proporciona.

• duration (string) - Duración para mirar hacia atrás desde ahora (ej., '1h', '30m', '1d', '2w') (opcional)

• end (string) - Tiempo final como RFC3339 o timestamp Unix (opcional). Use NOW para el tiempo actual.

• query (string) (requerido) - Cadena de consulta PromQL usando nombres de métricas verificados a través de list_metrics

• start (string) - Tiempo inicial como RFC3339 o timestamp Unix (opcional)

• step (string) (requerido) - Ancho del paso de resolución de consulta (ej., '15s', '1m', '1h'). Elija según el rango de tiempo: rangos más cortos usan pasos más pequeños.

• title (string) - Título legible del gráfico que describe lo que muestra la consulta (ej., 'Tasa de Errores de API en la Última Hora'). Se muestra encima del gráfico cuando se proporciona.

• get_label_names - Obtener todos los nombres de etiquetas (dimensiones) disponibles para filtrar una métrica.

CUÁNDO USAR (después de llamar a list_metrics):

• Para descubrir cómo filtrar métricas (por namespace, pod, servicio, etc.)
• Antes de construir matchers de etiquetas en consultas PromQL

El parámetro 'metric' debe usar un nombre de métrica de la salida de list_metrics.

• end (string) - Tiempo final para el descubrimiento de etiquetas como RFC3339 o timestamp Unix (opcional, por defecto ahora)

• metric (string) - Nombre de la métrica (de list_metrics) para obtener nombres de etiquetas. Déjelo vacío para todas las métricas.

• start (string) - Tiempo inicial para el descubrimiento de etiquetas como RFC3339 o timestamp Unix (opcional, por defecto hace 1 hora)

• get_label_values - Obtener todos los valores únicos para una etiqueta específica.

CUÁNDO USAR (después de llamar a list_metrics y get_label_names):

• Para encontrar valores exactos de etiquetas para filtrar (nombres de namespace, nombres de pod, etc.)
• Para ver qué valores existen antes de construir consultas

El parámetro 'metric' debe usar un nombre de métrica de la salida de list_metrics.

• end (string) - Tiempo final para el descubrimiento de valores de etiquetas como RFC3339 o timestamp Unix (opcional, por defecto ahora)

• label (string) (requerido) - Nombre de la etiqueta (de get_label_names) para obtener valores

• metric (string) - Nombre de la métrica (de list_metrics) para limitar los valores de etiquetas. Déjelo vacío para todas las métricas.

• start (string) - Tiempo inicial para el descubrimiento de valores de etiquetas como RFC3339 o timestamp Unix (opcional, por defecto hace 1 hora)

• get_series - Obtener series temporales que coincidan con selectores y previsualizar cardinalidad.

CUÁNDO USAR (opcional, después de llamar a list_metrics):

• Para verificar que los filtros de etiquetas coincidan con las series esperadas antes de consultar
• Para comprobar la cardinalidad y evitar consultas lentas

GUÍA DE CARDINALIDAD:

• <100 series: Seguro
• 100-1000: Generalmente bien

• 1000: Agregue más filtros de etiquetas

El selector debe usar nombres de métricas de la salida de list_metrics.

• end (string) - Tiempo final para el descubrimiento de series como RFC3339 o timestamp Unix (opcional, por defecto ahora)

• matches (string) (requerido) - Selector de series PromQL usando nombres de métricas de list_metrics

• start (string) - Tiempo inicial para el descubrimiento de series como RFC3339 o timestamp Unix (opcional, por defecto hace 1 hora)

• get_alerts - Obtener alertas de Alertmanager.

CUÁNDO USAR:

• EMPIECE AQUÍ al investigar problemas: si el usuario pregunta sobre cosas que se rompen, errores, fallos, interrupciones, servicios caídos, o cualquier cosa que vaya mal en el clúster
• Cuando el usuario mencione un nombre de alerta específico - use esta herramienta para obtener las etiquetas completas de la alerta (namespace, pod, servicio, etc.) que son esenciales para una investigación adicional con otras herramientas
• Para ver alertas actualmente activas en el clúster
• Para comprobar qué alertas están activas, silenciadas o inhibidas
• Para entender qué está sucediendo antes de profundizar en métricas o registros

CONSEJO DE INVESTIGACIÓN: Las etiquetas de alerta a menudo contienen los identificadores exactos (nombres de pod, namespaces, nombres de trabajo) necesarios para consultas dirigidas con herramientas de Prometheus.

FILTRADO:

• Use 'active' para filtrar solo alertas activas (no resueltas)
• Use 'silenced' para filtrar alertas silenciadas
• Use 'inhibited' para filtrar alertas inhibidas
• Use 'filter' para aplicar matchers de etiquetas (ej., "alertname=HighCPU")
• Use 'receiver' para filtrar alertas por nombre de receptor

Todos los parámetros de filtro son opcionales. Sin filtros, se devuelven todas las alertas.

• active (boolean) - Filtrar solo alertas activas (true/false, opcional)

• filter (string) - Matchers de etiquetas para filtrar alertas (ej., 'alertname=HighCPU', opcional)

• inhibited (boolean) - Filtrar solo alertas inhibidas (true/false, opcional)

• receiver (string) - Nombre del receptor para filtrar alertas (opcional)

• silenced (boolean) - Filtrar solo alertas silenciadas (true/false, opcional)

• unprocessed (boolean) - Filtrar solo alertas no procesadas (true/false, opcional)

• get_silences - Obtener silencios de Alertmanager.

CUÁNDO USAR:

• Para ver qué alertas están actualmente silenciadas
• Para comprobar silencios activos, pendientes o expirados
• Para investigar por qué ciertas alertas no están enviando notificaciones

FILTRADO:

• Use 'filter' para aplicar matchers de etiquetas para encontrar silencios específicos

Los silencios se usan para silenciar temporalmente alertas basadas en matchers de etiquetas. Esta herramienta le ayuda a entender qué está actualmente silenciado en su entorno.

• filter (string) - Matchers de etiquetas para filtrar silencios (ej., 'alertname=HighCPU', opcional)

• otelcol_list_components - Listar componentes disponibles del OpenTelemetry Collector (receptores, procesadores, exportadores, extensiones, conectores) para una versión dada.

  • version (string) - Versión del Collector (ej., 'v0.100.0'). Por defecto a la última disponible.

• otelcol_get_component_schema - Obtener el esquema JSON para las opciones de configuración de un componente del OpenTelemetry Collector.

  • component_name (string) (requerido) - Nombre del componente de otelcol_list_components (ej., 'otlp', 'batch', 'debug')
  • component_type (string) (requerido) - Tipo de componente: receiver, processor, exporter, extension, connector
  • version (string) - Versión del Collector (ej., 'v0.100.0'). Por defecto a la última disponible.

• otelcol_validate_config - Validar una configuración de componente del OpenTelemetry Collector contra su esquema JSON.

  • component_name (string) (requerido) - Nombre del componente de otelcol_list_components (ej., 'otlp', 'batch', 'debug')
  • component_type (string) (requerido) - Tipo de componente: receiver, processor, exporter, extension, connector
  • config (string) (requerido) - Configuración a validar como cadena YAML o JSON
  • format (string) - Formato de configuración: 'yaml' (por defecto) o 'json'
  • version (string) - Versión del Collector (ej., 'v0.100.0'). Por defecto a la última disponible.

• otelcol_get_versions - Listar versiones disponibles del OpenTelemetry Collector e identificar la última.

• tempo_list_instances - Listar todas las instancias de Tempo disponibles en el clúster de Kubernetes. Llame a esta herramienta primero para descubrir instancias de Tempo disponibles antes de usar otras herramientas de Tempo, ya que los valores de namespace, nombre y tenant devueltos son parámetros requeridos para todas las demás herramientas de Tempo. Siempre imprima la salida de esta herramienta en una tabla.

• tempo_get_trace_by_id - Recuperar un único trace distribuido por su ID de trace de Tempo. Devuelve el trace completo con todos sus spans, incluyendo nombres de servicio, nombres de operación, duraciones y atributos. Use esta herramienta cuando ya tenga un ID de trace específico, ej., de resultados de búsqueda o registros.

  • end (string) - Fin opcional del rango de tiempo en formato RFC 3339, ej., "2025-01-02T00:00:00Z". Reduce el rango de tiempo para mejorar el rendimiento de la consulta.
  • start (string) - Inicio opcional del rango de tiempo en formato RFC 3339, ej., "2025-01-01T00:00:00Z". Reduce el rango de tiempo para mejorar el rendimiento de la consulta.
  • tempoName (string) (requerido) - El nombre de la instancia de Tempo a consultar. Use tempo_list_instances para descubrir nombres de instancias disponibles.
  • tempoNamespace (string) (requerido) - El namespace de Kubernetes donde está desplegada la instancia de Tempo. Use tempo_list_instances para descubrir namespaces disponibles.
  • tenant (string) - El tenant a consultar. Este parámetro es requerido para instancias multi-tenant. Use tempo_list_instances para descubrir tenants disponibles para cada instancia.
  • traceid (string) (requerido) - El ID de trace a recuperar, ej., "26dad4a0e2b0dd9a440dd5ff203a24a4".

• tempo_search_traces - Buscar traces distribuidos en Tempo usando TraceQL. Use esta herramienta para encontrar traces que coincidan con criterios específicos como nombre de servicio, código de estado HTTP, duración, u otros atributos de span o recurso.

IMPORTANTE — Solicitudes de traces "lentos" o "largos": NO adivine un umbral de duración. Primero llame a esta herramienta SIN un filtro de duración para establecer una línea base de latencia, luego use esa línea base para establecer un umbral sensato. Ambos pasos son requeridos — NO omita la segunda búsqueda con el filtro de duración. Omita este proceso de dos pasos solo cuando el usuario proporcione una duración explícita (ej., "encontrar traces más lentos que 2s").

• end (string) - Fin del rango de tiempo en formato RFC 3339, ej., "2025-01-01T00:00:00Z". Use "NOW" para el tiempo actual. Tanto el inicio como el fin deben proporcionarse para buscar en el rango de tiempo completo; si se omiten, solo se busca una pequeña ventana de datos recientes.
• limit (integer) - Número máximo de traces a devolver. Por defecto al límite del lado del servidor si no se especifica.
• query (string) (requerido) - Una expresión de consulta TraceQL. Formato: query: "{ <filters joined by &&> }" Filtros:
• nombre del servicio: resource.service.name="" (cadena, use comillas)
• código de estado HTTP: span.http.response.status_code= (número, sin comillas)
• duración: duration><value like 100ms, 2s, 5m> (sin comillas)
• estado de error: status=error (palabra clave, SIN comillas — NO escriba status="error")