Event Logger stores events that are created by a number of operating system clients (e.g. events for incoming text messages generated by the SMS stack). These events are later retrieved by applications so the user can see a history of the events that have occurred on their device.
The Symbian/S60 Log application uses Event Logger to show a list of recent calls, packet data and other chargeable connections.
Event Logger has a client-server architecture and uses a DBMS database to manage the event log. The Event Logger API has been supported since S60 2nd Edition. It was previously known as log engine (logeng).
Event Logger API
Event Logger clients should link to logwrap.lib and logcli.lib.
| API | Purpose |
|---|---|
| CLogActive (logwrap.h) |
Abstract base class that defines common active object behaviour for event logger classes such as CLogViewRecent |
| CLogBase (logwrap.h) |
Used by client code to perform simple actions on the log database like adding a new event |
| CLogClient (logcli.h) |
The API to retrieve events from the log and administer the log database |
| CLogCntModel (logcntmodel.h) |
Base class for ECom plugin to resolve contact information from a phone number |
| CLogEvent (logwrap.h) |
Encapsulates the details of an event |
| CLogEventType (logcli.h) |
Event type, e.g. call, packet data, SMS, LBS transmit location etc. |
| CLogFilter (logcli.h) |
Specifies the conditions that events must satisfy to appear in a view |
| CLogFilterList (logcli.h) |
A collection of event view filters |
| CLogView (logview.h) |
Base class for log database views |
| CLogViewDuplicate (logview.h) |
A view of events that are duplicates of a specific event |
| CLogViewEvent (logview.h) |
A view of the event log |
| CLogViewRecent (logview.h) |
A view of recent events |
| CLogWrapper (logwrap.h) |
Wrapper around the event logger provided for compatibility reasons |
| MLogClientChangeObserver (logclientchangeobserver.h) |
Allows a client to observe specific change events (event log cleared, view refresh required) |
| MLogCntModel (logcntmodel.h) |
An interface to decouple Event Logger from the Contacts implementation |
| MLogViewChangeObserver (logviewchangeobserver.h) |
Allows a client to observe specific change events (event added/changed/deleted) within a given view |
| TLogConfig (logcli.h) |
Encapsulates Log Engine configuration data, such as the maximum number of events the event log holds |
| TLogSmsPduData (logsmspdudata.h) |
Used to store SMS PDU (protocol description unit) info in event data |
Further resources
- Reference documentation for Event Logger
- How To Use the Log Engine from developer.symbian.org
- Example code (S60 Platform: Log Example) from Forum Nokia
Coming up next…
File Logger is the next component in the Persistentdata for beginners series. It provides a logging API for debugging and other purposes.
Leave a Reply