/puppet-journald

configures journald via puppet

Primary LanguagePuppetOtherNOASSERTION

journald

Build Status

Table of Contents

  1. Overview
  2. Setup - The basics of getting started with journald
  3. Limitations - OS compatibility, etc.
  4. Development - Guide for contributing to the module

Overview

systemd-journald is a system service that collects and stores logging data. It creates and maintains structured, indexed journals based on logging information that is received from a variety of sources:

  • Kernel log messages, via kmsg
  • Simple system log messages, via the libc syslog(3) call
  • Structured system log messages via the native Journal API, see sd_journal_print(4)
  • Standard output and standard error of system services
  • Audit records, via the audit subsystem

Setup

Beginning with journald

include journald

Usage

class {'journald': options => {
    'Compress'          => 'yes',
    'ForwardToSyslog'   => 'yes',
    'ForwardToKMsg'     => 'yes',
    'ForwardToConsole'  => 'no',
    'TTYPath'           => '/dev/console',
  }
}

Remote logging with journald

Make sure the systemd-journal-upload is in the systemd-journal group,
	otherwise the upload process will not have access to the journal files

class {'journald': upload => {
  'Url' => 'http://10.0.0.1:19532',
  }
}

Or using https

class {'journald': upload => {
  'Url'                     => 'https://10.0.0.1:19532',
  'ServerKeyFile'           => '/etc/ssl/private/journal-upload.pem',
  'ServerCertificateFile'   => '/etc/ssl/certs/journal-upload.pem',
  'TrustedCertificateFile'  => '/etc/ssl/ca/trusted.pem',
  }
}

Limitations

This module is only appicable on EL7 machines

Development

  • Fork the project
  • Commit and push until you are happy with your contribution
  • Send a pull request with a description of your changes