.. zephyr:code-sample:: syslog-net
   :name: Remote syslog
   :relevant-api: log_backend log_ctrl

   Enable a remote syslog service that sends syslog messages to a remote server

Overview
********

This sample application enables a remote syslog service that will
send syslog messages to a remote server, as configured in ``prj.conf``.
See :rfc:`5424` and :rfc:`5426` for more details about syslog protocol over UDP.

The source code for this sample application can be found at:
:zephyr_file:`samples/net/syslog_net`.

Requirements
************

- :ref:`networking_with_host`

Building and Running
********************

For configuring the remote IPv6 syslog server, set the following
variables in prj.conf file:

.. code-block:: cfg

	CONFIG_LOG_BACKEND_NET=y
	CONFIG_LOG_BACKEND_NET_SERVER="[2001:db8::2]:514"

Default port number is 514 and the default protocol is UDP
if user does not explicitly specify otherwise.
The following syntax is supported for the server address
and port:

.. code-block:: console

	192.0.2.1:514
	192.0.2.42
	[2001:db8::1]:514
	[2001:db8::2]
	2001:db::42

To change the protocol to TCP, prefix the server address with ``tcp://``

.. code-block:: console

   tcp://192.0.2.1:514
   tcp://192.0.2.42
   tcp://[2001:db8::1]:514


Build syslog_net sample application like this:

.. zephyr-app-commands::
   :zephyr-app: samples/net/syslog_net
   :board: <board to use>
   :conf: <config file to use>
   :goals: build
   :compact:

Wi-Fi
=====

The IPv4 Wi-Fi support can be enabled in the sample with
:ref:`Wi-Fi snippet <snippet-wifi-ipv4>`.