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 方式轮换使用。