LOG_SYSTEMD Module

Daniel-Constantin Mierla

Edited by

Daniel-Constantin Mierla


Table of Contents

1. Admin Guide
1. Overview
2. Dependencies
2.1. Kamailio Modules
2.2. External Libraries or Applications
3. Core Logging
4. Functions
4.1. sd_journal_print(level, text)

List of Examples

1.1. Core Logging Replacement with Systemd
1.2. sd_journal_print usage

Chapter 1. Admin Guide

1. Overview

It provides logging to systemd journal from the moment of loading this module.

2. Dependencies

2.1. Kamailio Modules

The following modules must be loaded before this module:

  • none.

2.2. External Libraries or Applications

The following libraries or applications must be installed before running Kamailio with this module loaded:

  • libsystemd

3. Core Logging

This module can replace the syslog logging with sending the log messages to systemd journal. The logging to systemd is started when this module is loaded, before that the default syslog system is used.

It requires that core parameters log_engine_type to be set to 'systemd'. It is not enabled if log_stderror=yes.

Example 1.1. Core Logging Replacement with Systemd

...
log_engine_type="systemd"
...
loadmodule "log_systemd.so"
...

4. Functions

4.1.  sd_journal_print(level, text)

Print the text in the systemd journal at the provided level parameter.

Both parameters can contain variables.

For more, see the manual page for function sd_journal_print() in C library libsystemd.

This function can be used from ANY_ROUTE.

Example 1.2. sd_journal_print usage

...
   sd_journal_print("LOG_INFO", "R-URI is $ru\n");
...