github.com/greenboxal/deis@v1.12.1/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 following etcd keys are used by the logger component.
    32  
    33  ====================================      ================================================================================
    34  setting                                   description
    35  ====================================      ================================================================================
    36  /deis/logs/storageAdapterType             Type of storage adapter to use: ``file`` or ``memory``; if not set, ``file`` is assumed.  It is also possible so specify the size of the in-memory adapter's internal ring buffer (in lines; a line is a max of 65k) using a value like: ``memory:<size>``.  1000 is the default size.
    37  /deis/logs/drain                          URL for an external service that logs can be forwarded to for long-term archival. If not set, no drain is used.  URLs beginning with ``udp://``, ``syslog://`` use UDP for transport.  URLs beginning with ``tcp://`` use TCP.
    38  ====================================      ================================================================================
    39  
    40  .. note::
    41  
    42    Those running the stateless (Ceph-less) platform should prefer the in-memory storage adapter.
    43  
    44  Using a custom logger image
    45  ---------------------------
    46  
    47  .. note::
    48  
    49    Instead of using a custom logger image, it is possible to redirect Deis logs to an external location.
    50    For more details, see :ref:`platform_logging`.
    51  
    52  You can use a custom Docker image for the logger component instead of the image
    53  supplied with Deis:
    54  
    55  .. code-block:: console
    56  
    57      $ deisctl config logger set image=myaccount/myimage:latest
    58  
    59  This will pull the image from the public Docker registry. You can also pull from a private
    60  registry:
    61  
    62  .. code-block:: console
    63  
    64      $ deisctl config logger set image=registry.mydomain.org:5000/myaccount/myimage:latest
    65  
    66  Be sure that your custom image functions in the same way as the `stock logger image`_ shipped with
    67  Deis. Specifically, ensure that it sets and reads appropriate etcd keys.
    68  
    69  .. _`stock logger image`: https://github.com/deis/deis/tree/master/logger