Files
fn_registry/functions/infra/systemd_status.md
T
egutierrez cfdf515228 chore: auto-commit (799 archivos)
- .claude/CLAUDE.md
- .claude/commands/subagentes.md
- .claude/rules/INDEX.md
- .mcp.json
- bash/functions/cybersecurity/analyze_dns.md
- bash/functions/cybersecurity/audit_http_headers.md
- bash/functions/cybersecurity/audit_ssh_config.md
- bash/functions/cybersecurity/check_firewall.md
- bash/functions/cybersecurity/detect_suspicious_users.md
- bash/functions/cybersecurity/encrypt_file.md
- ...

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-14 00:28:20 +02:00

46 lines
1.4 KiB
Markdown

---
name: systemd_status
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func SystemdStatus(conn SSHConn, unitName string, logLines int) (SystemdServiceStatus, error)"
description: "Consulta el estado de un servicio systemd en un host remoto. Retorna estado activo, sub-estado, PID y logs recientes."
tags: [systemd, status, monitor, service, remote, pendiente-usar]
uses_functions: [ssh_exec_go_infra]
uses_types: [ssh_conn_go_infra]
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [fmt, strings]
params:
- name: conn
desc: "conexión SSH al host remoto"
- name: unitName
desc: "nombre del unit systemd a consultar (sin .service)"
- name: logLines
desc: "número de líneas de journalctl a incluir (0 para no incluir logs)"
output: "SystemdServiceStatus con Active, SubState, MainPID y Logs del servicio"
tested: false
tests: []
test_file_path: ""
file_path: "functions/infra/systemd_status.go"
---
## Ejemplo
```go
conn := SSHConn{Host: "192.168.1.100", User: "deploy"}
s, err := SystemdStatus(conn, "dag_engine", 20)
if err != nil {
log.Fatal(err)
}
fmt.Printf("State: %s/%s PID: %s\n", s.Active, s.SubState, s.MainPID)
fmt.Println(s.Logs)
```
## Notas
Usa `systemctl show` para obtener propiedades sin formato humano. Los logs se obtienen con journalctl y son opcionales (logLines=0 los omite). Si journalctl falla (ej: permisos), los logs quedan vacíos sin error.