Skip to content

Commit

Permalink
obox: azure: Add debugging instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
vmo69 authored and cmouse committed Oct 2, 2023
1 parent 0919d17 commit f01e4f4
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions source/configuration_manual/mail_location/obox/azure.rst
Original file line number Diff line number Diff line change
Expand Up @@ -22,3 +22,25 @@ The parameters are:
+=================================+==========================================================+
| See :ref:`http_storages` for common parameters |
+---------------------------------+----------------------------------------------------------+


Debugging
---------

To be able to easily track requests outgoing from Dovecot and incoming from
the Azure storage the following headers should be added as `loghdr` (For more
details see :ref:`http_storages`)

.. code-block:: none
plugin {
# Debugging configuration:
obox_fs = azure:https://ACCOUNTNAME:[email protected]/?loghdr=x-ms-client-request-id&loghdr=x-ms-request-id
}
This configuration makes sure that the ``x-ms-client-request-id`` header is
added to the requests by Dovecot. This will use the current session id, which
allows to correlate Dovecot activities with requests that the server
receives. Additionally the ``x-ms-request-id`` header should be added as
loghdr as well. This header is added by the Azure storage to identify
individual requests.

0 comments on commit f01e4f4

Please sign in to comment.