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
 }
マシンプロパティパラメータは次のとおりです。
表 1. パラメータの説明
パラメーター データ型 説明
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
}
表 2. 説明
属性名 データ型 必須/省略可能 説明
groupName string 必須 同じプロジェクト内で一意のマシングループ名
groupType string 省略可能 マシングループタイプ (デフォルトは空)
machineIdentifyType string 必須 IP およびユーザー定義 ID を含むマシン識別タイプ
groupAttribute object 必須 マシン グループ属性 (デフォルトでは空)
machineList array 必須 IP アドレスまたはユーザー定義 ID を指定できる特定のマシン識別情報
createTime(output-only) int 省略可能 リソースの作成時間
lastModifyTime(output-only) int 省略可能 リソースサーバーの更新時刻
以下は groupAttribute の説明です。
表 3. groupAttribute の説明
属性名 データ型 必須/省略可能 説明
groupTopic string 省略可能 マシングループのトピック (デフォルトは空)
externalName string 省略可能 マシングループが依存する外部 ID (デフォルトは空)