Simple Log Service:Logtail のインストール、実行、アップグレード、およびアンインストール

Logtail のインストール

Logtail をワンクリックインストールまたは手動インストールでインストールできます。ワンクリックインストールは、プロジェクトと同じリージョンにあり、かつ同一の Alibaba Cloud アカウント（root ユーザー）に属する ECS インスタンスを使用する場合のみサポートされます。それ以外の場合は、Logtail を手動でインストールする必要があります。

# 内部ネットワーク経由でダウンロード
wget http://logtail-release-${region_id}.oss-${region_id}-internal.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 
# インターネット経由でダウンロード
wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; 

# インターネット経由でインストール
chmod +x logtail.sh; ./logtail.sh install ${region_id}-internet
# オンプレミスデータセンターまたは中国国外のクラウドベンダーのサーバーの場合、インターネット経由のデータ転送は高遅延および不安定になる可能性があります。転送アクセラレーションの使用を推奨します。
chmod +x logtail.sh; ./logtail.sh install ${region_id}-acceleration
# 内部ネットワーク経由でインストール（内部ネットワークにアクセス可能なオンプレミスデータセンター向け）
chmod +x logtail.sh; ./logtail.sh install ${region_id}

# インターネット経由でインストール
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-internet
# オンプレミスデータセンターまたは中国国外のクラウドベンダーのサーバーの場合、インターネット経由のデータ転送は高遅延および不安定になる可能性があります。転送アクセラレーションの使用を推奨します。
chmod +x logtail.sh; ./logtail.sh install-local ${region_id}-acceleration

# インターネット経由でインストール
.\logtail_installer.exe install ${region_id}-internet
# オンプレミスデータセンターまたは中国国外のクラウドベンダーのサーバーの場合、インターネット経由のデータ転送は高遅延および不安定になる可能性があります。転送アクセラレーションの使用を推奨します。
.\logtail_installer.exe install ${region_id}-acceleration

Logtail の一括インストール

以下のいずれかの方法を使用して、Logtail を一括でインストールします。

• OOS オーケストレーション：権限要件があるシナリオに適しています。高い同時実行性をサポートし、大規模な一括操作に最適です。詳細については、「OOS を使用した Logtail の一括インストールおよびアップグレード」をご参照ください。

• ECS クラウドアシスタント：使いやすい方法です。一時的なタスクを実行するためにコマンドを実行します。手順は以下のとおりです。

1. ECS コンソール - ECS クラウドアシスタント に移動します。

2. 上部のナビゲーションバーで、管理対象のリソースのリージョンおよびリソースグループを選択します。

3. ECS クラウドアシスタント ページの右上隅で、コマンドの作成／実行 をクリックします。

4. コマンドの作成 パネルで、コマンド内容 フィールドにインストールコマンドを入力します。この例ではインターネット経由のインストール方法を使用します。その他のインストールコマンドについては、「Logtail のインストール」をご参照ください。

   

   ここで使用するインストールコマンドは以下のとおりです。

   #!/bin/bash
   region_id='cn-hangzhou'
   wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh
   chmod +x logtail.sh
   ./logtail.sh install ${region_id}-internet

   重要

   Logtail をインストールした後、ECS インスタンスのネットワークタイプをクラシックネットワークから VPC に切り替えた場合、Logtail 構成を更新する必要があります。詳細については、「ECS インスタンスをクラシックネットワークから VPC に切り替えた後にマシングループ構成を更新するには？」をご参照ください。

5. インスタンスの選択 セクションで、対象インスタンスのエージェントステータスが 正常 であることを確認します。ステータスが「正常」でない場合は、「クラウドアシスタントエージェントのインストール」を参照してクラウドアシスタントをインストールしてください。対象インスタンスを選択し、実行 をクリックします。実行ステータスが 成功 になります。実行に失敗した場合は、「実行結果の確認と一般的な問題の修正」をご参照ください。

Logtail の起動および停止

Logtail のステータスおよびバージョンの確認

cat /usr/local/ilogtail/app_info.json

{
   "logtail_version" : "0.16.30",
}

{
    "logtail_version" : "1.0.0.0"
}

Logtail のアップグレード

