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

Logtail のインストール

Logtail は、ワンクリックインストールまたは手動インストールの方法でインストールできます。ワンクリックインストールは、プロジェクトと同じリージョンにあり、同じ Alibaba Cloud アカウントに属する 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 は、次の 2 つの方法のいずれかでバッチインストールできます。

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

• ECS クラウドアシスタント: 使いやすいです。コマンドを実行して一時的なタスクを実行できます。次の手順に従ってください。

1. 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 コンポーネントのインストール

Simple Log Service プロジェクトと同じ Alibaba Cloud アカウントに属する ACK クラスターを使用する場合は、ACK クラスターのインストール方法に従ってください。それ以外の場合は、自己管理クラスターのインストール方法に従ってください。

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 コンポーネントに関連する説明ファイルをバックアップします。

   重要

   数秒かかるアップグレード中に、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. クラスターの種類に基づいてアップグレード方法を選択します。Simple Log Service プロジェクトと同じ Alibaba Cloud アカウントに属する ACK クラスターを使用する場合は、ACK クラスターのアップグレード方法に従ってください。それ以外の場合は、自己管理クラスターのアップグレード方法に従ってください。

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

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

   自動アップグレード

   重要

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

   1. ACK コンソールにログインします。

   3. [ログとモニタリング] タブで [logtail-ds] を見つけ、[アップグレード] をクリックします。

   4. [コンポーネントのアップグレード] ダイアログボックスで、[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. ACK コンソールにログインします。

   3. [ワークロード] > [DaemonSet] を選択します。

      説明

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

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

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

      ALIYUN_LOGTAIL_CONFIG、ALIYUN_LOGTAIL_USER_ID、および ALIYUN_LOGTAIL_USER_DEFINED_ID 環境変数が存在しない場合、Logtail のバージョンが古すぎる可能性があります。チケットを送信して、アップグレード方法を問い合わせることができます。

   6. [イメージタグ] の [イメージタグの選択] をクリックします。

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

   8. ページの右側にある [更新] をクリックします。

      アップグレードを実行した後、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 のアンインストール

クラスターの種類に基づいてアンインストール方法を選択します。Simple Log Service プロジェクトと同じ Alibaba Cloud アカウントに属する ACK クラスターを使用する場合は、ACK クラスターのアンインストール方法に従ってください。それ以外の場合は、自己管理クラスターのアンインストール方法に従ってください。

複数の Kubernetes クラスターで同じ Simple Log Service プロジェクトを使用するにはどうすればよいですか？

複数のクラスターから同じ Simple Log Service プロジェクトにコンテナログを収集する場合は、他のクラスターに Simple Log Service コンポーネントをインストールするときに、最初のクラスターと同じインストールパラメーターを使用します。

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 クラスターで Simple Log Service 関連コンポーネントのステータスを表示するにはどうすればよいですか？

次のコマンドを実行してステータスを表示します。

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