CIM_LogEntry class

Represents a log entry.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

[UMLPackagePath("CIM::System::Logs"), Version("2.25.0"), AMENDMENT]
class CIM_LogEntry : CIM_RecordForLog
{
  string   Caption;
  string   Description;
  string   ElementName;
  string   RecordFormat;
  string   RecordData;
  string   Locale;
  uint16   PerceivedSeverity;
  string   InstanceID;
  string   LogInstanceID;
  string   LogName;
  string   RecordID;
  datetime CreationTimeStamp;
  string   MessageID;
  string   Message;
  string   MessageArguments[];
};

Members

The CIM_LogEntry class has these types of members:

• Properties

Properties

The CIM_LogEntry class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

The Caption property is a short textual description (one- line string) of the object.

This property is inherited from CIM_ManagedElement.

CreationTimeStamp

Data type: datetime

Access type: Read-only

A LogEntry may include a timestamp for the entry.

Description

Data type: string

Access type: Read-only

The Description property provides a textual description of the object.

This property is inherited from CIM_ManagedElement.

ElementName

Data type: string

Access type: Read-only

A user-friendly name for the object. This property allows each instance to define a user-friendly name in addition to its key properties, identity data, and description information.

This property is inherited from CIM_ManagedElement.

InstanceID

Data type: string

Access type: Read-only

Qualifiers: key, Override ("InstanceID")

Within the scope of the instantiating Namespace, InstanceID opaquely and uniquely identifies an instance of this class. In order to ensure uniqueness within the NameSpace, the value of InstanceID SHOULD be constructed using the following \'preferred\' algorithm:

<OrgID>:<LocalID>

Where <OrgID> and <LocalID> are separated by a colon \':\', and where <OrgID> MUST include a copyrighted, trademarked or otherwise unique name that is owned by the business entity creating/defining the InstanceID, or is a registered ID that is assigned to the business entity by a recognized global authority (This is similar to the <Schema Name>_<Class Name> structure of Schema class names.) In addition, to ensure uniqueness <OrgID> MUST NOT contain a colon (\':\'). When using this algorithm, the first colon to appear in InstanceID MUST appear between <OrgID> and <LocalID>.

<LocalID> is chosen by the business entity and SHOULD not be re-used to identify different underlying (real-world) elements. If the above \'preferred\' algorithm is not used, the defining entity MUST assure that the resultant InstanceID is not re-used across any InstanceIDs produced by this or other providers for this instance\'s NameSpace.

For DMTF defined instances, the \'preferred\' algorithm MUST be used with the <OrgID> set to \'CIM\'.

Locale

Data type: string

Access type: Read-only

A locale indicates a particular geographical, political, or cultural region. The Locale specifies the language used in creating the RecordForLog data. If the Locale property is empty, it is assumed that the default locale is en_US (English).

The locale string consists of three sub-strings, separated by underscores:

- The first sub-string is the language code, as specified in ISO639.

- The second sub-string is the country code, as specified in ISO3166.

- The third sub-string is a variant, which is vendor specific.

For example, US English appears as: "en_US_WIN", where the "WIN" variant would specify a Windows browser-specific collation (if one exists). Since the variant is not standardized, it is not commonly used and generally is limited to easily recognizable values ("WIN", "UNIX", "EURO", etc.) used in standard environments. The language and country codes are required; the variant may be empty.

This property is inherited from CIM_RecordForLog.

LogInstanceID

Data type: string

Access type: Read-only

Qualifiers: MaxLen (256)

The containing Log\'s InstanceID.

LogName

Data type: string

Access type: Read-only

Qualifiers: MaxLen (256)

The containing Log\'s Name. This property is available for backwards continuity with CIM_LogRecord.

Message

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_LogEntry.MessageID", "CIM_LogEntry.MessageArguments")

The formatted message. This message is constructed by combining some or all of the dynamic elements specified in the MessageArguments property with the static elements uniquely identified by the MessageID in a message registry or other catalog associated with the OwningEntity.

MessageArguments

Data type: string array

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_LogEntry.Message", "CIM_LogEntry.MessageID")

An array containing the dynamic content of the message.

Each DYNAMIC_ELEMENT for the message referred to by the MessageID property shall be contained in MessageArguments whether the DYNAMIC_ELEMENT is included in the Message or not.

In addition, the entries in MessageArguments need to be in the same order as the DYNAMIC_ELEMENTs.

MessageID

Data type: string

Access type: Read-only

Qualifiers: ModelCorrespondence ("CIM_LogEntry.Message", "CIM_LogEntry.MessageArguments")

A string that uniquely identifies, within the scope of the OwningEntity, the format of the Message.

PerceivedSeverity

Data type: uint16

Access type: Read-only

An enumerated value that describes the severity of the Indication from the notifier\'s point of view:

1 - Other, by CIM convention, is used to indicate that the Severity\'s value can be found in the OtherSeverity property.

3 - Degraded/Warning should be used when its appropriate to let the user decide if action is needed.

4 - Minor should be used to indicate action is needed, but the situation is not serious at this time.

5 - Major should be used to indicate action is needed NOW.

6 - Critical should be used to indicate action is needed NOW and the scope is broad (perhaps an imminent outage to a critical resource will result).

7 - Fatal/NonRecoverable should be used to indicate an error occurred, but it\'s too late to take remedial action.

2 and 0 - Information and Unknown (respectively) follow common usage. Literally, the Indication is purely informational or its severity is simply unknown.

This property is inherited from CIM_RecordForLog.

Unknown (0)

Other (1)

Information (2)

Degraded/Warning (3)

Minor (4)

Major (5)

Critical (6)

Fatal/NonRecoverable (7)

Requirements