stop successfully
Stop logtail successfully.
Upgrading logtail files ...
Upgrade logtail files successfully.
Starting logtail ...
ilogtail is running
Upgrade logtail successfully.
{
        "UUID" : "XXXXXXXX-XXXX",
        "compiler" : "GCC 9.3.1",
        "hostname" : "xxx",
        "instance_id" : "XXXXXXXX-XXXX_172.16.0.75_1730950372",
        "ip" : "172.16.0.75",
        "logtail_version" : "2.0.8",
        "os" : "Linux; 5.10.134-13.an8.x86_64; #1 SMP Mon Jan 9 10:39:46 CST 2023; x86_64",
        "update_time" : "2024-11-07 11:32:52"
}

Logtail のアンインストール

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh -O logtail.sh; chmod +x logtail.sh; ./logtail.sh uninstall

.\logtail_installer.exe uninstall

Logtail コンポーネントのインストール

ACK クラスターを使用しており、そのクラスターが SLS と同じ Alibaba Cloud アカウントに属する場合は、ACK クラスター向けの手順に従ってください。セルフマネージドクラスターを使用する場合、または ACK クラスターと SLS が異なる Alibaba Cloud アカウントに属する場合は、セルフマネージドクラスター向けの手順に従ってください。

Logtail のステータス、バージョン、および IP アドレスの確認

• 以下のコマンドを実行して Logtail のステータスを確認します。

  kubectl get po -n kube-system | grep logtail

  以下の結果が返されます。

  NAME            READY     STATUS    RESTARTS   AGE
  logtail-ds-gb92k   1/1       Running   0          2h
  logtail-ds-wm7lw   1/1       Running   0          4d

• 以下のコマンドを実行して、Logtail のバージョン番号および IP アドレスなどの情報を表示します。

  kubectl exec logtail-ds-gb92k -n kube-system cat /usr/local/ilogtail/app_info.json

  以下の結果が返されます。

  {
     "hostname" : "logtail-ds-gb92k",
     "instance_id" : "0EBB2B0E-0A3B-11E8-B0CE-0A58AC140402_172.20.4.2_1517810940",
     "ip" : "192.0.2.0",
     "logtail_version" : "0.16.2",
     "os" : "Linux; 3.10.0-693.2.2.el7.x86_64; #1 SMP Tue Sep 12 22:26:13 UTC 2017; x86_64",
     "update_time" : "2021-02-05 06:09:01"
  }

Logtail のアップグレードおよびロールバック

1. アップグレード前に、Logtail コンポーネントに関連する記述ファイルをバックアップします。

   重要

   アップグレード前に大きな収集遅延が発生している場合、アップグレードによって少量のログ損失が発生する可能性があります。

   kubectl get ds -n kube-system logtail-ds -o yaml > logtail-ds.yaml
   kubectl get deployment -n kube-system alibaba-log-controller -o yaml > alibaba-log-controller.yaml
   kubectl get crd aliyunlogconfigs.log.alibabacloud.com -o yaml > aliyunlogconfigs-crd.yaml
   kubectl get cm -n kube-system alibaba-log-configuration -o yaml > alibaba-log-configuration.yaml
   kubectl get aliyunlogconfigs --all-namespaces -o yaml > aliyunlogconfigs-cr.yaml

