Add changelog fragments

Signed-off-by: Jakub Jelen <jjelen@redhat.com>
Co-authored-by: Sviatoslav Sydorenko <webknjaz@redhat.com>

Author: Jakuje

docs/changelog-fragments/597.bugfix.rst

@@ -0,0 +1,6 @@
+Fixed the log level mapping to cover the entire ``libssh`` range
+-- by :user:`Jakuje` and :user:`webknjaz`.
+
+Previously it was not possible to set the most verbose ``libssh`` log level
+``SSH_LOG_TRACE`` to get the most verbose log messages useful for debugging
+connection issues.

docs/changelog-fragments/597.feature.rst

@@ -0,0 +1,29 @@
+Made ``libssh`` use the Python :external+python:mod:`logging` system
+-- by :user:`Jakuje` and :user:`webknjaz`.
+
+Previously the underlying ``libssh`` library was writing its logs directly
+from the C-level into ``stderr``, which caused inconsistent behavior.
+
+The default log level is now set to :data:`ANSIBLE_PYLIBSSH_TRACE`
+and the downstream loggers are able to trim the verbosity down.
+If you need performance, it is possible to disable logging on the ``libssh``
+side at the source by setting a lower logging value, for example:
+
+.. code-block:: python
+
+   ssh_session.set_log_level(ANSIBLE_PYLIBSSH_NOLOG)
+
+Additionally, the log level can be now be set also through the session initializer:
+
+.. code-block:: python
+
+   ssh = Session(log_verbosity=ANSIBLE_PYLIBSSH_TRACE)
+
+
+or the ``connect()`` method arguments:
+
+.. code-block:: python
+
+   ssh.connect(log_verbosity=ANSIBLE_PYLIBSSH_TRACE)
+
+Setting any levels imported from :external+python:mod:`!logging` is also supported.