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

ワンクリックインストール

Simple Log Service では、ワンクリックで ECS インスタンスに Logtail をインストールできます。インストールは CloudOps Orchestration Service (OOS) のオーケストレーション機能を利用するため、ECS インスタンスにログインしてインストール手順を手動で実行する必要はありません。Alibaba Cloud アカウントでログインした場合、デフォルトで必要なすべての権限が付与されているため、操作を直接実行できます。

RAM ユーザーとしてログインする場合は、Alibaba Cloud アカウントの所有者に OOS リソースを管理するための権限を付与するよう依頼してください。アカウント所有者は、システムポリシーまたはカスタムポリシーを使用してRAM ユーザーを作成し、RAM ユーザーに権限を付与できます。

• システムポリシー：

  • AliyunOOSFullAccess：CloudOps Orchestration Service (OOS) を管理するための完全な権限を付与します。

  • AliyunECSFullAccess：ECS を管理するための権限を付与します。

• カスタムポリシー：データセキュリティ要件が厳しい場合は、きめ細かな権限付与のためにカスタムポリシーを作成できます。次のポリシーは、OOS リソースを管理するための権限を付与します。

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ecs:DescribeTagKeys",
                "ecs:DescribeTags",
                "ecs:DescribeInstances",
                "ecs:DescribeInvocationResults",
                "ecs:RunCommand",
                "ecs:DescribeInvocations",
                "ecs:InvokeCommand"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "oos:ListTemplates",
                "oos:StartExecution",
                "oos:ListExecutions",
                "oos:GetExecutionTemplate",
                "oos:ListExecutionLogs",
                "oos:ListTaskExecutions"
            ],
            "Resource": "*"
        }
    ]
}

ECS インスタンスに Logtail をインストールし、同時にマシングループを作成して設定するには、次の手順を実行してください。

1. Simple Log Service コンソールにログインします。ログリソースを管理するプロジェクトをクリックして、Logstore のリストを表示します。ログを格納する Logstore の名前の前にある アイコンをクリックして展開し、データのインポート の後に表示される アイコンをクリックし、ダイアログボックスでテキストログテンプレートを選択して、今すぐ統合 をクリックします。

   Simple Log Service は、正規表現、単一行、複数行のテンプレートなど、複数のテキストログテンプレートを提供します。これらのテンプレートは、ログ解析プラグインのみが異なり、他のすべての設定は同じです。テンプレートでログ解析プラグインを追加または削除することもできます。収集したいログの特性に基づいてテンプレートを選択するか、任意のテキストログテンプレートを選択してから、ログの特性に基づいてプラグインを設定します。

2. サーバグループ設定 ページで、インストール環境として ホストシナリオ と ECS を選択し、次に マシングループの作成 をクリックします。

3. マシングループの作成 パネルで、プロジェクトと同じリージョンにある 1 つ以上の ECS インスタンスを選択して マシングループとしてインストールおよび作成する をクリックし、インストールが完了したら、マシン グループの 名前 を指定して [OK] をクリックします。

   インストールが失敗した場合、または待機状態のままの場合は、ECS インスタンスがプロジェクトと同じリージョンにあるかどうかを確認してください。

4. インストール後、[リソース] > マシングループ ページに移動し、作成したマシングループをクリックし、サーバグループ設定 > サーバグループのステータス セクションでハートビート ステータスを確認します。ハートビートステータスが OK の場合、マシングループが作成されたことを示します。

手動インストール

サーバーのオペレーティングシステムと CPU アーキテクチャに基づいて、Logtail のダウンロード方法とインストール方法を選択してください。

サンプルコードの ${region_id} は、Simple Log Service プロジェクトが存在するリージョンです。実際のリージョンIDに置き換えてください。詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) の ${region_id} は cn-hangzhou です。

Logtail をインストールする前に、次の点にご注意ください。

