Infrastructure Sessions
Real-time command captures from infrastructure work, converted to searchable documentation.
Workflow
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ infra-session │───▶│ tlog commands │───▶│ infra-session- │
│ <name> │ │ (auto-logged) │ │ end │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ attachments/ │ │ pages/sessions/ │
│ sessions/*.log │─────── convert ─────────▶│ *.adoc │
│ (raw output) │ │ (formatted) │
└─────────────────┘ └─────────────────┘Quick Start
# 1. Start session
infra-session 2026-02-26-wazuh-diag
# 2. Run commands (auto-logged)
tlog kubectl get pods -n wazuh
tlog netapi wazuh health
tlog ssh vault-01 "vault status"
# 3. End session
infra-session-endRaw Logs Location
domus-infra-ops/docs/asciidoc/modules/ROOT/
├── attachments/
│ └── sessions/ # Raw .log files (tee output)
│ ├── 2026-02-26-wazuh-diag.log
│ └── 2026-02-27-vault-troubleshoot.log
└── pages/
└── sessions/ # Converted .adoc (this section)
├── index.adoc
└── 2026-02-26-wazuh-diag.adocConverting Raw Logs to AsciiDoc
After a session, convert the raw log to a formatted page:
-
Copy the template:
cp template.adoc YYYY-MM-DD-<name>.adoc -
Open the raw log:
attachments/sessions/<name>.log -
Copy command blocks into
[source,bash]sections -
Add analysis, root cause, and outcome sections
-
Add to nav.adoc under Sessions
Session Types
| Type | Naming Convention | Example |
|---|---|---|
Troubleshooting |
|
|
Configuration |
|
|
Deployment |
|
|
Maintenance |
|
|
Investigation |
|
|
Related
-
Incidents - Active incident response
-
Root Cause Analysis - Post-incident analysis
-
Change Requests - Planned changes