Logtail がインストールされているマシンが正常に起動すると、Logtail 設定のユーザー情報に基づいて、マシンは自動的に現在のユーザーに関連付けられます。
現在、マシンは次の 3 つの方法で識別できます。
- IP:ホスト名に対応する IP アドレス。 最も理解しやすい方法ですが、IP アドレスが VPC およびその他の環境で複製される可能性があります。
- UUID (machine-uniqueid):DMI デバイスの UUID。 詳細については、「RFC4122」をご参照ください。
- Userdefined-id: Logtail ディレクトリでマシン ID をカスタマイズできます。
各マシンの属性は次のとおりです。
{
"ip" : "testip1",
"machine-uniqueid" : "testuuid1",
"userdefined-id" : "testuserdefinedid1",
"lastHeartbeatTime":1397781420
}
マシンプロパティパラメータは次のとおりです。
パラメーター | データ型 | 説明 |
---|---|---|
ip | string | マシンホスト名に対応する IP アドレス |
uuid | string | Logtail によってアップロードされたマシン ID の固有の主キー |
userdefined-id | string | Logtail によってアップロードされたユーザー定義のマシン ID |
lastHeartbeatTime(output-only) | integer | マシンの最後のハートビート時間 (エポック時間からの秒数) |
machinegroup
machinegroup は、プロジェクト内の現在のユーザーに属するマシングループです。 IP アドレスまたはユーザー定義の ID を使用して、プロジェクト内のマシン グループを識別できます。 IP アドレスの方が識別は簡単ですが、 ユーザー定義の ID を使用すれば VPC 環境内で同一の IP アドレスが存在する問題を解決できます。 2 つのマシン識別方法のいずれかを選択できます。
マシングループの命名規則:
- 名前には、小文字、数字、ハイフン ( - )、アンダースコア ( _ ) のみを使用できます。
- 名前の始まりと終わりは、小文字または数字でなければなりません。
- 名前は 2 ~ 128 バイトの長さでなければなりません。
完全なリソースの例:
{
"groupName" : "testgroup",
"groupType" : "",
"groupAttribute" : {
"externalName" : "testgroup",
"groupTopic": "testgrouptopic"
},
"machineIdentifyType": "ip",
"machineList" : [
"ip1",
"ip2"
…
],
"createTime": 1431705075,
"lastModifyTime" : 1431705075
}
属性名 | データ型 | 必須/省略可能 | 説明 |
---|---|---|---|
groupName | string | 必須 | 同じプロジェクト内で一意のマシングループ名 |
groupType | string | 省略可能 | マシングループタイプ (デフォルトは空) |
machineIdentifyType | string | 必須 | IP およびユーザー定義 ID を含むマシン識別タイプ |
groupAttribute | object | 必須 | マシン グループ属性 (デフォルトでは空) |
machineList | array | 必須 | IP アドレスまたはユーザー定義 ID を指定できる特定のマシン識別情報 |
createTime(output-only) | int | 省略可能 | リソースの作成時間 |
lastModifyTime(output-only) | int | 省略可能 | リソースサーバーの更新時刻 |
以下は groupAttribute の説明です。
属性名 | データ型 | 必須/省略可能 | 説明 |
---|---|---|---|
groupTopic | string | 省略可能 | マシングループのトピック (デフォルトは空) |
externalName | string | 省略可能 | マシングループが依存する外部 ID (デフォルトは空) |