| Adriana Kobylak | 8a0fd71 | 2016-11-14 16:05:52 -0600 | [diff] [blame] | 1 | description: > |
| 2 | Implement to provide event/error entry attributes. |
| 3 | This interface should be instantiated for the phosphor::logging namespace. |
| 4 | This interface is a collection of objects, therefore it is required to |
| 5 | implement org.freedesktop.DBus.ObjectManager on the logging namespace root. |
| 6 | Optionally, implement org.openbmc.Object.Delete to allow the deletion of |
| 7 | individual entries. |
| 8 | properties: |
| 9 | - name: Id |
| 10 | type: uint32 |
| 11 | description: > |
| 12 | The error event entry id number. |
| Adriana Kobylak | 06e5b23 | 2017-01-22 14:36:55 -0600 | [diff] [blame] | 13 | - name: Timestamp |
| 14 | type: uint64 |
| 15 | description: > |
| 16 | Commit timestamp of the error event entry in milliseconds since 1970. |
| Adriana Kobylak | 8a0fd71 | 2016-11-14 16:05:52 -0600 | [diff] [blame] | 17 | - name: Severity |
| 18 | type: enum[self.Level] |
| 19 | description: > |
| 20 | The severity of the error event entry. |
| 21 | - name: Message |
| 22 | type: string |
| 23 | description: > |
| 24 | The message description of the error event entry. |
| 25 | - name: AdditionalData |
| 26 | type: array[string] |
| 27 | description: > |
| 28 | Additional information in the form of metadata field strings VAR=val |
| Deepak Kodihalli | 9bd626a | 2017-03-27 03:32:25 -0500 | [diff] [blame] | 29 | - name: Resolved |
| 30 | type: boolean |
| 31 | description: > |
| 32 | Error resolution status. Indicate if the problem being reported by |
| 33 | this error log has been resolved. This will start out 'false' by |
| 34 | default. Setting this to 'true' will NOT result in the error log being |
| 35 | deleted. |
| Matt Spinler | 05dd968 | 2020-02-25 12:34:52 -0600 | [diff] [blame] | 36 | - name: UpdateTimestamp |
| 37 | type: uint64 |
| 38 | description: > |
| 39 | The timestamp when any property was last modified, in milliseconds |
| 40 | since the epoch (1 Jan 1970 00:00:00 UTC). As only the |
| 41 | Resolved property has a reason to change, a value that doesn't |
| 42 | match the Timestamp property's value (which indicates when the |
| 43 | log was created) would indicate that Resolved was changed. |
| Adriana Kobylak | 8a0fd71 | 2016-11-14 16:05:52 -0600 | [diff] [blame] | 44 | |
| 45 | enumerations: |
| 46 | - name: Level |
| 47 | description: > |
| 48 | Possible severity levels for an error log entry. |
| 49 | values: |
| 50 | - name: Emergency |
| 51 | description: > |
| 52 | System is unusable. |
| 53 | - name: Alert |
| 54 | description: > |
| 55 | Should be corrected immediately. |
| 56 | - name: Critical |
| 57 | description: > |
| 58 | Critical condition. |
| 59 | - name: Error |
| 60 | description: > |
| 61 | Error condition. |
| 62 | - name: Warning |
| 63 | description: > |
| 64 | An error may occur if action is not taken. |
| 65 | - name: Notice |
| 66 | description: > |
| 67 | Unusual condition, but not an error. |
| 68 | - name: Informational |
| 69 | description: > |
| 70 | Normal operational message that does not require action. |
| 71 | - name: Debug |
| 72 | description: > |
| 73 | Information useful to developers for debugging the application. |
| 74 | |
| Adriana Kobylak | 66119c0 | 2021-02-04 13:23:58 -0600 | [diff] [blame] | 75 | methods: |
| 76 | - name: GetEntry |
| 77 | description: > |
| 78 | Returns the file descriptor to the raw Entry file, which is a binary blob. |
| 79 | The mode of the file descriptor is to be reaad-only. |
| 80 | returns: |
| 81 | - name: fd |
| 82 | type: unixfd |
| 83 | description: > |
| 84 | The file descriptor to the Entry file. |