Gitiles
Code Review Sign In
gerrit.openbmc.org / openbmc / phosphor-logging / 42828bd922d6e067089770112de5ec22d2df8ab1 / . / extensions / openpower-pels
tree: 9d95d0cd4c9110b569cdcc26411a4f16c0b2dc37 [path history] [tgz]
  1. additional_data.hpp
  2. ascii_string.cpp
  3. ascii_string.hpp
  4. bcd_time.cpp
  5. bcd_time.hpp
  6. callout.cpp
  7. callout.hpp
  8. callouts.cpp
  9. callouts.hpp
  10. data_interface.cpp
  11. data_interface.hpp
  12. entry_points.cpp
  13. failing_mtms.cpp
  14. failing_mtms.hpp
  15. fru_identity.cpp
  16. fru_identity.hpp
  17. generic.cpp
  18. generic.hpp
  19. log_id.cpp
  20. log_id.hpp
  21. manager.cpp
  22. manager.hpp
  23. mru.cpp
  24. mru.hpp
  25. mtms.cpp
  26. mtms.hpp
  27. openpower-pels.mk
  28. paths.cpp
  29. paths.hpp
  30. pce_identity.cpp
  31. pce_identity.hpp
  32. pel.cpp
  33. pel.hpp
  34. pel_types.hpp
  35. pel_values.cpp
  36. pel_values.hpp
  37. private_header.cpp
  38. private_header.hpp
  39. README.md
  40. registry.cpp
  41. registry.hpp
  42. repository.cpp
  43. repository.hpp
  44. section.hpp
  45. section_factory.cpp
  46. section_factory.hpp
  47. section_header.hpp
  48. severity.cpp
  49. severity.hpp
  50. src.cpp
  51. src.hpp
  52. stream.hpp
  53. user_data.cpp
  54. user_data.hpp
  55. user_header.cpp
  56. user_header.hpp
extensions/openpower-pels/README.md

OpenPower Platform Event Log (PEL) extension

This extension will create PELs for every OpenBMC event log. It is also possible to point to the raw PEL to use in the OpenBMC event, and then that will be used instead of creating one.

Passing PEL related data within an OpenBMC event log

An error log creator can pass in data that is relevant to a PEL by using certain keywords in the AdditionalData property of the event log.

AdditionalData keywords

RAWPEL

This keyword is used to point to an existing PEL in a binary file that should be associated with this event log. The syntax is:

RAWPEL=<path to PEL File>
e.g.
RAWPEL="/tmp/pels/pel.5"

The code will assign its own error log ID to this PEL, and also update the commit timestamp field to the current time.

_PID

This keyword that contains the application's PID is added automatically by the phosphor-logging daemon when the commit or report APIs are used to create an event log, but not when the Create D-Bus method is used. If a caller of the Create API wishes to have their PID captured in the PEL this should be used.

This will be added to the PEL in a section of type User Data (UD), along with the application name it corresponds to.

The syntax is:

_PID=<PID of application>
e.g.
_PID="12345"

The PEL Message Registry

D-Bus Interfaces