2. クラスタータイプに応じてアップグレード方法を選択します。ACK クラスターを使用しており、そのクラスターが SLS と同じ Alibaba Cloud アカウントに属する場合は、ACK クラスター向けの手順に従ってください。セルフマネージドクラスターを使用する場合、または ACK クラスターと SLS が異なる Alibaba Cloud アカウントに属する場合は、セルフマネージドクラスター向けの手順に従ってください。

   ACK クラスターでのアップグレード

   自動アップグレード方法の使用を推奨します。logtail-ds DaemonSet または alibaba-log-controller デプロイメントで環境変数などのパラメーターを変更した場合は、変更がリセットされないように手動アップグレード方法を使用してください。

   自動アップグレード

   重要

   自動アップグレードでは、logtail-ds および alibaba-log-controller で手動で変更した構成がリセットされます。

   1. 「Container Service Management Console」にログインします。

   「クラスター」ページで、対象クラスターを見つけ、アクション列の その他 > 操作 > コンポーネントの管理 を選択します。

   2. ログおよびモニタリング タブで、logtail-ds を見つけ、アップグレード をクリックします。

   3. コンポーネントのアップグレード ダイアログボックスで、OK をクリックします。

      重要

      最新バージョンの Logtail にアップグレードできない場合は、Kubernetes クラスターのバージョンが古すぎる可能性があります。まず Kubernetes クラスターをアップグレードするか、手動アップグレード方法を使用してください。

      アップグレードを実行した後、ACK コンソールで logtail-ds Pod のステータスを確認します。すべての logtail-ds Pod が「実行中」の状態であれば、アップグレードは成功しています。

   手動アップグレード

   重要

   手動アップグレードでは、最新の Logtail コンポーネントに基づいて構成が更新されません。一部の機能最適化が利用できない場合があります。

   手動アップグレードには、logtail-ds および alibaba-log-controller のアップグレードが含まれます。通常、新しい Logtail バージョンが提供する収集機能を得るには、logtail-ds のみをアップグレードすれば十分です。新しい Logtail CRD メソッドによる収集機能を得る必要がある場合は、alibaba-log-controller もアップグレードする必要があります。以下の手順では、logtail-ds を例として説明します。

   1. 「Container Service Management Console」にログインします。

   「クラスター」ページで、対象クラスターを見つけ、アクション列の その他 > 操作 > コンポーネントの管理 を選択します。

   2. ワークロード > DaemonSets を選択します。

      説明

      alibaba-log-controller をアップグレードするには、ワークロード > デプロイメント を選択します。その後、kube-system 名前空間で alibaba-log-controller を見つけ、アップグレードを完了します。

   3. 名前空間 を kube-system に設定し、logtail-ds の行で 編集 をクリックします。

   4. 以下の環境変数が存在するかどうかを確認します。

      ALIYUN_LOGTAIL_CONFIG、ALIYUN_LOGTAIL_USER_ID、ALIYUN_LOGTAIL_USER_DEFINED_ID 環境変数が存在しない場合、Logtail のバージョンが古すぎる可能性があります。Logtail をアップグレードしてください。

   5. イメージタグ の横にある イメージタグの選択 をクリックします。

   6. イメージタグ ダイアログボックスで、最新のバージョンをクリックし、OK をクリックします。

   7. ページの右側で、更新 をクリックします。

      アップグレードを実行した後、ACK コンソールで logtail-ds Pod のステータスを確認します。すべての logtail-ds Pod が「実行中」の状態であれば、アップグレードは成功しています。

   セルフマネージドクラスターでのアップグレード

   説明

   最新の Logtail コンポーネントをインストールすることでアップグレードすることを推奨します。logtail-ds や alibaba-log-controller などの一部のコンポーネントのイメージバージョンのみを更新すると、アップグレードが失敗する可能性があります。

   自動アップグレードを完了するために Logtail コンポーネントを再インストールします。詳細については、「Logtail コンポーネントのインストール」をご参照ください。

3. 特定のバージョンにロールバックするには、以下の手順に従います。

   説明

   アップグレード前にバックアップした YAML ファイルには、Logtail 構成を復元するために手動で削除する必要がある冗長情報が含まれています。この作業には kubectl-neat ツールを使用できます。削除するフィールドは、metadata.creationTimestamp、metadata.generation、metadata.resourceVersion、metadata.uid、および status です。

   1. ビジネス要件に応じて、アップグレード後の新しい Logtail 構成を保持するかどうかを判断します。

      保持する必要がない場合は、新しい Logtail 構成を削除します。

   2. バックアップファイルから冗長情報を削除します。

      cat logtail-ds.yaml | kubectl-neat > neat-logtail-ds.yaml
      cat alibaba-log-controller.yaml | kubectl-neat > neat-alibaba-log-controller.yaml
      cat aliyunlogconfigs-crd.yaml | kubectl-neat > neat-aliyunlogconfigs-crd.yaml
      cat alibaba-log-configuration.yaml | kubectl-neat > neat-alibaba-log-configuration.yaml
      cat aliyunlogconfigs-cr.yaml | kubectl-neat > neat-aliyunlogconfigs-cr.yaml

   3. 簡略化されたバックアップファイルを適用して Logtail 構成を復元します。

      kubectl apply -f neat-logtail-ds.yaml
      kubectl apply -f neat-alibaba-log-controller.yaml
      kubectl apply -f neat-aliyunlogconfigs-crd.yaml
      kubectl apply -f neat-alibaba-log-configuration.yaml
      kubectl apply -f neat-aliyunlogconfigs-cr.yaml

Logtail のアンインストール

