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:

  • Para el campo vmw_esxi_scsi_host_status, la definición agrega un campo vmw_esxi_scsi_host_status_label con un valor que es un nombre descriptivo. Por ejemplo, un valor de campo de "0x1" para vmw_esxi_scsi_host_status produce un valor de "NO_CONNECT" para vmw_esxi_scsi_host_status_label.
  • Para el campo vmw_esxi_scsi_device_status, la definición agrega un campo vmw_esxi_scsi_device_status_label con un valor que es un nombre descriptivo. Por ejemplo, un valor de campo de "0x2" para vmw_esxi_scsi_device_status produce un valor de "CHECK CONDITION" para vmw_esxi_scsi_device_status_label.
  • Para el campo vmw_esxi_scsi_sense_code, la definición agrega un campo vmw_esxi_scsi_device_sense_label con un valor que es un nombre descriptivo. Por ejemplo, un valor de campo de "0x3" para vmw_esxi_scsi_sense_code produce un valor de "MEDIUM ERROR" para vmw_esxi_scsi_device_sense_label.

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.

  • Para que el campo vmw_esxi_vmfs_name funcione correctamente, vRealize Log Insight primero debe recibir un mensaje de registro similar al siguiente:

    016-10-22T00:50:00.042Z host001.corp.local Hostd: info hostd[5179FB70] [Originator@6876 sub=Libs]
    VmFileSystem: uuid:57925c06-0a8a627e-9f0b-b82a72d50b06, Label:datastore001,logicalDevice:57925c05-63b188db-37da-b82a72d50b06, headExtent:naa.6b083fe0c212bd001f22e05d07099022:1

    La consulta utilizada para encontrar la coincidencia con este evento es hostd VmFileSystem Label headExtent naa*. Para cada valor del campo vmw_esxi_device_id encontrado, vRealize Log Insight asigna el valor del campo vmw_esxi_vmfs_label al campo vmw_esxi_vmfs_name. En este ejemplo, el campo vmw_esxi_device_id es "naa.6b083fe0c212bd001f22e05d07099022" y el campo vmw_esxi_vmfs_label es "datastore001". Tras registrarse este evento, la ejecución de una consulta con un filtro en el cual el campo vmw_esxi_vmfs_name contiene un nombre de almacén de datos devuelve los mensajes de registro que contienen "naa.6b083fe0c212bd001f22e05d07099022".

  • Para que el campo vmw_esxi_datastore_name funcione correctamente, vRealize Log Insight primero debe recibir un mensaje de registro similar al siguiente:

    2016-11-24T03:56:47.738Z host002.corp.local vobd:  [scsiCorrelator] 4851129307827us: [esx.clear.storage.redundancy.restored]
    Path redundancy to storage device naa.6006016006502a004b1c42e756fbe411 (Datastores: "datastore002") restored. Path vmhba39:C0:T1:L2 is active again.

    La consulta utilizada para encontrar la coincidencia con este evento es scsiCorrelator storage Datastores naa*. Para cada valor único que se encuentre en el campo vmw_esxi_device_id, vRealize Log Insight asigna el valor del campo vmw_esxi_datastore al campo vmw_esxi_datastore_name. En este ejemplo, el campo vmw_esxi_device_id es "naa.6006016006502a004b1c42e756fbe411" y el campo vmw_esxi_datastore es "datastore002". Tras registrarse este evento, la ejecución de una consulta con un filtro en el cual el campo vmw_esxi_datastore_name contiene un nombre de almacén de datos devuelve los mensajes de registro que contienen "naa.6006016006502a004b1c42e756fbe411".

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.