vRealize Log Insight에서는 미리 정의된 vSphere 데이터스토어 이름을 디바이스 ID에 매핑합니다. 이 매핑으로 인해 쿼리에서 디바이스 ID에 대한 별칭에 해당하는 데이터스토어 이름을 사용할 수 있습니다. 쿼리는 별칭이 지정된 데이터스토어 이름이나 디바이스 ID를 포함하는 메시지를 찾습니다. vRealize Log Insight 별칭을 사용하도록 설정하기 전에 메시지에서 키(데이터스토어 이름) 및 해당 값(데이터스토어 ID)을 모두 수신해야 합니다.
별칭은 VMware vSphere 컨텐츠 팩에서 정의됩니다. 별칭은 정적이거나 동적일 수 있습니다.
정적 별칭
정적 별칭은 다음 필드를 사용하여 구성됩니다.
| 필드 | 설명 |
|---|---|
| aliasFields | 지정된 searchField의 key에 대한 value 값의 정적 매핑입니다. |
| name | 별칭 필드의 이름입니다. |
| searchField | 별칭이 필요한 필드의 이름입니다. |
| value | 일치시킬 searchField의 값입니다. |
| key | searchField를 포함하는 이벤트와 함께 표시할 별칭입니다. |
| 정의 | 정적 별칭은 다음과 같이 정의됩니다."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 | valueField에서 associatedFields에 대한 keyField로의 동적 매핑입니다. |
| name | 별칭을 식별하는 고유한 이름입니다(내부에만 해당). |
| keyField | 동적 별칭을 매핑할 필드입니다. |
| valueField | 별칭 값을 제공하는 keyField와 동일한 이벤트의 두 번째 필드입니다. |
| aliasFieldName | keyField를 포함하는 이벤트 옆에 표시할 별칭 필드의 이름입니다. |
| associatedFields | aliasFieldName을 표시해야 하는 필드입니다. |
| 정의 | 동적 별칭은 다음과 같이 정의됩니다."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에 로그를 보내도록 구성되어 있습니다.
- 키와 값을 모두 포함하는 첫 번째 이벤트가 수집 파이프라인을 통과하고 5분의 최소 간격이 적용됩니다.
별칭에 대한 제한 사항
별칭 사용에는 다음과 같은 제한 사항이 적용됩니다.
- 산술 함수(예: avg, min, max 등)에는 별칭을 사용할 수 없습니다.
- 별칭을 "존재함" 및 "존재하지 않음" 연산자와 함께 사용할 수 없습니다.
- 별칭은 로그 전달의 일부로 전달되지 않습니다.
- 노드당 최대 10만 개의 별칭을 학습할 수 있으며 그 이후에는 FIFO 방식으로 회전됩니다.
