Add in OS Docs

2026-09-26 21:18:04 +00:00 · 2018-04-16 11:22:27 -07:00
parent 73d40c5e94
commit 79e4fb76eb
70 changed files with 3797 additions and 148 deletions
@@ -0,0 +1,46 @@
+---
+tag: ["rancheros", "os", "logging"]
+category: "os"
+layout: list-docs
+title: System Logging
+weight: 153
+---
+
+## RancherOS System Logging
+
+### System services
+
+RancherOS uses containers for its system services. This means the logs for `syslog`, `acipd`, `system-cron`, `udev`, `network`, `ntp`, `console` and the user Docker are available using `sudo ros service logs <service-name>`.
+
+### Boot logging
+
+Since v1.1.0, the init process's logs are copied to `/var/log/boot` after the user-space filesystem is made available. These can be used to diagnose initialisation, network, and cloud-init issues.
+
+### Remote Syslog logging
+
+The Linux kernel has a `netconsole` logging facility that allows it to send the Kernel level logs to a remote Syslog server.
+When you set this kernel boot parameter in RancherOS v1.1.0 and later, the RancherOS debug logs will also be sent to it.
+
+To set up Linux kernel and RancherOS remote Syslog logging, you need to set both a local, and remote host IP address - even if this address isn't the final IP address of your system. The kernel setting looks like:
+
+```
+ netconsole=[+][src-port]@[src-ip]/[<dev>],[tgt-port]@<tgt-ip>/[tgt-macaddr]
+
+   where
+        +             if present, enable extended console support
+        src-port      source for UDP packets (defaults to 6665)
+        src-ip        source IP to use (interface address)
+        dev           network interface (eth0)
+        tgt-port      port for logging agent (6666)
+        tgt-ip        IP address for logging agent
+        tgt-macaddr   ethernet MAC address for logging agent (broadcast)
+```
+
+For example, on my current test system, I have set the kernel boot line to:
+
+
+```
+printk.devkmsg=on console=tty1 rancher.autologin=tty1 console=ttyS0 rancher.autologin=ttyS0    rancher.state.dev=LABEL=RANCHER_STATE rancher.state.autoformat=[/dev/sda,/dev/vda] rancher.rm_usr loglevel=8 netconsole=+9999@10.0.2.14/,514@192.168.42.223/
+```
+
+The kernel boot parameters can be set during installation using `sudo ros install --append "...."`, or on an installed RancherOS system,  by running `sudo ros config syslinx` (which will start vi in a container, editing the `global.cfg` boot config file.