github.com/technosophos/deis@v1.7.1-0.20150915173815-f9005256004b/docs/customizing_deis/logger_settings.rst (about)

     1  :title: Customizing logger
     2  :description: Learn how to tune custom Deis settings.
     3  
     4  .. _logger_settings:
     5  
     6  Customizing logger
     7  =========================
     8  The following settings are tunable for the :ref:`logger` component.
     9  
    10  Dependencies
    11  ------------
    12  Requires: none
    13  
    14  Required by: :ref:`controller <controller_settings>`
    15  
    16  Considerations: none
    17  
    18  Settings set by logger
    19  ------------------------
    20  The following etcd keys are set by the logger component, typically in its /bin/boot script.
    21  
    22  ===========================              =================================================================================
    23  setting                                  description
    24  ===========================              =================================================================================
    25  /deis/logs/host                          IP address of the host running logger
    26  /deis/logs/port                          port used by the logger service (default: 514)
    27  ===========================              =================================================================================
    28  
    29  Settings used by logger
    30  -------------------------
    31  The logger component uses no keys from etcd.
    32  
    33  Using a custom logger image
    34  ---------------------------
    35  
    36  .. note::
    37  
    38    Instead of using a custom logger image, it is possible to redirect Deis logs to an external location.
    39    For more details, see :ref:`platform_logging`.
    40  
    41  You can use a custom Docker image for the logger component instead of the image
    42  supplied with Deis:
    43  
    44  .. code-block:: console
    45  
    46      $ deisctl config logger set image=myaccount/myimage:latest
    47  
    48  This will pull the image from the public Docker registry. You can also pull from a private
    49  registry:
    50  
    51  .. code-block:: console
    52  
    53      $ deisctl config logger set image=registry.mydomain.org:5000/myaccount/myimage:latest
    54  
    55  Be sure that your custom image functions in the same way as the `stock logger image`_ shipped with
    56  Deis. Specifically, ensure that it sets and reads appropriate etcd keys.
    57  
    58  .. _`stock logger image`: https://github.com/deis/deis/tree/master/logger