Referencia de Configuración

Wippy se configura mediante archivos .wippy.yaml. Todas las opciones tienen valores por defecto sensatos.

Gestor de Logs

Controla el enrutamiento de logs del runtime. La salida de consola se configura vía flags CLI (-v, -c, -s).

Campo Tipo Por Defecto Descripción
propagate_downstream bool true Enviar logs a salida de consola/archivo
stream_to_events bool false Publicar logs al bus de eventos para acceso programático
min_level int -1 Nivel mínimo: -1=debug, 0=info, 1=warn, 2=error 
logmanager:
  propagate_downstream: true
  stream_to_events: false
  min_level: 0

Ver: Módulo Logger

Profiler

Servidor HTTP de pprof de Go para perfilado de CPU/memoria. Habilitar con flag -p o configuración.

Campo Tipo Por Defecto Descripción
enabled bool false Iniciar servidor de profiler
address string localhost:6060 Dirección de escucha
read_timeout duration 15s Timeout de lectura HTTP
write_timeout duration 15s Timeout de escritura HTTP
idle_timeout duration 60s Timeout de keep-alive 
profiler:
  enabled: true
  address: "localhost:6060"

Acceder en http://localhost:6060/debug/pprof/

Seguridad

Comportamiento de seguridad global. Las políticas individuales se definen como entradas security.policy.

Campo Tipo Por Defecto Descripción
strict_mode bool false Denegar acceso cuando el contexto de seguridad está incompleto 
security:
  strict_mode: true

Ver: Sistema de Seguridad, Módulo Security

Registro

Almacenamiento de entradas e historial de versiones. El registro contiene todas las entradas de configuración.

Campo Tipo Por Defecto Descripción
enable_history bool true Rastrear versiones de entradas
history_type string memory Almacenamiento: memory, sqlite, nil
history_path string .wippy/registry.db Ruta del archivo SQLite 
registry:
  history_type: sqlite
  history_path: /var/lib/wippy/registry.db

Ver: Concepto de Registro, Módulo Registry

Relay

Enrutamiento de mensajes entre procesos a través de nodos.

Campo Tipo Por Defecto Descripción
node_name string local Identificador para este nodo relay 
relay:
  node_name: worker-1

Ver: Modelo de Procesos

Supervisor

Gestión del ciclo de vida de servicios. Controla cómo las entradas supervisadas inician/detienen.

Campo Tipo Por Defecto Descripción
host.buffer_size int 1024 Capacidad de cola de mensajes
host.worker_count int NumCPU Workers concurrentes 
supervisor:
  host:
    buffer_size: 2048
    worker_count: 32

Ver: Guía de Supervisión

Funciones

Host de ejecución de funciones. Ejecuta entradas function.lua.

Campo Tipo Por Defecto Descripción
host.buffer_size int 1024 Capacidad de cola de tareas
host.worker_count int NumCPU Workers concurrentes 
functions:
  host:
    buffer_size: 2048
    worker_count: 32

Ver: Concepto de Funciones, Módulo Funcs

Runtime de Lua

Caché de VM Lua y evaluación de expresiones.

Campo Tipo Por Defecto Descripción
proto_cache_size int 60000 Caché de prototipos compilados
main_cache_size int 10000 Caché de chunks principales
expr.cache_enabled bool true Cachear expresiones compiladas
expr.capacity int 5000 Tamaño de caché de expresiones
json.cache_enabled bool true Cachear esquemas JSON
json.capacity int 1000 Tamaño de caché JSON 
lua:
  proto_cache_size: 60000
  expr:
    cache_enabled: true
    capacity: 5000

Ver: Visión General de Lua

Finder

Caché de búsqueda del registro. Usado internamente para búsquedas de entradas.

Campo Tipo Por Defecto Descripción
query_cache_size int 1000 Resultados de consultas cacheados
regex_cache_size int 100 Patrones regex compilados 
finder:
  query_cache_size: 2000

OpenTelemetry

Trazado distribuido y exportación de métricas vía OTLP.

Campo Tipo Por Defecto Descripción
enabled bool false Habilitar OTEL
endpoint string localhost:4318 Endpoint OTLP
protocol string http/protobuf Protocolo: grpc, http/protobuf
service_name string wippy Identificador de servicio
sample_rate float 1.0 Muestreo de trazas (0.0-1.0)
traces_enabled bool false Exportar trazas
metrics_enabled bool false Exportar métricas
http.enabled bool true Trazar solicitudes HTTP
process.enabled bool true Trazar ciclo de vida de procesos
interceptor.enabled bool false Trazar llamadas de funciones 
otel:
  enabled: true
  endpoint: "http://jaeger:4318"
  traces_enabled: true
  process:
    trace_lifecycle: true

Ver: Guía de Observabilidad

Shutdown

Comportamiento de apagado graceful.

Campo Tipo Por Defecto Descripción
timeout duration 30s Espera máxima para que los componentes se detengan 
shutdown:
  timeout: 60s

Métricas

Buffer de recolección de métricas internas.

Campo Tipo Por Defecto Descripción
buffer.size int 10000 Capacidad del buffer de métricas
interceptor.enabled bool false Auto-rastrear llamadas de funciones 
metrics:
  buffer:
    size: 20000
  interceptor:
    enabled: true

Ver: Módulo Metrics, Guía de Observabilidad

Prometheus

Endpoint de métricas Prometheus.

Campo Tipo Por Defecto Descripción
enabled bool false Iniciar servidor de métricas
address string localhost:9090 Dirección de escucha 
prometheus:
  enabled: true
  address: "0.0.0.0:9090"

Expone endpoint /metrics para scraping de Prometheus.

Ver: Guía de Observabilidad

Cluster

Clustering multi-nodo con descubrimiento por gossip.

Campo Tipo Por Defecto Descripción
enabled bool false Habilitar clustering
name string hostname Identificador de nodo
internode.bind_addr string 0.0.0.0 Dirección de bind inter-nodo
internode.bind_port int 0 Puerto (0=auto 7950-7959)
membership.bind_port int 7946 Puerto de gossip
membership.join_addrs string Nodos semilla (separados por coma)
membership.secret_key string Clave de encriptación (base64)
membership.secret_file string Ruta del archivo de clave
membership.advertise_addr string Dirección pública para NAT 
cluster:
  enabled: true
  name: node-1
  membership:
    bind_port: 7946
    join_addrs: "10.0.0.1:7946,10.0.0.2:7946"
    secret_file: /etc/wippy/cluster.key

Ver: Guía de Cluster

Variables de Entorno

Variable Descripción
GOMEMLIMIT Límite de memoria (sobrescribe flag --memory-limit)

Ver También