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 を一括でインストールします。

• 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. ACK コンソールにログインします。

   [クラスター] ページで、ターゲットクラスターを見つけ、[操作] 列で [その他] > [操作] > [コンポーネントの管理] を選択します。

   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. ACK コンソールにログインします。

   [クラスター] ページで、ターゲットクラスターを見つけ、[操作] 列で [その他] > [操作] > [コンポーネントの管理] を選択します。

   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 のバージョンが古すぎる可能性があります。して。

   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