From 6c78cd01210047d20a63199b70aa201bd4f3fc8c Mon Sep 17 00:00:00 2001
From: Oliver <oliver.loten@windriver.com>
Date: Fri, 24 Jun 2022 14:02:05 -0400
Subject: [PATCH] Documentation enhancements for Security and Fault Management

Fixed commit message
Update with review comments for Patch Set 1
Added a new fault and performance section to the Introduction guide.
Change-Id: Ia9e38ab9e8b88430bf7f475200e8bb65b12e5a75
---
 doc/source/.vscode/settings.json              |  3 --
 ...nd-performance-management-940c6f6b3f6e.rst | 38 +++++++++++++++++++
 .../introduction/index-intro-27197f27ad41.rst |  1 +
 3 files changed, 39 insertions(+), 3 deletions(-)
 delete mode 100644 doc/source/.vscode/settings.json
 create mode 100644 doc/source/introduction/fault-and-performance-management-940c6f6b3f6e.rst

diff --git a/doc/source/.vscode/settings.json b/doc/source/.vscode/settings.json
deleted file mode 100644
index 3cce948f6..000000000
--- a/doc/source/.vscode/settings.json
+++ /dev/null
@@ -1,3 +0,0 @@
-{
-    "restructuredtext.confPath": ""
-}
\ No newline at end of file
diff --git a/doc/source/introduction/fault-and-performance-management-940c6f6b3f6e.rst b/doc/source/introduction/fault-and-performance-management-940c6f6b3f6e.rst
new file mode 100644
index 000000000..5c24cb007
--- /dev/null
+++ b/doc/source/introduction/fault-and-performance-management-940c6f6b3f6e.rst
@@ -0,0 +1,38 @@
+.. _fault-and-performance-management-940c6f6b3f6e:
+
+=================================
+ Performance and Fault Management
+=================================
+
+|prod| provides a number of tools to allow system administrators to manage
+performance and troubleshoot system issues.
+
+Performance Management
+----------------------
+
+|prod| utilizes collectd ( https://collectd.org/ ) to capture the following
+platform statistics and to generate threshold events based on
+these statistics:
+
+-    CPU Usage of Platform Cores of |prod| hosts
+
+-    Platform Memory Usage of |prod| hosts
+
+-    Platform File Systems Usage 
+
+-    Platform Interface Usage
+
+-    PTP Clock Skew Monitor
+
+Any collectd threshold events trigger |prod| fault management Set/Clear
+Customer Alarms.
+
+Fault Management
+----------------
+
+For an overview of |prod| fault management, see
+:ref:`fault-management-overview`.
+
+For a listing of all |prod| fault management resources, including alarm log
+messages, see 'Alarm messages' and 'Log messages' in the :ref:`Fault Management
+Contents <index-fault-kub-f45ef76b6f16>` page.
\ No newline at end of file
diff --git a/doc/source/introduction/index-intro-27197f27ad41.rst b/doc/source/introduction/index-intro-27197f27ad41.rst
index a8d27e650..81015f7b0 100644
--- a/doc/source/introduction/index-intro-27197f27ad41.rst
+++ b/doc/source/introduction/index-intro-27197f27ad41.rst
@@ -33,6 +33,7 @@ Learn more about StarlingX:
    functional_overview
    deploy_config_overview
    deploy_options
+   fault-and-performance-management-940c6f6b3f6e
    terms
    consuming
    StarlingX Project Overview (PDF) <https://www.starlingx.io/collateral/StarlingX_Onboarding_Deck_for_Web.pdf>