Logtail机器组

本文介绍了机器及机器组的配置参数及完整资源示例。

机器

当机器安装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

机器组所依赖的外部管理标识,默认为空。