doc: Add bucket logging admin commands documentation

Documents the flush and info subcommands for radosgw-admin bucket logging.

Fixes: https://tracker.ceph.com/issues/74447
Signed-off-by: Shree Jejurikar <shreemj8@gmail.com>

diff --git a/doc/man/8/radosgw-admin.rst b/doc/man/8/radosgw-admin.rst
index 3860f02081908f4ca835b04def55565982fe87ad..48367695f77e17fa7ffcf985dbba58aeee00db58 100644 (file)
--- a/doc/man/8/radosgw-admin.rst
+++ b/doc/man/8/radosgw-admin.rst
@@ -124,6 +124,16 @@ as follows:
 :command:`bucket sync enable`
   Enable bucket sync.
 
+:command:`bucket logging list`
+  List pending log objects for a source bucket.
+
+:command:`bucket logging info`
+  Show logging configuration for a source bucket, or list source buckets
+  logging to a specific log bucket.
+
+:command:`bucket logging flush`
+  Flush pending log objects to the log bucket immediately.
+
 :command:`bi get`
   Retrieve bucket index object entries.
 

diff --git a/doc/radosgw/bucket_logging.rst b/doc/radosgw/bucket_logging.rst
index 3915ae59a71ac09d1f0baa97f6535b739cff9597..4d58d3284595a59153b6a3b1d6af84d9c579c7d9 100644 (file)
--- a/doc/radosgw/bucket_logging.rst
+++ b/doc/radosgw/bucket_logging.rst
@@ -54,6 +54,13 @@ them, regardless if enough time passed or if no more records are written to the
 object. Flushing will happen automatically when logging is disabled on a
 bucket, or its logging configuration is changed, or the bucket is deleted.
 
+To manually flush pending log objects to the log bucket, execute the following
+command:
+
+.. prompt:: bash #
+
+   radosgw-admin bucket logging flush --bucket <source bucket>
+
 The process of adding a new log object to the log bucket is asynchronous when
 triggered by a log record being written. Consequently, the operation that
 generated the log is completed immediately and does not wait for the log object
@@ -69,6 +76,17 @@ the log bucket, execute the following command:
 
    radosgw-admin bucket logging list --bucket <source bucket>
 
+To view the logging configuration of a source bucket, or to see which source
+buckets are logging to a specific log bucket, execute the following command:
+
+.. prompt:: bash #
+
+   radosgw-admin bucket logging info --bucket <bucket>
+
+When run on a source bucket, this displays the logging configuration (target
+bucket, prefix, etc.). When run on a log bucket, this displays which source
+buckets are sending logs to it.
+
 
 Standard
 ````````