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