vRealize Log Insight asigna los nombres de los almacenes de datos de vSphere predefinidos a los identificadores de dispositivo. Debido a esta asignación, puede utilizar nombres de almacenes de datos que sean alias para los identificadores de dispositivo en las consultas. La consulta busca mensajes con el nombre del almacén de datos o el identificador de dispositivo para el que tiene un alias asignado. vRealize Log Insight debe recibir la clave (nombre del almacén de datos) y su valor (identificador de almacén de datos) en los mensajes antes de que se pueda habilitar el alias.
Los alias se definen en el paquete de contenido (Content Pack) de VMware-vSphere. Los alias pueden ser estáticos o dinámicos.
Alias estáticos
Los alias estáticos se configuran mediante los siguientes campos:
| Campo | Descripción |
|---|---|
| aliasFields | La asignación estática de un valor (value) a una clave (key) para un campo de búsqueda (searchField) determinado. |
| name | El nombre del campo de alias. |
| searchField | El nombre del campo para el que se desea un alias. |
| value | El valor de searchField para el que se debe encontrar la coincidencia. |
| key | El alias que se muestra con eventos que contienen searchField. |
| definition | Un alias estático se define de la siguiente manera:"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"
}]
}],Para cada campo existente, esta definición agrega otro campo con valores que tienen nombres descriptivos:
|
Alias dinámicos
Los alias dinámicos se configuran mediante los siguientes campos:
| Campo | Descripción |
|---|---|
| aliasRules | La asignación dinámica de un campo de valor (valueField) a un campo de clave (keyField) para campos asociados (associatedFields). |
| name | Un nombre único para identificar el alias (solo interno). |
| keyField | El campo al que se debe asignar un alias dinámico. |
| valueField | Un segundo campo en el mismo evento que el campo keyField que proporciona el valor de alias. |
| aliasFieldName | El nombre del campo de alias que se mostrará junto a los eventos que contienen keyField. |
| associatedFields | El campo o los campos para los que debe aparecer aliasFieldName. |
| definition | Un alias dinámico se define de la siguiente manera:"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"
]
}],Para que los campos de alias dinámico funcionen, vRealize Log Insight requiere que se registren mensajes específicos para crear los alias.
|
Requisitos para los alias
Para utilizar alias, asegúrese de que:
- Está utilizando vRealize Log Insight 4.0 o una versión posterior.
- Está utilizando el paquete de contenido (Content Pack) 4.0 de VMware - vSphere o una versión posterior. vRealize Log Insight incluye este paquete de contenido.
- ESXi está configurado para enviar registros a vRealize Log Insight.
- Hay un intervalo mínimo de cinco minutos después de que el primer evento que contiene la clave y el valor pase por la canalización de consumo.
Restricciones para los alias
Se aplican las siguientes restricciones al uso de alias:
- No puede utilizar alias con funciones matemáticas, por ejemplo, avg, min, max, etc.
- No puede utilizar alias con los operadores "exist" y "does not exist".
- Los alias no se reenvían como parte del reenvío de registros.
- Se pueden aprender hasta 100.000 alias por nodo, tras lo cual se rotan al estilo FIFO.
