vRealize Log Insight 会将预定义的 vSphere 数据存储名称映射到设备 ID。由于此映射,您可以在查询中使用作为设备 ID 别名的数据存储名称。查询会查找包含数据存储名称或以该数据存储名称作为别名的设备 ID 的消息。在启用别名之前,vRealize Log Insight 必须在消息中收到键(数据存储名称)及其值(数据存储 ID)。
别名在 VMware-vSphere 内容包中定义。别名可以是静态或动态的。
静态别名
静态别名使用以下字段配置:
字段 | 描述 |
---|---|
aliasFields | 给定 searchField 的 value 到 key 的静态映射。 |
name | 别名字段的名称。 |
searchField | 需要别名的字段的名称。 |
value | 要匹配的 searchField 的值。 |
key | 要与包含 searchField 的事件一起显示的别名。 |
definition | 静态别名定义为:"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" }] }], 对于每个现有字段,此定义将添加另一个具有用户友好名称值的字段:
|
动态别名
动态别名使用以下字段配置:
字段 | 描述 |
---|---|
aliasRules | associatedFields 的 valueField 到 keyField 的动态映射。 |
name | 标识别名的唯一名称(仅限内部)。 |
keyField | 应将动态别名映射到的字段。 |
valueField | 与提供别名值的 keyField 位于同一事件中的第二个字段。 |
aliasFieldName | 要在包含 keyField 的事件旁边显示的别名字段的名称。 |
associatedFields | 应显示 aliasFieldName 的一个或多个字段。 |
definition | 动态别名定义为:"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" ] }], 要使动态别名字段正常工作,vRealize Log Insight 需要记录特定消息以构建别名。
|
别名的要求
要使用别名,请确保满足以下要求:
- 您使用的是 vRealize Log Insight 4.0 或更高版本。
- 您使用的是 VMware - vSphere 内容包 4.0 或更高版本。vRealize Log Insight 中包含此内容包。
- ESXi 配置为将日志发送到 vRealize Log Insight。
- 第一个同时包含键和值的事件经过数据获取管道后,最少要间隔五分钟。
别名的限制
使用别名时存在以下限制:
- 不能将别名与数学函数(例如,平均值、最小值、最大值等)一起使用。
- 不能将别名与“存在”和“不存在”运算符一起使用。
- 不能在日志转发中转发别名。
- 每个节点最多可以学习 100,000 个别名,超出的别名将按 FIFO 方式轮换使用。