vRealize Log Insight ordnet vordefinierte vSphere-Datenspeichernamen Geräte-IDs zu. Aufgrund dieser Zuordnung können Sie Datenspeichernamen verwenden, die Aliasnamen für Geräte-IDs in Abfragen darstellen. Die Abfrage findet Nachrichten mit dem Namen des Datenspeichers oder mit der Geräte-ID, für die ein Alias verwendet wird. vRealize Log Insight muss in Nachrichten sowohl den Schlüssel (Datenspeichername) als auch dessen Wert (Datenspeicher-ID) empfangen, bevor der Alias aktiviert werden kann.
Aliase werden im VMware-vSphere-Inhaltspaket definiert. Aliase können statisch oder dynamisch sein.
Statische Aliase
Statische Aliase werden mithilfe der folgenden Felder konfiguriert:
| Feld | Beschreibung |
|---|---|
| aliasFields | Die statische Zuordnung eines value (Wert) zu einem key (Schlüssel) für ein bestimmtes searchField (Suchfeld). |
| name | Der Name des Alias-Felds. |
| searchField | Der Name des Felds, für das ein Alias gewünscht wird. |
| value | Der Wert von searchField, der übereinstimmen soll. |
| key | Der Alias, der mit Ereignissen angezeigt werden soll, die searchField enthalten. |
| definition | Ein statischer Alias ist wie folgt definiert:"aliasFields":[{
"name":"vmw_esxi_scsi_host_status",
"searchField":"vmw_esxi_scsi_host_status_label",
"aliases":[{
"key":"OK", "value":"0x0"},{
"key":"NO_CONNECT", "value":"0x1"},{
"key":"BUS_BUSY", "value":"0x2"},{
"key":"TIME_OUT", "value":"0x3"},{
"key":"BAD_TARGET", "value":"0x4"},{
"key":"ABORT", "value":"0x5"},{
"key":"PARITY", "value":"0x6"},{
"key":"ERROR", "value":"0x7"},{
"key":"RESET", "value":"0x8"},{
"key":"BAD_INTR", "value":"0x9"},{
"key":"PASSTHROUGH", "value":"0xa"},{
"key":"SOFT_ERROR", "value":"0xb"
}]
},{
"name":"vmw_esxi_scsi_device_status",
"searchField":"vmw_esxi_scsi_device_status_label",
"aliases":[{
"key":"GOOD", "value":"0x0"},{
"key":"CHECK CONDITION", "value":"0x2"},{
"key":"CONDITION MET", "value":"0x4"},{
"key":"BUSY", "value":"0x8"},{
"key":"RESERVATION CONFLICT", "value":"0x18"},{
"key":"TASK SET FULL", "value":"0x28"},{
"key":"ACA ACTIVE", "value":"0x30"},{
"key":"TASK ABORTED", "value":"0x40"
}]
},{
"name":"vmw_esxi_scsi_sense_code",
"searchField":"vmw_esxi_scsi_sense_label",
"aliases":[{
"key":"NO SENSE", "value":"0x0"},{
"key":"RECOVERED ERROR", "value":"0x1"},{
"key":"NOT READY", "value":"0x2"},{
"key":"MEDIUM ERROR", "value":"0x3"},{
"key":"HARDWARE ERROR", "value":"0x4"},{
"key":"ILLEGAL REQUEST", "value":"0x5"},{
"key":"UNIT ATTENTION", "value":"0x6"},{
"key":"DATA PROTECT", "value":"0x7"},{
"key":"BLANK CHECK", "value":"0x8"},{
"key":"VENDOR SPECIFIC", "value":"0x9"},{
"key":"COPY ABORTED", "value":"0xA"},{
"key":"ABORTED COMMAND", "value":"0xB"},{
"key":"VOLUME OVERFLOW", "value":"0xD"},{
"key":"MISCOMPARE", "value":"0xE"
}]
}],Für jedes vorhandene Feld fügt diese Definition ein weiteres Feld mit Werten hinzu, die benutzerfreundliche Namen aufweisen:
|
Dynamische Aliase
Dynamische Aliase werden mithilfe der folgenden Felder konfiguriert:
| Feld | Beschreibung |
|---|---|
| aliasRules | Die dynamische Zuordnung eines valueField zu einem keyField für associatedFields. |
| name | Ein eindeutiger Name zur Identifizierung des Alias (nur intern). |
| keyField | Das Feld, für das ein dynamischer Alias zugeordnet werden soll. |
| valueField | Ein zweites Feld in demselben Fall wie keyField, das den Aliaswert enthält. |
| aliasFieldName | Der Name des Aliasfelds, das neben den Ereignissen angezeigt wird, die keyField enthalten. |
| associatedFields | Das Feld oder die Felder, für die aliasFieldName angezeigt werden soll. |
| definition | Ein dynamischer Alias ist wie folgt definiert:"aliasRules":[{
"name":"DatastoreFromVmFileSystem",
"filter":"hostd VmFileSystem Label headExtent naa*",
"keyField":"vmw_esxi_device_id",
"valueField":"vmw_esxi_vmfs_label",
"aliasFieldName":"vmw_esxi_vmfs_name",
"associatedFields":[
"vmw_esxi_device_id"
]
},{
"name":"DatastoreFromScsiCorrelator",
"filter":"scsiCorrelator storage Datastores naa*",
"keyField":"vmw_esxi_device_id",
"valueField":"vmw_esxi_datastore",
"aliasFieldName":"vmw_esxi_datastore_name",
"associatedFields":[
"vmw_esxi_device_id"
]
}],Damit die dynamischen Aliasfelder funktionieren können, müssen für vRealize Log Insight bei der Erstellung der Aliase bestimmte Meldungen protokolliert werden.
|
Voraussetzungen für Aliase
Für die Verwendung von Aliasen müssen die folgenden Voraussetzungen erfüllt sein:
- Sie verwenden vRealize Log Insight 4.0 oder höher.
- Sie verwenden das VMwarevSphere-Inhaltspaket 4.0 oder höher. vRealize Log Insight enthält dieses Inhaltspaket.
- ESXi ist so konfiguriert, dass Protokolle an vRealize Log Insight gesendet werden.
- Es gibt eine Lücke von mindestens fünf Minuten, nachdem das erste Ereignis, das sowohl den Schlüssel als auch den Wert enthält, durch die Aufnahme-Pipeline geleitet wird.
Einschränkungen für Aliase
Für die Verwendung von Aliasen gelten die folgenden Einschränkungen:
- Aliasnamen mit mathematischen Funktionen, z. B. avg, min, max usw., können nicht verwendet werden.
- Aliase mit den Operatoren „ist vorhanden“ und „ist nicht vorhanden“ können nicht verwendet werden.
- Aliase werden nicht als Teil der Protokollweiterleitung weitergeleitet.
- Pro Knoten können bis zu 100.000 Aliase gelernt werden. Bei mehr Aliasen werden die vorhandenen Aliase nach dem FIFO-Prinzip (first in, first out) überschrieben.