• Logtail 2.0 の互換性：マシンのスペックが低い場合や古いオペレーティングシステムを実行している場合、Logtail 2.0 で互換性の問題が発生し、ソフトウェアが正常に実行されないことがあります。この場合は、https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/linux64/1.8.7/logtail.sh からバージョン 1.8.7 をダウンロードし、./logtail.sh install ${region_id} -v 1.8.7 コマンドを実行してインストールすることを推奨します。

Linux

• 次のバージョンの Linux x86-64 (64 ビット) サーバーがサポートされています。- Alibaba Cloud Linux 2 および 3

  • Anolis OS 7 および 8 - CentOS Linux 6、7、および 8 - Debian GNU/Linux 8、9、10、11、および 12

  • Red Hat Enterprise Linux 6、7、8、および 9

  • openSUSE 15.1、15.2、および 42.3

  • SUSE Linux Enterprise Server 11、12、および 15 - Ubuntu 14.04、16.04、18.04、20.04、22.04、および 24.04 - glibc 2.5 以降をベースとするその他の Linux オペレーティングシステム。Logtail 2.0 以降では glibc 2.6 以降が必要です。

  • Logtail 2.0 以降では、CPU が sse4_2 および avx 命令セットをサポートしている必要があります。- 次のバージョンの Linux ARM (64 ビット) サーバーがサポートされています。- Alibaba Cloud Linux 3.2 for ARM - Anolis OS 8.2 for ARM 以降 - CentOS 8.4 for ARM

  • Debian 11.2 および 12.2 for ARM - Ubuntu 20.04、22.04、および 24.04 for ARM

  • Logtail 2.0 以降では、最小限必要な CPU アーキテクチャは ARMv8.2-A です。

インターネットにアクセスできるサーバー (ARM および x86-64)

インターネットにアクセスできるサーバーの場合は、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}

オフラインの ARM サーバー

オフラインサーバーの場合は、まずインターネットにアクセスできるサーバーにインストールスクリプトとインストールパッケージをダウンロードしてください。

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/aarch64/logtail-linux64.tar.gz

インストールスクリプトとインストールパッケージを Logtail をインストールしたいサーバーにコピーし、ネットワーク条件に基づいてインストールコマンドを選択してください。

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

オフラインの x86-64 サーバー

オフラインサーバーの場合は、まずインターネットにアクセスできるサーバーにインストールスクリプトとインストールパッケージをダウンロードしてください。

wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail.sh; wget http://logtail-release-${region_id}.oss-${region_id}.aliyuncs.com/linux64/logtail-linux64.tar.gz

インストールスクリプトとインストールパッケージを Logtail をインストールしたいサーバーにコピーし、ネットワーク条件に基づいてインストールコマンドを選択してください。

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

Windows

次の Windows バージョンがサポートされています。- Microsoft Windows Server 2008、2012、2016、2019、2022、および 2025 - Microsoft Windows 7 - Microsoft Windows 10 - Microsoft Windows Server Version 1909 - Microsoft Windows Server Version 2004

サーバーのアーキテクチャとプロジェクトのリージョンに一致するインストールパッケージをダウンロードしてください。

インストールパッケージを展開し、管理者として Windows PowerShell を実行します。展開先の logtail_installer ディレクトリに移動し、ネットワーク条件に基づいてインストールコマンドを選択してください。

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

Linux

Logtail の起動

sudo /etc/init.d/ilogtaild start

Logtail の停止

sudo /etc/init.d/ilogtaild stop

Windows

1. ターゲットサーバーにログインしてください。

2. 開始日時 > コントロール パネル > 管理ツール > サービス を選択します。

3. サービス ダイアログボックスで、必要なサービスを探します。

   • バージョン 0.x.x.x の場合は、LogtailWorker サービスを選択してください。

   • バージョン 1.0.0.0 以降の場合は、LogtailDaemon サービスを選択してください。

4. サービスを右クリックし、開始、停止、[再起動] などの必要な操作を選択します。

