Skip to content
Thomas Brinker edited this page Aug 31, 2023 · 3 revisions

elos - event logging and management system

Short overview

elos is a tool to collect, store and publish various system events (i.e. syslogs, core dumps, measurements obtained from proc- and sys-fs, …) while providing easy access to the collected data.

elos transforms data from different event source into unified events that can be handled flexible and independent from the nature of the event emitting source.

To reach this goal, elos is using a so called canonical format, which means, that every collected data will be provided in a normalized form, so all the data from different sources gets structured and can be obtained in the same way.

Format of elos events

elos formats events as follows. Some fields are strongly typed, while others are weakly typed.

field description
date unix timestamp in seconds and nano seconds, the actual date of the event can be reconstructed from it
source the origin that created the particular information
severity when the message gets classified it is mapped to a severity value defined by this project
hardware id unique identifier of the hardware that produced the particular information
message code hides information (from security perspective), thus an information has a meaning without providing a payload
classification a set of flags to categorize events
payload the actual payload of the information (text, number, structs)

Benefits

  • Clean separation of event detection and handling
    • elos cares about the operation with syslogger, sensors, netlink, etc
    • developers just take the event and handle it, no matter where it originates from
    • if the interface changes due to an e.g. kernel update, only elos needs to adapt
  • Logging of events
    • elos writes events based on flexible rules to different storage
    • security related events are filtered out to allow cybersecurity audit
  • Cybersecurity
    • elos accepts security-critical events only from authorized senders
    • elos avoids event flooding to preserve availability
  • Quality
    • elos is designed with automotive quality awareness
    • Unit, Smoke and Integration tests are ready
  • Documentation
    • see here

License

MIT License

Copyright (c) [2023] [emlix GmbH, Elektrobit Automotive GmbH]

The full text of the license can be found in the LICENSE file in the repository root directory.

Powered by EB

elos is powered by elektrobit automotive gmbh. Elektrobit is an automotive software company and developer of embedded software products for ECU, AUTOSAR, automated driving, connected vehicles and UX. elos is an integrated part of EB corbos Linux. "EB corbos Linux – built on Ubuntu" is an open-source operating system for high-performance computing, leveraging the rich functionality of Linux while meeting security and industry regulations.

Maintainers

Credits

Andreas Schickedanz
Andreas Zdziarstek
Anja Lehwess-Litzmann
Annika Schmitt
Anton Hillerband
Benedikt Braunger
Christian Steiger
Daniel Glöckner
Fabian Godehardt
Friedrich Schwedler
Joerg Vehlow
Maryniuk Bogdan
Rainer Müller
Sabrina Otto
Thomas Brinker
Vignesh Jayaraman
Wolfgang Gehrhardt

Artwork

The elos logo is the Vombatus ursinus, also known as the bare-nosed wombat, designed from the handwriting word elos. Originator is Anja Lehwess-Litzmann (emlix GmbH). Year 2023. It is licensed under Creative Commons No Derivatives (CC-nd). It shall be used in black on white or HKS43 color.