Logtail を使用したリージョンを跨いだログ収集 - Simple Log Service

仕組み

ウェブアプリケーションがリージョン A にデプロイされており、Simple Log Service プロジェクトがリージョン B にあるとします。リージョン A の ECS インスタンスからリージョン B の Simple Log Service プロジェクトにログデータを送信するには、次の手順に従います。

手順1：リージョン A の ECS インスタンスへの Logtail のインストール
手順2：リージョン A の ECS インスタンスでのカスタム識別子の設定
手順3：リージョン B の SLS プロジェクトでのカスタム識別子を使用するマシングループの作成
手順4：リージョン B の SLS プロジェクトでの Logtail 設定の作成

次の図にプロセスを示します。

前提条件

プロジェクトと Logstore がすでに存在している必要があります。詳細については、「プロジェクトの管理」および「Logstore の作成」をご参照ください。

手順1：リージョン A への Logtail のインストール

ネットワーク伝送

伝送モード	ユースケース
インターネット	Alibaba Cloud の ECS インスタンスと SLS プロジェクトが異なるリージョンにある場合。サーバーがサードパーティーのクラウドプロバイダーのもの、またはオンプレミスデータセンターにある場合。
転送アクセラレーション	サーバーがオンプレミスデータセンターにあるか、中国以外のクラウドプロバイダーによってホストされている場合、インターネット伝送では高レイテンシや不安定な接続が発生する可能性があります。代わりに転送アクセラレーションを使用します。詳細については、「転送アクセラレーションの管理」をご参照ください。

リージョン A の ECS インスタンスにログインします。ネットワーク環境に基づき、「ネットワーク伝送」で説明されている Logtail インストールスクリプトを選択します。 Logtail がサポートする Linux オペレーティングシステムの一覧については、「制限」をご参照ください。

インターネット

Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、インストールコマンドを実行します。

重要

各リージョンの ${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 install ${region_id}-internet

転送アクセラレーション

Simple Log Service プロジェクトが存在するリージョンの Simple Log Service パラメーターの値を取得します。 ${region_id} パラメーターを取得した値に置き換えて、インストールコマンドを実行します。

重要

各リージョンの ${region_id} パラメーターの値の詳細については、「サポートされているリージョン」をご参照ください。たとえば、中国 (杭州) リージョンの ${region_id} パラメーターの値は cn-hangzhou です。
転送アクセラレーションを使用して Logtail をインストールした後、転送アクセラレーション機能を有効にする必要があります。詳細については、「プロジェクトの転送アクセラレーション機能を有効にする」をご参照ください。

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}-acceleration

手順2：カスタム識別子の設定

指定されたディレクトリにカスタム識別子ファイル user_defined_id を作成し、カスタム識別子を設定します。
重要
- [マシングループ]に、Linux サーバーと Windows サーバーを混在させることはできません。したがって、同じ[ユーザー定義 ID]を Linux サーバーと Windows サーバーの両方に割り当てないでください。
- 1 つのサーバーに複数の[ユーザー定義 ID]を設定できます。識別子は改行で区切ります。

Linux

Logtail がインストールされている Linux サーバーにログインし、次のコマンドを実行して[ユーザー定義 ID]を設定します。

説明
/etc/ilogtail/ ディレクトリが存在しない場合は、手動で作成してください。
```
echo "user-defined-1" > /etc/ilogtail/user_defined_id
```
(オプション) 次のコマンドを実行して、[ユーザー定義 ID]が正常に書き込まれたかどうかを確認します。 user-defined-1 が返された場合、書き込み操作は成功です。
```
cat /etc/ilogtail/user_defined_id
```
user_defined_id ファイルへの変更は、デフォルトで 1 分以内に有効になります。変更をすぐに適用するには、次のコマンドを実行して Logtail を再起動します。
```
/etc/init.d/ilogtaild stop
/etc/init.d/ilogtaild start
```

Windows

Logtail がインストールされている Windows サーバーにログインし、user_defined_id という名前のファイルを C:\LogtailData ディレクトリに作成し、user-defined-1 を書き込んで保存します。

説明
C:\LogtailData ディレクトリが存在しない場合は、手動で作成してください。
デフォルトでは、user_defined_id ファイルへの変更は 1 分以内に有効になります。変更をすぐに適用するには、Logtail を再起動します。
1. 開始日時 > [コントロールパネル] > 管理ツール > サービス を選択します。
2. サービス ダイアログボックスで、適切なサービスを選択します。
3. Logtail V0.x.x.x の場合は、LogtailWorker サービスを選択します。
4. Logtail V1.0.0.0 以降の場合は、LogtailDaemon サービスを選択します。
5. サービスを右クリックし、[再起動] を選択します。

コンテナ環境

カスタム識別子は、Logtail コンテナの ALIYUN_LOGTAIL_USER_DEFINED_ID 環境変数に設定されます。 docker inspect ${logtail_container_name} | grep ALIYUN_LOGTAIL_USER_DEFINED_ID コマンドを実行して設定を確認します。

手順3：カスタム ID マシングループの作成

Simple Log Service コンソールにログオンします。[プロジェクト] セクションで、管理するプロジェクトをクリックします。
左側のナビゲーションウィンドウで、[リソース] > [マシングループ] を選択します。[マシングループ] リストで、 > [マシングループの作成] を選択します。

[マシングループの作成] パネルで、パラメーターを構成し、[OK] をクリックします。次の表にパラメーターを示します。

パラメーター	説明
名前	マシングループの名前。名前は次の要件を満たしている必要があります。名前に使用できるのは、小文字、数字、ハイフン（-）、およびアンダースコア（_）のみです。名前は小文字または数字で開始および終了する必要があります。名前は 2 ～ 128 文字である必要があります。重要マシングループを作成した後、マシングループの名前を変更することはできません。ご注意ください。
マシングループ識別子	マシングループの識別子の種類。[IP アドレス] を選択します。
マシングループトピック	オプション。マシングループのトピック。トピックは、異なるサーバーによって生成されたログを識別するために使用されます。詳細については、「ログトピック」をご参照ください。
IP アドレス	IP アドレス。Logtail によって自動的に取得された IP アドレスを入力します。重要複数のサーバーをマシングループに追加する場合は、サーバーの IP アドレスを手動で入力し、IP アドレスを改行で区切ることをお勧めします。マシングループには、Linux サーバーと Windows サーバーの両方を含めることはできません。Linux サーバーと Windows サーバーの IP アドレスを同じマシングループに追加しないでください。

マシングループ リストで、対象のマシングループをクリックします。サーバグループ設定 ページで、マシングループの設定とサーバーのハートビートステータスを確認します。

手順4：Logtail 設定の作成

重要

Logtail がインストールされているホストは、ポート 80 (HTTP) とポート 443 (HTTPS) でのアウトバウンドトラフィックを許可する必要があります。 ECS インスタンスでは、セキュリティグループルールがポートアクセスを制御します。セキュリティグループルールの追加方法の詳細については、「セキュリティグループルールの追加」をご参照ください。
Logtail は増分ログのみを収集するため、ログファイルは継続的に更新される必要があります。設定が適用された後、更新されなくなったファイルから Logtail はデータを収集しません。詳細については、「ログデータの読み取り」をご参照ください。
履歴データを収集するには、「履歴ログファイルのインポート」をご参照ください。

Simple Log Service:Logtail を使用したリージョンを跨いだログ収集

仕組み