本文介绍了机器及机器组的配置参数及完整资源示例。
机器
当机器安装Logtail并正常启动后,会根据Logtail配置中的用户信息自动关联到当前用户。
每台机器属性如下:
{
"ip" : "testip1",
"machine-uniqueid" : "testuuid1",
"userdefined-id" : "testuserdefinedid1",
"lastHeartbeatTime":1397781420
}
机器属性参数如下:
参数名称 | 类型 | 描述 |
ip | string | 机器hostname对应的IP地址。 |
uuid | string | 机器标识的唯一主键,由Logtail上传。 |
userdefined-id | string | 用户自定义机器标识,由Logtail上传。 |
lastHeartbeatTime | integer | 机器的最后心跳时间(从epoch时间开始的秒数)。 |
机器组
日志服务通过一个Logtail采集配置来采集多台服务器上的日志,您可以将这些服务器加入到同一个机器组,并将Logtail采集配置应用到该机器组。您可以通过如下两种方法定义一个机器组。
IP地址:在机器组中添加服务器的IP地址,通过IP地址识别服务器。
自定义标识:定义属于机器组的一个标识,在对应服务器上配置对应标识进行关联。
机器组命名规则:
只能包括小写字母、数字、连字符(-)和下划线(_)
必须以小写字母或者数字开头和结尾
长度必须在2~128字节以内
完整资源示例
{ "groupName" : "testgroup",
"groupType" : "",
"groupAttribute" : {
"externalName" : "testgroup",
“groupTopic": "testgrouptopic"
},
"machineIdentifyType": "ip",
"machineList" : [
"ip1",
"ip2"
…
],
"createTime": 1431705075,
"lastModifyTime" : 1431705075
}
机器组参数说明如下:
属性名称 | 类型 | 必须 | 描述 |
groupName | string | 是 | 机器组名称,Project下唯一。 |
groupType | string | 否 | 机器组类型,默认为空。 |
machineIdentifyType | string | 是 | 机器标识类型,分为IP和userdefined两种。 |
groupAttribute | object | 是 | 机器组的属性,默认为空。 |
machineList | array | 是 | 具体的机器标识,可以是IP或userdefined-id。 |
createTime | int | 否 | 该机器组创建时间。 |
lastModifyTime | int | 否 | 该机器组更新时间。 |
groupAttribute说明如下:
属性名称 | 类型 | 是否必须 | 描述 |
groupTopic | string | 否 | 机器组的Topic,默认为空。 |
externalName | string | 否 | 机器组所依赖的外部管理标识,默认为空。 |