Linux

Linux での Logtail ステータスの確認

sudo /etc/init.d/ilogtaild status コマンドを実行して Logtail のステータスを確認してください。システムが ilogtail is running を返した場合、Logtail はインストールされています。Logtail が実行されていない場合は、アンインストールしてから再度インストールしてください。

Linux での Logtail バージョンの確認

Logtail は、バージョン情報を /usr/local/ilogtail/app_info.json ファイルの logtail_version フィールドに保存します。次のコマンドを実行して、Logtail のバージョン情報を表示してください。

cat /usr/local/ilogtail/app_info.json

次の結果が返されます。

{
   "logtail_version" : "0.16.30",
}

Windows

Windows での Logtail ステータスの確認

Logtail のステータスを確認して、Logtail がターゲットサーバーにインストールされているかどうかを判断してください。

1. [ファイル名を指定して実行] ウィンドウを開き、services.msc と入力して、[サービス] ウィンドウを開いてください。

2. Logtail 1.0.0.0 以降に適用される LogtailDaemon サービス、または Logtail 0.x.x.x に適用される LogtailWorker サービスの実行ステータスを確認してください。

   ステータスが [実行中] であれば、Logtail がインストールされていることを示します。

Windows での Logtail バージョンの確認

Logtail のバージョンは、インストールパスにある app_info.json ファイルの logtail_version フィールドで確認できます。

たとえば、次の内容は Logtail のバージョンが 1.0.0.0 であることを示しています。

{
    "logtail_version" : "1.0.0.0"
}

Linux

Linux サーバーで Logtail をアップグレードする前に、次の点にご注意ください。

• アップグレードコマンド：Logtail をアップグレードするには、upgrade コマンドを使用してください。install コマンドを使用すると、上書きインストールが実行され、元の設定は失われます。

• サービス中断：アップグレード中、Logtail は短時間停止します。アップグレードが完了すると、Logtail は自動的に起動し、スタートアップ項目として登録されます。アップグレードでは必要なファイルのみが上書きされます。設定ファイルとチェックポイントファイルは保持されるため、アップグレード中にログが失われることはありません。

  サンプルコードの ${region_id} は、Simple Log Service プロジェクトが存在するリージョンです。実際のリージョンIDに置き換えてください。詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) の ${region_id} は cn-hangzhou です。

次の表から 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"
}

Windows

アップグレード手順はインストール手順と同じです。最新のインストールパッケージをダウンロードして展開し、インストール手順を実行してください。

Linux

Simple Log Service プロジェクトが存在するリージョンの ${region_id} を取得します。${region_id} を置き換えてから、次のコマンドを実行して Logtail をアンインストールします。