クラスタータイプに応じてアンインストール方法を選択します。ACK クラスターを使用しており、そのクラスターが SLS と同じ Alibaba Cloud アカウントに属する場合は、ACK クラスター向けの手順に従ってください。セルフマネージドクラスターを使用する場合、または ACK クラスターと SLS が異なる Alibaba Cloud アカウントに属する場合は、セルフマネージドクラスター向けの手順に従ってください。

複数の Kubernetes クラスターで 1 つの SLS プロジェクトをどのように使用しますか？

複数のクラスターから収集したコンテナログを同じ SLS プロジェクトにまとめたい場合は、最初にコンポーネントをインストールした際に使用したインストールパラメーターを、他のクラスターの SLS コンポーネントにも同じように設定します。

Logtail のログを確認するには？

Logtail のログは、Logtail コンテナ内の /usr/local/ilogtail/ ディレクトリに保存されています。ファイル名は ilogtail.LOG および logtail_plugin.LOG です。

Logtail コンテナの標準出力は参考になりません。以下の標準出力の内容は無視して構いません。

start umount useless mount points, /shm$|/merged$|/mqueue$
umount: /logtail_host/var/lib/docker/overlay2/3fd0043af174cb0273c3c7869500fbe2bdb95d13b1e110172ef57fe840c82155/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/d5b10aa19399992755de1f85d25009528daa749c1bf8c16edff44beab6e69718/merged: must be superuser to unmount
umount: /logtail_host/var/lib/docker/overlay2/5c3125daddacedec29df72ad0c52fac800cd56c6e880dc4e8a640b1e16c22dbe/merged: must be superuser to unmount
......
xargs: umount: exited with status 255; aborting
umount done
start logtail
ilogtail is running
logtail status:
ilogtail is running

Kubernetes クラスター内の SLS コンポーネントのステータスを確認するには？

以下のコマンドを実行して確認します。

kubectl get deploy alibaba-log-controller -n kube-system
kubectl get ds logtail-ds -n kube-system

alibaba-log-controller の起動に失敗した場合はどうすればよいですか？

以下のインストール手順に従っているか確認してください。

• Kubernetes クラスターのマスターノードでインストールコマンドを実行します。

• インストールコマンドのパラメーターとしてクラスター ID を入力します。

これらの問題によりインストールに失敗した場合は、kubectl delete -f deploy コマンドを実行して生成されたインストールテンプレートを削除し、再度インストールコマンドを実行してください。

Kubernetes クラスター内の Logtail-ds DaemonSet のステータスを確認するには？

kubectl get ds -n kube-system コマンドを実行して Logtail-ds DaemonSet のステータスを確認します。

Logtail のランタイムログを確認するには？

Logtail のランタイムログは /usr/local/ilogtail/ ディレクトリに保存されています。ファイル名は ilogtail.LOG です。ローテーションされたファイルは圧縮され、ilogtail.LOG.x.gz として保存されます。たとえば、以下のコマンドを実行してログを表示できます。

kubectl exec logtail-ds-gb92k -n kube-system tail /usr/local/ilogtail/ilogtail.LOG

結果は以下のとおりです。

[2018-02-05 06:09:02.168693] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:104] logtail plugin Resume:start
[2018-02-05 06:09:02.168807] [INFO] [9] [build/release64/sls/ilogtail/LogtailPlugin.cpp:106] logtail plugin Resume:success
[2018-02-05 06:09:02.168822] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:369] start add existed check point events, size:0
[2018-02-05 06:09:02.168827] [INFO] [9] [build/release64/sls/ilogtail/EventDispatcher.cpp:511] add existed check point events, size:0 cache size:0 event size:0 success count:0

特定の Pod で Logtail を再起動するには？

1. Logtail を停止します。

   logtail-ds-gb92k はコンテナ名、kube-system は名前空間です。必要に応じて置き換えてください。

   kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild stop

2. 以下の結果が表示された場合、Logtail は停止しています。

   kill process Name: ilogtail pid: 7
   kill process Name: ilogtail pid: 9
   stop success

3. Logtail を起動します。

   logtail-ds-gb92k はコンテナ名、kube-system は名前空間です。必要に応じて置き換えてください。

   kubectl exec logtail-ds-gb92k -n kube-system /etc/init.d/ilogtaild start

以下の結果が表示された場合、Logtail は起動しています。

ilogtail is running