update snclient docs

https://github.com/ConSol-Monitoring/snclient/actions/workflows/deploy-docs.yml

Author: github automation

content/en/docs/snclient/_index.md

@@ -12,24 +12,34 @@ tags:
   - osx
 ---
 
-<div class="pb-4">
-  <img src="logo/snclient.svg" alt="SNClient" width="200px" style="background-color: white"/>
-</div>
-
 [![CICD Pipeline](https://github.com/Consol-Monitoring/snclient/actions/workflows/builds.yml/badge.svg?branch=main)](https://github.com/Consol-Monitoring/snclient/actions/workflows/builds.yml)
 [![Go Report Card](https://goreportcard.com/badge/github.com/Consol-Monitoring/snclient)](https://goreportcard.com/report/github.com/Consol-Monitoring/snclient)
 [![Latest Release](https://img.shields.io/github/v/release/Consol-Monitoring/snclient?sort=semver)](https://github.com/Consol-Monitoring/snclient/releases)
 [![License](https://img.shields.io/github/license/Consol-Monitoring/snclient)](https://github.com/Consol-Monitoring/snclient/blob/main/LICENSE)
 [![IRC](https://img.shields.io/badge/IRC-libera.chat%2F%23snclient-blue)](https://web.libera.chat/?nick=Guest?#snclient)
+<a href="logo/"><img src="logo/snclient.svg" style="float:right; margin: 3px; height: auto; width: 200px; float: right;"></a>
 
 **SNClient** is an open-source (drop-in for most use cases) general purpose monitoring agent as replacement for the well-known NSClient++.
 
 It was written from scratch in [Golang](https://go.dev/) using todays state-of-the-art technologies. All the test and build procedures are located on [GitHub](https://github.com/ConSol-Monitoring/snclient).
 
-It's available for Linux, Windows and MacOS for i386, x86_64 and arm64 ([detailed list of supported operating systems](https://omd.consol.de/docs/snclient/install/supported/)).
+It's available for Linux, Windows and MacOS for i386, x86_64 and arm64 ([detailed list of supported operating systems](./install/supported/)).
+
+Have a look at the [installation](./install/) page for first steps.
+
+## Nagios / Naemon and Prometheus
 
-Have a look at the [installation](install) page for first steps.
+- SNClient supports the [Nagios / Naemon stack](./checks/) with nrpe or check_nsc_web.
+- Prometheus is also supported with the [builtin node_exporter and windows_exporter](./prometheus/)
 
 ## Releases
 
 The latest release can always be found [here](https://github.com/ConSol-Monitoring/snclient/releases).
+
+## Talks
+
+### 2023 - OSMC Nuremberg
+
+- english - 33 minutes
+- Talk: <https://www.youtube.com/watch?v=cXXZlnmn2NA>
+- [Slides](https://labs.consol.de/_slides/snclient-2023-11-09.pdf)

content/en/docs/snclient/checks/commands/check_files.md

@@ -81,10 +81,10 @@ these can be used in filters and thresholds (along with the default attributes):
 | file            | Alias for filename                                |
 | fullname        | Full name of the file including path              |
 | type            | Type of item (file or dir)                        |
-| access          | Last access time                                  |
-| creation        | Date when file was created                        |
+| access          | Unix timestamp of last access time                |
+| creation        | Unix timestamp when file was created              |
 | size            | File size in bytes                                |
-| written         | Date when file was last written to                |
+| written         | Unix timestamp when file was last written to      |
 | write           | Alias for written                                 |
 | age             | Seconds since file was last written               |
 | version         | Windows exe/dll file version (windows only)       |

content/en/docs/snclient/checks/commands/check_process.md

@@ -94,7 +94,8 @@ these can be used in filters and thresholds (along with the default attributes):
 | pid              | Process id                                                                                         |
 | uid              | User if of process owner (linux only)                                                              |
 | username         | User name of process owner (linux only)                                                            |
-| cpu              | CPU usage in percent                                                                               |
+| cpu              | CPU usage in percent (over total lifetime of process)                                              |
+| cpu_seconds      | CPU usage in seconds                                                                               |
 | virtual          | Virtual memory usage in bytes                                                                      |
 | rss              | Resident memory usage in bytes                                                                     |
 | pagefile         | Swap memory usage in bytes                                                                         |

content/en/docs/snclient/checks/commands/check_service_windows.md

@@ -78,7 +78,9 @@ these can be used in filters and thresholds (along with the default attributes):
 | -------------- | ---------------------------------------------------------------------------------------------------- |
 | name           | The name of the service                                                                              |
 | service        | Alias for name                                                                                       |
-| desc           | Description of the service                                                                           |
+| display        | Display name of the service                                                                          |
+| desc           | Alias for display (not a typo)                                                                       |
+| description    | Description of the service                                                                           |
 | state          | The state of the service, one of: stopped, starting, stopping, running, continuing, pausing, paused or unknown |
 | pid            | The pid of the service                                                                               |
 | created        | Date when service was started                                                                        |

content/en/docs/snclient/checks/commands/check_uptime.md

@@ -21,7 +21,7 @@ Check computer uptime (time since last reboot).
 ### Default Check
 
     check_uptime
-    OK - uptime: 3d 02:30h, boot: 2023-11-17 19:33:46 (UTC) |'uptime'=268241s;172800:;86400:
+    OK - uptime: 3d 02:30h, boot: 2023-11-17 19:33:46 UTC |'uptime'=268241s;172800:;86400:
 
 ### Example using NRPE and Naemon
 
@@ -41,15 +41,15 @@ Naemon Config
 
 ## Argument Defaults
 
-| Argument      | Default Value                            |
-| ------------- | ---------------------------------------- |
-| warning       | uptime < 2d                              |
-| critical      | uptime < 1d                              |
-| empty-state   | 0 (OK)                                   |
-| empty-syntax  |                                          |
-| top-syntax    | %(status) - \${list}                     |
-| ok-syntax     |                                          |
-| detail-syntax | uptime: \${uptime}, boot: \${boot} (UTC) |
+| Argument      | Default Value                             |
+| ------------- | ----------------------------------------- |
+| warning       | uptime < 2d                               |
+| critical      | uptime < 1d                               |
+| empty-state   | 0 (OK)                                    |
+| empty-syntax  |                                           |
+| top-syntax    | %(status) - \${list}                      |
+| ok-syntax     |                                           |
+| detail-syntax | uptime: \${uptime}, boot: \${boot \| utc} |
 
 ## Check Specific Arguments
 
@@ -65,4 +65,4 @@ these can be used in filters and thresholds (along with the default attributes):
 | ------------ | ----------------------------------- |
 | uptime       | Human readable time since last boot |
 | uptime_value | Uptime in seconds                   |
-| boot         | Human readable date of last boot    |
+| boot         | Unix timestamp of last boot         |

content/en/docs/snclient/checks/perfconfig/_index.md

@@ -14,7 +14,7 @@ check_plugin perf-config="selector(key:value;...)"
 For example:
 
 ```bash
-check_drivesize "perf-config=used(unit:G) used %(ignored:true)"
+check_drivesize "perf-config= used %(ignored:true) used(unit:G)"
 ```
 
 This will convert used disk space bytes into gigabytes. It als removes the percent

content/en/docs/snclient/configuration/_index.md

@@ -254,7 +254,7 @@ Support operators are:
 | `:age`                | 1700834034 -> 374                     | subtract value from current unix timestamp to get the age in seconds |
 | `:date`               | 1700834034 -> 2023-11-24 14:53:54 CET | convert unix timestamp into human readable date (local timezone) |
 | `:utc`                | 1700834034 -> 2023-11-24 13:53:54 UTC | convert unix timestamp into human readable date (utc timezone) |
-| `:fmt=<fmt>`          | 123.45 -> 123.4                       | apply format, ex.: $(total \| fmt=%.1f) (using GOs fmt.Sprintf) |
+| `:fmt=<fmt>`          | 123.45 -> 123.5                       | apply format, ex.: $(total \| fmt=%.1f) (using GOs fmt.Sprintf) |
 | `:s/regexp/replace/`  | C:\ % -> C                            | apply regexp replacement, ex.: $(name \| 's/\\W//' ) (using GOs regexp.Compile) |
 | `:ascii`              | C:\ % -> C                            | remove any none-ascii characters |
 | `:trim`               | " test " -> "test"                    | remove leading and trailing whitespace |

content/en/docs/snclient/logo/_index.md

@@ -6,9 +6,18 @@ linkTitle: Logo
 The logo can be used under the same license as SNClient itself to link back to
 the SNClient homepage or source code.
 
+## Light Mode
+
 snclient.png:
 
-[![SNClient Logo](snclient.png "SNClient Logo")](snclient.png)
+<img src="snclient.svg" style="height: auto; width: 200px; background: #EEE;">
 
 - [snclient.png](snclient.png)
 - [snclient.svg](snclient.svg)
+
+## Dark Mode
+
+<img src="snclient_dark.png" style="height: auto; width: 200px; background: #222;">
+
+- [snclient_dark.png](snclient_dark.png)
+- [snclient_dark.svg](snclient_dark.svg)