blob: 2535832aa6c1147d3b407da1a0040f9010bcd67e [file] [log] [blame]
#pragma once
#include "elog_block.hpp"
#include "elog_entry.hpp"
#include "xyz/openbmc_project/Logging/Internal/Manager/server.hpp"
#include <phosphor-logging/log.hpp>
#include <sdbusplus/bus.hpp>
#include <xyz/openbmc_project/Collection/DeleteAll/server.hpp>
#include <xyz/openbmc_project/Logging/Create/server.hpp>
#include <xyz/openbmc_project/Logging/Entry/server.hpp>
#include <xyz/openbmc_project/Logging/event.hpp>
#include <list>
namespace phosphor
{
namespace logging
{
extern const std::map<std::string, std::vector<std::string>> g_errMetaMap;
extern const std::map<std::string, level> g_errLevelMap;
using CreateIface = sdbusplus::server::xyz::openbmc_project::logging::Create;
using DeleteAllIface =
sdbusplus::server::xyz::openbmc_project::collection::DeleteAll;
using Severity = sdbusplus::xyz::openbmc_project::Logging::server::Entry::Level;
using LoggingCleared = sdbusplus::event::xyz::openbmc_project::Logging::Cleared;
namespace details
{
template <typename... T>
using ServerObject = typename sdbusplus::server::object_t<T...>;
using ManagerIface =
sdbusplus::server::xyz::openbmc_project::logging::internal::Manager;
} // namespace details
constexpr size_t ffdcFormatPos = 0;
constexpr size_t ffdcSubtypePos = 1;
constexpr size_t ffdcVersionPos = 2;
constexpr size_t ffdcFDPos = 3;
using FFDCEntry = std::tuple<CreateIface::FFDCFormat, uint8_t, uint8_t,
sdbusplus::message::unix_fd>;
using FFDCEntries = std::vector<FFDCEntry>;
namespace internal
{
/** @class Manager
* @brief OpenBMC logging manager implementation.
* @details A concrete implementation for the
* xyz.openbmc_project.Logging.Internal.Manager DBus API.
*/
class Manager : public details::ServerObject<details::ManagerIface>
{
public:
Manager() = delete;
Manager(const Manager&) = delete;
Manager& operator=(const Manager&) = delete;
Manager(Manager&&) = delete;
Manager& operator=(Manager&&) = delete;
virtual ~Manager() = default;
/** @brief Constructor to put object onto bus at a dbus path.
* @param[in] bus - Bus to attach to.
* @param[in] path - Path to attach at.
*/
Manager(sdbusplus::bus_t& bus, const char* objPath) :
details::ServerObject<details::ManagerIface>(bus, objPath), busLog(bus),
entryId(0), fwVersion(readFWVersion()) {};
/*
* @fn commit()
* @brief sd_bus Commit method implementation callback.
* @details Create an error/event log based on transaction id and
* error message.
* @param[in] transactionId - Unique identifier of the journal entries
* to be committed.
* @param[in] errMsg - The error exception message associated with the
* error log to be committed.
*/
uint32_t commit(uint64_t transactionId, std::string errMsg) override;
/*
* @fn commit()
* @brief sd_bus CommitWithLvl method implementation callback.
* @details Create an error/event log based on transaction id and
* error message.
* @param[in] transactionId - Unique identifier of the journal entries
* to be committed.
* @param[in] errMsg - The error exception message associated with the
* error log to be committed.
* @param[in] errLvl - level of the error
*/
uint32_t commitWithLvl(uint64_t transactionId, std::string errMsg,
uint32_t errLvl) override;
/** @brief Erase specified entry d-bus object
*
* @param[in] entryId - unique identifier of the entry
*/
void erase(uint32_t entryId);
/** @brief Construct error d-bus objects from their persisted
* representations.
*/
void restore();
/** @brief Erase all error log entries
*
* @return size_t - count of erased entries
*/
size_t eraseAll();
/** @brief Returns the count of high severity errors
*
* @return int - count of real errors
*/
int getRealErrSize();
/** @brief Returns the count of Info errors
*
* @return int - count of info errors
*/
int getInfoErrSize();
/** @brief Returns the number of blocking errors
*
* @return int - count of blocking errors
*/
int getBlockingErrSize()
{
return blockingErrors.size();
}
/** @brief Returns the number of property change callback objects
*
* @return int - count of property callback entries
*/
int getEntryCallbackSize()
{
return propChangedEntryCallback.size();
}
/**
* @brief Returns the sdbusplus bus object
*
* @return sdbusplus::bus_t&
*/
sdbusplus::bus_t& getBus()
{
return busLog;
}
/**
* @brief Returns the ID of the last created entry
*
* @return uint32_t - The ID
*/
uint32_t lastEntryID() const
{
return entryId;
}
/** @brief Creates an event log
*
* This is an alternative to the _commit() API. It doesn't use
* the journal to look up event log metadata like _commit does.
*
* @param[in] errMsg - The error exception message associated with the
* error log to be committed.
* @param[in] severity - level of the error
* @param[in] additionalData - The AdditionalData property for the error
* @param[in] ffdc - A vector of tuples that allows one to pass in file
* descriptors for files that contain FFDC (First
* Failure Data Capture). These will be passed to any
* event logging extensions.
*/
auto create(const std::string& message, Severity severity,
const std::map<std::string, std::string>& additionalData,
const FFDCEntries& ffdc = FFDCEntries{})
-> sdbusplus::message::object_path;
/** @brief Create an internal event log from the sdbusplus generated event
*
* @param[in] event - The event to create.
*/
auto createFromEvent(sdbusplus::exception::generated_event_base&& event)
-> sdbusplus::message::object_path;
/** @brief Common wrapper for creating an Entry object
*
* @return true if quiesce on error setting is enabled, false otherwise
*/
bool isQuiesceOnErrorEnabled();
/** @brief Create boot block association and quiesce host if running
*
* @param[in] entryId - The ID of the phosphor logging error
*/
void quiesceOnError(const uint32_t entryId);
/** @brief Check if inventory callout present in input entry
*
* @param[in] entry - The error to check for callouts
*
* @return true if inventory item in associations, false otherwise
*/
bool isCalloutPresent(const Entry& entry);
/** @brief Check (and remove) entry being erased from blocking errors
*
* @param[in] entryId - The entry that is being erased
*/
void checkAndRemoveBlockingError(uint32_t entryId);
/** @brief Persistent map of Entry dbus objects and their ID */
std::map<uint32_t, std::unique_ptr<Entry>> entries;
private:
/*
* @fn _commit()
* @brief commit() helper
* @param[in] transactionId - Unique identifier of the journal entries
* to be committed.
* @param[in] errMsg - The error exception message associated with the
* error log to be committed.
* @param[in] errLvl - level of the error
*/
void _commit(uint64_t transactionId, std::string&& errMsg,
Entry::Level errLvl);
/** @brief Call metadata handler(s), if any. Handlers may create
* associations.
* @param[in] errorName - name of the error
* @param[in] additionalData - list of metadata (in key=value format)
* @param[out] objects - list of error's association objects
*/
void processMetadata(const std::string& errorName,
const std::vector<std::string>& additionalData,
AssociationList& objects) const;
/** @brief Reads the BMC code level
*
* @return std::string - the version string
*/
static std::string readFWVersion();
/** @brief Call any create() functions provided by any extensions.
* This is called right after an event log is created to allow
* extensions to create their own log based on this one.
*
* @param[in] entry - the new event log entry
* @param[in] ffdc - A vector of FFDC file info
*/
void doExtensionLogCreate(const Entry& entry, const FFDCEntries& ffdc);
/** @brief Common wrapper for creating an Entry object
*
* @param[in] errMsg - The error exception message associated with the
* error log to be committed.
* @param[in] errLvl - level of the error
* @param[in] additionalData - The AdditionalData property for the error
* @param[in] ffdc - A vector of FFDC file info. Defaults to an empty
* vector.
*/
auto createEntry(std::string errMsg, Entry::Level errLvl,
std::vector<std::string> additionalData,
const FFDCEntries& ffdc = FFDCEntries{})
-> sdbusplus::message::object_path;
/** @brief Notified on entry property changes
*
* If an entry is blocking, this callback will be registered to monitor for
* the entry having it's Resolved field set to true. If it is then remove
* the blocking object.
*
* @param[in] msg - sdbusplus dbusmessage
*/
void onEntryResolve(sdbusplus::message_t& msg);
/** @brief Remove block objects for any resolved entries */
void findAndRemoveResolvedBlocks();
/** @brief Quiesce host if it is running
*
* This is called when the user has requested the system be quiesced
* if a log with a callout is created
*/
void checkAndQuiesceHost();
/** @brief Persistent sdbusplus DBus bus connection. */
sdbusplus::bus_t& busLog;
/** @brief List of error ids for high severity errors */
std::list<uint32_t> realErrors;
/** @brief List of error ids for Info(and below) severity */
std::list<uint32_t> infoErrors;
/** @brief Id of last error log entry */
uint32_t entryId;
/** @brief The BMC firmware version */
const std::string fwVersion;
/** @brief Array of blocking errors */
std::vector<std::unique_ptr<Block>> blockingErrors;
/** @brief Map of entry id to call back object on properties changed */
std::map<uint32_t, std::unique_ptr<sdbusplus::bus::match_t>>
propChangedEntryCallback;
};
} // namespace internal
/** @class Manager
* @brief Implementation for deleting all error log entries and
* creating new logs.
* @details A concrete implementation for the
* xyz.openbmc_project.Collection.DeleteAll and
* xyz.openbmc_project.Logging.Create interfaces.
*/
class Manager : public details::ServerObject<DeleteAllIface, CreateIface>
{
public:
Manager() = delete;
Manager(const Manager&) = delete;
Manager& operator=(const Manager&) = delete;
Manager(Manager&&) = delete;
Manager& operator=(Manager&&) = delete;
virtual ~Manager() = default;
/** @brief Constructor to put object onto bus at a dbus path.
* Defer signal registration (pass true for deferSignal to the
* base class) until after the properties are set.
* @param[in] bus - Bus to attach to.
* @param[in] path - Path to attach at.
* @param[in] manager - Reference to internal manager object.
*/
Manager(sdbusplus::bus_t& bus, const std::string& path,
internal::Manager& manager) :
details::ServerObject<DeleteAllIface, CreateIface>(
bus, path.c_str(),
details::ServerObject<DeleteAllIface,
CreateIface>::action::defer_emit),
manager(manager) {};
/** @brief Delete all d-bus objects.
*/
void deleteAll() override
{
log<level::INFO>("Deleting all log entries");
auto numbersOfLogs = manager.eraseAll();
manager.createFromEvent(
LoggingCleared("NUMBER_OF_LOGS", numbersOfLogs));
}
/** @brief D-Bus method call implementation to create an event log.
*
* @param[in] errMsg - The error exception message associated with the
* error log to be committed.
* @param[in] severity - Level of the error
* @param[in] additionalData - The AdditionalData property for the error
*/
auto create(std::string message, Severity severity,
std::map<std::string, std::string> additionalData)
-> sdbusplus::message::object_path override
{
return manager.create(message, severity, additionalData);
}
/** @brief D-Bus method call implementation to create an event log with FFDC
*
* The same as create(), but takes an extra FFDC argument.
*
* @param[in] errMsg - The error exception message associated with the
* error log to be committed.
* @param[in] severity - Level of the error
* @param[in] additionalData - The AdditionalData property for the error
* @param[in] ffdc - A vector of FFDC file info
*/
void createWithFFDCFiles(
std::string message, Severity severity,
std::map<std::string, std::string> additionalData,
std::vector<std::tuple<CreateIface::FFDCFormat, uint8_t, uint8_t,
sdbusplus::message::unix_fd>>
ffdc) override
{
manager.create(message, severity, additionalData, ffdc);
}
private:
/** @brief This is a reference to manager object */
internal::Manager& manager;
};
} // namespace logging
} // namespace phosphor