各リージョンの ${region_id} については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) の ${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 uninstall

Windows

管理者として Windows PowerShell または cmd を実行し、インストールパッケージの展開先である logtail_installer ディレクトリに移動してから、次のコマンドを実行してください。

.\logtail_installer.exe uninstall

アンインストールが完了すると、Logtail のインストールディレクトリは削除されますが、一部の設定は C:\LogtailData ディレクトリに保持されます。要件に応じて手動で削除できます。保持される情報には、次のものがあります。

• checkpoint：すべての Logtail プラグインのチェックポイント情報を保存します。このファイルは、Logtail プラグインを使用した後にのみ存在します。

• user_config.d：ローカルの収集設定を保存するディレクトリです。.json 拡張子を持つファイルは収集設定と見なされます。形式は /usr/local/ilogtail/user_log_config.json に似ています。

• logtail_check_point：メインの Logtail コンポーネントのチェックポイント情報を保存します。

• users：設定したユーザー識別子ファイルを保存します。

ACK クラスター

この操作は、専用 Kubernetes クラスターとマネージド Kubernetes クラスターにのみ適用されます。

既存の ACK クラスターへの Logtail コンポーネントのインストール

1. Container Service for Kubernetes (ACK) コンソールにログインします

2. クラスターリスト ページで、宛先クラスターの右端の列にある 詳細 > 操作 > アドオン管理 を選択します。

3. ログとモニタリング タブで、logtail-ds を見つけ、インストール をクリックします。

   インストールが完了すると、Simple Log Service は自動的に k8s-log-${your_k8s_cluster_id} という名前のプロジェクトを作成します。

ACK クラスター作成時の Logtail コンポーネントのインストール

1. Container Service for Kubernetes (ACK) コンソールにログインします

2. 左側のナビゲーションペインで、クラスターリスト をクリックします。

3. クラスターリスト ページで、クラスターの作成 をクリックします。

4. コンポーネント設定 設定ステップで、Log Service の使用 を選択します。

Log Service の使用 を選択すると、プロジェクトの作成を促すメッセージが表示されます。Simple Log Service でのログの整理方法に関する詳細については、「プロジェクト」をご参照ください。プロジェクトは、次の 2 つの方法のいずれかで作成できます。

• [プロジェクトの選択]：既存のプロジェクトを選択して、収集したコンテナログを管理できます。

• [プロジェクトの作成]：Simple Log Service は、収集したコンテナログを管理するためのプロジェクトを自動的に作成します。ClusterID は、作成する Kubernetes クラスターの一意の識別子です。

  [ログサービス] セクションで、Log Service の使用 を選択します。[新しいプロジェクトを作成] を選択すると、システムは自動的に k8s-log-{ClusterID} という名前のプロジェクトを作成します。

インストールが完了すると、選択したプロジェクトに次の Simple Log Service リソースが自動的に作成されます。

セルフマネージドクラスター

1. Kubernetes クラスターにログインし、リージョンに基づいてコマンドを選択して、Logtail とその依存コンポーネントをダウンロードします。

   # 中国本土のリージョン
   wget https://logtail-release-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh
   # 中国本土以外のリージョン
   wget https://logtail-release-ap-southeast-1.oss-ap-southeast-1.aliyuncs.com/kubernetes/0.5.5/alibaba-cloud-log-all.tgz; tar xvf alibaba-cloud-log-all.tgz; chmod 744 ./alibaba-cloud-log-all/k8s-custom-install.sh

2. ./alibaba-cloud-log-all/values.yaml 設定ファイルを変更します。

   設定ファイルには、次のパラメーターが含まれています。

   # ===================== 必須コンテンツ =====================
   # 宛先プロジェクトの名前。
   SlsProjectName: 
   # プロジェクトのリージョン。
   Region: 
   # プロジェクトの Alibaba Cloud アカウントの ID。二重引用符 ("") で囲んでください。
   AliUid: "11099"
   # Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID と AccessKey Secret。AliyunLogFullAccess 権限が必要です。
   AccessKeyID: 
   AccessKeySecret: 
   # カスタムクラスター ID。ID には、文字、数字、ハイフン (-) のみを含めることができます。
   ClusterID: 
   # ==========================================================
   # メトリック収集に関連するコンポーネントを有効にするかどうかを指定します。有効な値：true および false。デフォルト値：true。
   SlsMonitoring: true
   # ネットワークタイプ。有効な値：Internet および Intranet。デフォルト値：Internet。
   Net: Internet
   # コンテナランタイムが containerd であるかどうかを指定します。有効な値：true および false。デフォルト値：false。
   SLS_CONTAINERD_USED: true

   パラメーター	説明
   SlsProjectName	Logtail がログをアップロードするプロジェクトの名前。
   Region	プロジェクトがあるリージョンの ID。たとえば、中国 (杭州) のリージョン ID は cn-hangzhou です。
   AliUid	プロジェクトの Alibaba Cloud アカウントの ID。ID は二重引用符 ("") で囲む必要があります。例：AliUid: "11099"。
   AccessKeyID	プロジェクトの Alibaba Cloud アカウントの AccessKey ID。RAM ユーザーの AccessKey ペアを使用し、RAM ユーザーに AliyunLogFullAccess 権限を付与することを推奨します。
   AccessKeySecret	プロジェクトの Alibaba Cloud アカウントの AccessKey Secret。RAM ユーザーの AccessKey ペアを使用し、RAM ユーザーに AliyunLogFullAccess 権限を付与することを推奨します。
   ClusterID	カスタムクラスター ID。ID には、文字、数字、ハイフン (-) のみを含めることができます。このパラメーターは、後続の操作における ${your_k8s_cluster_id} に対応します。異なる Kubernetes クラスターに同じクラスター ID を設定しないでください。
   SlsMonitoring	クラスターメトリックデータ収集を有効にするかどうかを指定します。有効な値は true (デフォルト) と false です。true はクラスターメトリックデータ収集を有効にし、false は無効にします。
   Net	Logtail がデータ転送に使用するネットワークタイプ。クラスターが Alibaba Cloud イントラネットに接続されていない場合は、インターネットを使用します。有効な値は、インターネットを示す Internet (デフォルト) と、イントラネットを示す Intranet です。
   SLS_CONTAINERD_USED	コンテナランタイムが containerd であるかどうかを指定します。有効な値：true はコンテナランタイムが containerd であることを示し、false (デフォルト) はコンテナランタイムが containerd でないことを示します。containerd をコンテナランタイムとして使用するセルフマネージド Kubernetes クラスターでは、このパラメーターを有効にしない場合、Logtail がログを収集できないことがあります。

3. Logtail とその依存コンポーネントをインストールします。

   ホストの OS-architecture を確認するには、echo "$(uname -s | tr '[:upper:]' '[:lower:]')-$(uname -m)" コマンドを実行できます。k8s-custom-install.sh スクリプトは、linux-386、linux-amd64、linux-arm、linux-arm64、linux-ppc64le、linux-s390x、darwin-amd64 の OS-architecture の組み合わせをサポートします。

   bash k8s-custom-install.sh; kubectl apply -R -f result

   変更した values.yaml ファイル。

ACK クラスター

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

自動アップグレード

1. コンテナサービス管理コンソールにログオンします。

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

3. 更新 ダイアログボックスで、OK をクリックします。

アップグレード後、コンテナサービス管理コンソールで logtail-ds Pod のステータスを確認できます。すべての logtail-ds Pod が Running 状態であれば、アップグレードは成功です。

手動アップグレード

手動アップグレードの対象は logtail-ds と alibaba-log-controller です。ほとんどの場合、新しい Logtail バージョンの収集機能を利用するには、logtail-ds をアップグレードするだけで十分です。新しい Logtail CRD が提供する収集機能を利用するには、alibaba-log-controller をアップグレードする必要があります。次の手順では logtail-ds を例に説明します。

1. コンテナサービス管理コンソールにログオンします。

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

   説明

   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. ページの右側で、更新 をクリックします。

   アップグレード後、コンテナサービス管理コンソールで logtail-ds Pod のステータスを確認できます。すべての logtail-ds Pod が Running 状態であれば、アップグレードは成功です。

セルフマネージドクラスター

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

アップグレードを完了するには、Logtail コンポーネントを再度インストールしてください。

ACK クラスター

1. コンテナサービス管理コンソールにログインします。

2. ログとモニタリング タブで、logtail-ds を見つけ、アンインストール をクリックします。

3. 画面の指示に従い、OK をクリックしてアンインストールを完了します。

セルフマネージドクラスター

kubectl delete -R -f result コマンドを実行して、logtail-ds や alibaba-log-controller などのインストール済みコンポーネントをアンインストールします。

このコマンドは result ディレクトリ内のすべてのリソースを再帰的に削除します。ディレクトリに他のリソースが含まれている場合は、注意して使用してください。