Simple Log Serviceを使い始める - Simple Log Service - Alibaba Cloud ドキュメントセンター

テキストログは基本的なログタイプです。このトピックでは、Logtailを使用してログを収集し、収集したログを照会および分析する方法について説明します。次の例では、Logtailを使用してAlibaba Cloud Elastic Compute Service (ECS) インスタンスのテキストログを収集します。

前提条件

ECSインスタンスが利用可能です。詳細については、「コンソールでのECSインスタンスの作成と管理 (エクスプレスバージョン) 」をご参照ください。
Simple Log Serviceが有効化されています。詳細については、「Simple Log Serviceの有効化」をご参照ください。

背景情報

次の例では、Logtailを使用して /var/log/nginx/access.logファイルからログを収集します。

次のサンプルコードは、/var/log/nginx/access.logファイルのサンプルログを示しています。

127.0.*.1 - - [20/Mar/2023:12:00:01 +0000] "GET / HTTP/1.1" 200 612 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.60 Safari/537.36"  
192.168.*.1 - - [20/Mar/2023:12:00:02 +0000] "GET /about.html HTTP/1.1" 200 1435 "http://example.com/" "Mozilla/5.0 (iPhone; CPU iPhone OS 15_4 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Mobile/15E148 Safari/604.1"  
10.0.*.1 - - [20/Mar/2023:12:00:03 +0000] "POST /login HTTP/1.1" 302 0 "http://example.com/login.html" "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.88 Safari/537.36"  
127.0.*.1 - - [20/Mar/2023:12:00:04 +0000] "GET /images/logo.png HTTP/1.1" 200 45678 "-" "Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)"  
192.168.*.2 - - [20/Mar/2023:12:00:05 +0000] "GET /contact.html HTTP/1.1" 404 155 "http://example.com/" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/15.4 Safari/605.1.15"  
10.0.*.2 - - [20/Mar/2023:12:00:06 +0000] "GET /style.css HTTP/1.1" 200 12345 "http://example.com/" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/99.0.4844.82 Safari/537.36"  
127.0.*.1 - - [20/Mar/2023:12:00:07 +0000] "GET /favicon.ico HTTP/1.1" 404 554 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.60 Safari/537.36"  
192.168.*.3 - - [20/Mar/2023:12:00:08 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.79.1"  
10.0.*.3 - - [20/Mar/2023:12:00:09 +0000] "POST /api/data HTTP/1.1" 201 123 "http://example.com/dashboard" "PostmanRuntime/7.

詳細については、「サーバーからのテキストログの収集」をご参照ください。

手順

サーバーの指定されたファイルからテキストログを収集するには、次の手順を実行します。

プロジェクトとLogstoreの作成: Simple Log Serviceのプロジェクトを使用して、リソースを分離し、特定のリソースへのアクセスを制御します。 Simple Log ServiceのLogstoreは、ログの収集、保存、およびクエリに使用されます。
Logtail設定の作成: Logtail設定を作成して、ECSインスタンスにLogtailをインストールし、Logtailを使用してログを収集できます。ログは、Simple Log Serviceの指定されたLogstoreに収集されます。
ログの照会と分析: 収集されたログは、Simple Log Serviceコンソールで照会と分析できます。たとえば、ログの取得、ログの集計、ログの統計の収集などができます。

説明

インデックスが有効になるまで約1分待つ必要があります。次に、収集したログを [生ログ] タブで表示できます。詳細については、「検索構文」をご参照ください。
Logtailは増分ログのみを収集します。関連するLogtail設定がサーバーに適用された後にサーバー上のログファイルが更新されない場合、Logtailはファイルからログを収集しません。ログファイルを更新するには、ログファイルにログを追加します。詳細については、「Logtailのログ収集の詳細」をご参照ください。

ステップ1: プロジェクトとLogstoreを作成する

1.1 プロジェクトの作成Create a project

Simple Log Serviceコンソールにログインします。 [プロジェクト] セクションで、[プロジェクトの作成] をクリックします。 [プロジェクトの作成] パネルで、[リージョン] ドロップダウンリストからリージョンを選択し、[プロジェクト名] パラメーターの名前を指定します。他のパラメーターのデフォルト値を保持します。選択するリージョンは、ECSインスタンスが存在するリージョンと同じである必要があります。詳細については、「プロジェクトの作成」をご参照ください。

1.2 Logstoreを作成するCreate a Logstore

プロジェクトを作成すると、Logstoreを作成するように求められます。

Logstoreの作成パネルで、Logstore nameパラメーターの名前を指定します。他のパラメーターのデフォルト値を保持します。詳細については、「Logstoreの作成」をご参照ください。

ステップ2: Logtail設定の作成

Logtail設定を作成してECSインスタンスにLogtailをインストールし、Logtailを使用してログを収集することができます。ログは、Simple Log Serviceの指定されたLogstoreに収集されます。

2.1 ログ収集方法の選択

[作成済み] メッセージボックスで、[OK] をクリックします。
[クイックデータインポート] ダイアログボックスの [セルフマネージドオープンソース /商用ソフトウェア] タブで、[1行テキストログ] を見つけ、[今すぐ統合] をクリックします。

2.2 マシングループの作成

Logtail設定ウィザードのマシングループ設定ステップで、サーバー > ECS > [マシングループの作成] マシングループの作成パネルで、ECSインスタンスを選択し、マシングループのインストールと作成をクリックします。プロジェクトのリージョンがECSインスタンスが存在するリージョンと異なる場合は、「LinuxサーバーにLogtailをインストールする」をご参照ください。
Logtail Installation Status列にSuccessが表示されている場合、LogtailはECSインスタンスにインストールされています。インストールが失敗した場合は、[インストールタスクの再作成] をクリックします。 ECSインスタンスを再選択し、Logtailを再度インストールします。
Logtailをインストールしたら、nameパラメーターの名前を指定します。 LogtailがインストールされているECSインスタンスのIPアドレスがシステムによって自動的に入力されるため、[IPアドレス] フィールドにIPアドレスを指定する必要はありません。詳細については、「IPアドレスベースのマシングループの作成」をご参照ください。
マシングループのハートビートのステータスを確認します。マシングループの作成には約2分かかります。マシングループが作成されていない場合、マシングループのハートビートステータスはFAILです。2分後、[自動再試行] をクリックして、ハートビートステータスがOKになるまでマシングループのハートビートステータスを更新します。マシングループにハートビートがないという問題をトラブルシューティングする方法の詳細については、ホスト環境のLogtailマシングループに関連するエラーのトラブルシューティングを行うにはどうすればよいですか?

2.3 Logtail設定の作成

次の図に基づいてLogtail設定を作成します。 [構成名] パラメーターの名前と [ファイルパス] パラメーターのファイルパスを指定し、このトピックの [背景情報] セクションで提供されるサンプルログを追加します。詳細については、「グローバル設定」をご参照ください。

2.4 データクエリと分析の設定を構成する

Logtail設定の作成には約3分かかります。 [更新] をクリックします。データをプレビューできる場合は、Logtail設定が作成されます。 Logtail設定が作成されたら、[次へ] をクリックします。 Logtail設定関連の設定は完了です。

ステップ3: ログの照会と分析

Logtail設定作成ウィザードの [終了] ステップで、[ログの照会] をクリックします。次に、指定されたLogstoreのクエリと分析ページに移動します。 /var/log/nginx/access.logファイルから収集されたログを表示できます。検索ボックスにHTTPなどの任意の文字を入力し、クエリの時間範囲を指定してから、[検索と分析] をクリックします。任意の文字を含むログを取得できます。

よくある質問

プロジェクトとLogstoreのみを作成すると課金されますか?

デフォルトでは、Logstoreの作成時にシャードリソースが予約されます。アクティブなシャードに対して課金されます。詳細については、「アクティブシャードに対して課金されるのはなぜですか？」をご参照ください。

ログの収集に失敗した場合はどうすればよいですか?

Logtailを使用してログを収集すると、Logtailハートビートの失敗、収集エラー、または無効なLogtail設定が原因で失敗が発生する可能性があります。詳細については、「」をご参照ください。Logtailを使用してログを収集するときにエラーが発生した場合はどうすればよいですか?

ログのクエリはできるが、Logstoreのクエリと分析ページでログを分析できない場合はどうすればよいですか?

ログを分析する場合は、ログフィールドのインデックスを設定し、フィールドの分析を有効にする必要があります。詳細については、「インデックスの作成」をご参照ください。

Simple Log Service:はじめに