summaryrefslogtreecommitdiffstats
path: root/docs/observability-centralization-points
diff options
context:
space:
mode:
Diffstat (limited to 'docs/observability-centralization-points')
-rw-r--r--docs/observability-centralization-points/logs-centralization-points-with-systemd-journald/README.md48
-rw-r--r--docs/observability-centralization-points/metrics-centralization-points/configuration.md2
2 files changed, 49 insertions, 1 deletions
diff --git a/docs/observability-centralization-points/logs-centralization-points-with-systemd-journald/README.md b/docs/observability-centralization-points/logs-centralization-points-with-systemd-journald/README.md
index 67cad84760..e40396a7ec 100644
--- a/docs/observability-centralization-points/logs-centralization-points-with-systemd-journald/README.md
+++ b/docs/observability-centralization-points/logs-centralization-points-with-systemd-journald/README.md
@@ -1,5 +1,53 @@
# Logs Centralization Points with systemd-journald
+```mermaid
+stateDiagram-v2
+ classDef userFeature fill:#f00,color:white,font-weight:bold,stroke-width:2px,stroke:orange
+ classDef usedByNC fill:#090,color:white,font-weight:bold,stroke-width:2px,stroke:orange
+ classDef log2journal fill:#040,color:white,font-weight:bold,stroke-width:2px,stroke:orange
+
+ logsQuery:::usedByNC
+ logsDashboard:::userFeature
+ journald:::thirdparty
+ journalRemote:::thirdparty
+ journalUpload:::thirdparty
+ journalFiles:::thirdparty
+ logSources:::thirdparty
+ textFiles:::thirdparty
+ log2journal:::log2journal
+
+ journalRemote: systemd-journal-remote
+ journalUpload: systemd-journal-upload
+ journalFiles: Store
+ journalFiles: systemd-journal files
+ journald: systemd-journald
+ logSources: Local Logs Sources
+ log2journal:log2journal
+ log2journal:Convert text, json, logfmt files
+ log2journal:to structured journal entries.
+ logsDashboard: Netdata Dashboards
+ logsQuery: Query Journal Files
+ textFiles: Text Log Files
+
+ logSources --> journald: journald API
+ logSources --> textFiles: write to log files
+ textFiles --> log2journal: tail log files
+ log2journal --> journald: journald API
+ journald --> journalFiles
+
+ journalFiles --> Netdata
+ journalFiles --> journalUpload
+
+ journalRemote -->journalFiles
+ journalUpload --> [*]: to a remote journald
+ [*] --> journalRemote: from a remote journald
+
+ state Netdata {
+ [*]-->logsQuery
+ logsQuery --> logsDashboard
+ }
+```
+
Logs centralization points can be built using the `systemd-journald` methodologies, by configuring `systemd-journal-remote` (on the centralization point) and `systemd-journal-upload` (on the production system).
The logs centralization points and the metrics centralization points do not need to be the same. For clarity and simplicity however, when not otherwise required for operational or regulatory reasons, we recommend to have unified centralization points for both metrics and logs.
diff --git a/docs/observability-centralization-points/metrics-centralization-points/configuration.md b/docs/observability-centralization-points/metrics-centralization-points/configuration.md
index e52f7309ff..d25f3b92d7 100644
--- a/docs/observability-centralization-points/metrics-centralization-points/configuration.md
+++ b/docs/observability-centralization-points/metrics-centralization-points/configuration.md
@@ -61,7 +61,7 @@ While encrypting the connection between your parent and child nodes is recommend
This example uses self-signed certificates.
> **Note**
-> This section assumes you have read the documentation on [how to edit the Netdata configuration files](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration.md).
+> This section assumes you have read the documentation on [how to edit the Netdata configuration files](https://github.com/netdata/netdata/blob/master/docs/netdata-agent/configuration/README.md).
<!-- here we need link to the section that will contain the restarting instructions -->
1. **Parent node**