docs: Added documentation on log_level and excluded_loggers params in setup_logging (#971)

* docs: Added documentation on log_level and excluded_loggers params in setup_logging * Added product prefix to new region tags.

Author: gkevinzheng

docs/std-lib-integration.rst

@@ -16,6 +16,21 @@ call :meth:`~google.cloud.logging_v2.client.Client.setup_logging` on a :class:`~
  :end-before: [END logging_handler_setup]
  :dedent: 4
 
+
+You can also set the logging level threshold of the logging handler created by :meth:`~google.cloud.logging_v2.client.Client.setup_logging`,
+as well as set loggers excluded from the logger that is created:
+
+.. literalinclude:: ../samples/snippets/usage_guide.py
+ :start-after: [START logging_setup_logging]
+ :end-before: [END logging_setup_logging]
+ :dedent: 4
+
+.. literalinclude:: ../samples/snippets/usage_guide.py
+ :start-after: [START logging_setup_logging_excludes]
+ :end-before: [END logging_setup_logging_excludes]
+ :dedent: 4
+
+
 This :meth:`~google.cloud.logging_v2.client.Client.setup_logging` function chooses the best configurations for the environment your
 code is running on. For more information, see the `Google Cloud Logging documentation <https://cloud.google.com/logging/docs/setup/python>`_.
 

google/cloud/logging_v2/client.py

@@ -400,7 +400,8 @@ def setup_logging(
  loggers, will report to Cloud Logging.
 
  Args:
- log_level (Optional[int]): Python logging log level. Defaults to
+ log_level (Optional[int]): The logging level threshold of the attached logger,
+ as set by the :meth:`logging.Logger.setLevel` method. Defaults to
  :const:`logging.INFO`.
  excluded_loggers (Optional[Tuple[str]]): The loggers to not attach the
  handler to. This will always include the

google/cloud/logging_v2/handlers/handlers.py

@@ -296,7 +296,8 @@ def setup_logging(
  excluded_loggers (Optional[Tuple[str]]): The loggers to not attach the handler
  to. This will always include the loggers in the
  path of the logging client itself.
- log_level (Optional[int]): Python logging log level. Defaults to
+ log_level (Optional[int]): The logging level threshold of the attached logger,
+ as set by the :meth:`logging.Logger.setLevel` method. Defaults to
  :const:`logging.INFO`.
  """
  all_excluded_loggers = set(excluded_loggers + _INTERNAL_LOGGERS)

samples/snippets/usage_guide.py

@@ -475,13 +475,13 @@ def using_extras(client):
 def setup_logging(client):
  import logging
 
- # [START setup_logging]
+ # [START logging_setup_logging]
  client.setup_logging(log_level=logging.INFO)
- # [END setup_logging]
+ # [END logging_setup_logging]
 
- # [START setup_logging_excludes]
+ # [START logging_setup_logging_excludes]
  client.setup_logging(log_level=logging.INFO, excluded_loggers=("werkzeug",))
- # [END setup_logging_excludes]
+ # [END logging_setup_logging_excludes]
 
 
 @snippet