Sync docs from Discourse (#494)

Co-authored-by: GitHub Actions <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

docs/explanation/e-interfaces.md renamed to docs/explanation/e-interfaces-endpoints.md

@@ -10,12 +10,20 @@ root@mysql-k8s-0:/# ls -lahR /var/log/mysql
 total 28K
 drwxr-xr-x 1 mysql mysql 4.0K Oct 23 20:46 .
 drwxr-xr-x 1 root root 4.0K Sep 27 20:55 ..
+drwxrwx--- 2 mysql mysql 4.0K Oct 23 20:46 archive_audit
 drwxrwx--- 2 mysql mysql 4.0K Oct 23 20:46 archive_error
 drwxrwx--- 2 mysql mysql 4.0K Oct 23 20:46 archive_general
 drwxrwx--- 2 mysql mysql 4.0K Oct 23 20:45 archive_slowquery
 -rw-r----- 1 mysql mysql 1.2K Oct 23 20:46 error.log
 -rw-r----- 1 mysql mysql 1.7K Oct 23 20:46 general.log
 
+/var/snap/charmed-mysql/common/var/log/mysql/archive_audit:
+total 452K
+drwxrwx--- 2 snap_daemon snap_daemon 4.0K Sep  3 01:49 .
+drwxr-xr-x 6 snap_daemon root        4.0K Sep  3 01:49 ..
+-rw-r----- 1 snap_daemon root         43K Sep  3 01:24 audit.log-20240903_0124
+-rw-r----- 1 snap_daemon root        109K Sep  3 01:25 audit.log-20240903_0125
+
 /var/log/mysql/archive_error:
 total 20K
 drwxrwx--- 2 mysql mysql 4.0K Oct 23 20:46 .
@@ -36,6 +44,21 @@ drwxrwx--- 2 mysql mysql 4.0K Oct 23 20:45 .
 drwxr-xr-x 1 mysql mysql 4.0K Oct 23 20:46 ..
 ```
 
+The following is a sample of the audit logs, with format json with login/logout records:
+
+```json
+{"audit_record":{"name":"Connect","record":"17_2024-09-03T01:52:14","timestamp":"2024-09-03T01:53:14Z","connection_id":"988","status":1156,"user":"","priv_user":"","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+{"audit_record":{"name":"Connect","record":"18_2024-09-03T01:52:14","timestamp":"2024-09-03T01:53:14Z","connection_id":"989","status":0,"user":"serverconfig","priv_user":"serverconfig","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+{"audit_record":{"name":"Quit","record":"1_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:14Z","connection_id":"989","status":0,"user":"serverconfig","priv_user":"serverconfig","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+{"audit_record":{"name":"Connect","record":"2_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:33Z","connection_id":"990","status":1156,"user":"","priv_user":"","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+{"audit_record":{"name":"Connect","record":"3_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:33Z","connection_id":"991","status":0,"user":"serverconfig","priv_user":"serverconfig","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+{"audit_record":{"name":"Quit","record":"4_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:33Z","connection_id":"991","status":0,"user":"serverconfig","priv_user":"serverconfig","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+{"audit_record":{"name":"Connect","record":"5_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:33Z","connection_id":"992","status":0,"user":"clusteradmin","priv_user":"clusteradmin","os_login":"","proxy_user":"","host":"localhost","ip":"","db":""}}
+{"audit_record":{"name":"Quit","record":"6_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:33Z","connection_id":"992","status":0,"user":"clusteradmin","priv_user":"clusteradmin","os_login":"","proxy_user":"","host":"localhost","ip":"","db":""}}
+{"audit_record":{"name":"Connect","record":"7_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:33Z","connection_id":"993","status":1156,"user":"","priv_user":"","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+{"audit_record":{"name":"Connect","record":"8_2024-09-03T01:53:14","timestamp":"2024-09-03T01:53:33Z","connection_id":"994","status":0,"user":"serverconfig","priv_user":"serverconfig","os_login":"","proxy_user":"","host":"juju-da2225-8","ip":"10.207.85.214","db":""}}
+```
+
 The following is a sample of the error logs, with format `time thread [label] [err_code] [subsystem] msg`:
 
 ```shell
@@ -100,19 +123,19 @@ SET timestamp=1698099752;
 do sleep(15);
 ```
 
-The charm currenly has error and general logs enabled by default, while slow query logs are disabled by default. All of these files are rotated if present into a separate dedicated archive folder under the logs directory.
+The charm currently has error and general logs enabled by default, while slow query logs are disabled by default. All of these files are rotated if present into a separate dedicated archive folder under the logs directory.
 
 We do not yet support the rotation of binary logs (binlog, relay log, undo log, redo log, etc).
 
 ## Log Rotation Configurations
 
-For each log (error, general and slow query):
+For each log (audit, error, general and slow query):
 
 - The log file is rotated every minute (even if the log files are empty)
 - The rotated log file is formatted with a date suffix of `-%V-%H%M` (-weeknumber-hourminute)
 - The rotated log files are not compressed or mailed
 - The rotated log files are owned by the `snap_daemon` user and group
-- The rotated log files are retained for a maximux of 7 days before being deleted
+- The rotated log files are retained for a maximum of 7 days before being deleted
 - The most recent 10080 rotated log files are retained before older rotated log files are deleted
 
 The following are logrotate config values used for log rotation:

docs/explanation/e-logs.md

@@ -1,5 +1,4 @@
 # Clients for Async replication
-> **WARNING**: it is an '8.0/candidate' article. Do NOT use it in production!<br/>Contact [Canonical Data Platform team](/t/11868) if you are interested in the topic.
 
 ## Pre-requisits
 Make sure both `Rome` and `Lisbon` Clusters are deployed using the [Async Deployment manual](/t/13458)!

docs/how-to/h-async/h-async-clients.md renamed to docs/how-to/h-async-clients.md

@@ -1,9 +1,4 @@
 # Deploy Async replication
-[note type="caution"]
-**Warning**: This feature is for charm revision `8.0/edge`. Do NOT use it in production!
-
-Contact the [Canonical Data Platform team](/t/11868) if you are interested in this topic.
-[/note]
 
 ## Deploy
 

docs/how-to/h-async/h-async-deployment.md renamed to docs/how-to/h-async-deployment.md

@@ -1,7 +1,5 @@
 # Switchover / Failover of Async replication
 
-> **WARNING**: it is an '8.0/edge' article. Do NOT use it in production!<br/>Contact [Canonical Data Platform team](/t/11868) if you are interested in the topic.
-
 ## Pre-requisits
 
 Make sure both `Rome` and `Lisbon` Clusters are deployed using the [Async Deployment manual](/t/13458)!

docs/how-to/h-async/h-async-failover.md renamed to docs/how-to/h-async-failover.md

@@ -1,5 +1,4 @@
 # Recovery of Async replication
-> **WARNING**: it is an '8.0/candidate' article. Do NOT use it in production!<br/>Contact [Canonical Data Platform team](/t/11868) if you are interested in the topic.
 
 ## Pre-requisits
 Make sure both `Rome` and `Lisbon` Clusters are deployed using the [Async Deployment manual](/t/13458)!

docs/how-to/h-async/h-async-recovery.md renamed to docs/how-to/h-async-recovery.md

@@ -1,7 +1,5 @@
 # Removal of Async replication
 
-> **WARNING**: it is an '8.0/edge' article. Do NOT use it in production!<br/>Contact [Canonical Data Platform team](/t/11868) if you are interested in the topic.
-
 ## Pre-requisits
 
 Make sure both `Rome` and `Lisbon` Clusters are deployed using the [Async Deployment manual](/t/13458)!