クイックスタート

最終更新日: Mar 13, 2018

ログサービスは、大規模なログ収集、ストレージ、およびクエリを処理するために Alibaba Cloud によって提供されるプラットフォームサービスです。ログサービスを使用して、サービスクラスタからログを収集することができます。ログサービスは、OSS + Spark や MaxCompute へのリアルタイム使用、リアルタイムクエリ、shipping ログもサポートしています。

以下のサンプルでは、Logtail を使用してテキストログを収集し、ログをプレビューし、収集したログを照会し、ログを OSS に送信する方法を紹介します。

ワークフロー

ログサービスを使用する基本的なワークフローは次のとおりです。

1

準備

1 ログサービスの有効化

登録されたAlibaba Cloudアカウントを使用してログサービスページにログインし、 有効化 をクリックします。

2 アクセスキーの作成

アクセスキーはLogtailがログを収集するための要件です。ログサービスを使用する前に、まずアクセスキーを作成してください。

ログサービスコンソールで、右上隅にあるユーザー名の上にカーソルを移動し、表示されたメニューで アクセスキー をクリックします。 ポップアップの確認ボックスで、 確認 をクリックします。アクセスキー管理ページで、右上にあるアクセスキーの作成をクリックします。ポップアップボックスで 同意 をクリックします。

プロジェクトとログストアの作成

  1. プロジェクトの作成

    最初にログオンすると[ログサービスコンソール]、プロジェクトの作成を促すメッセージが表示されます。後続のログインでプロジェクトを作成するには、右上隅の[プロジェクトの作成]をクリックします。

    注意:プロジェクトの作成方法の詳細については、プロジェクトの作成を参照してください。

    プロジェクトを作成するときは、 プロジェクト名 リージョン を指定する必要があります。

  2. ログストアの作成

    プロジェクトを作成した後、ログストアの作成を促すプロンプトが表示されます。プロジェクトに行き、右上隅の作成をクリックすることもできます。

    注意: ログストアの作成の詳細については、ログストアの作成を参照してください。

    ログストアを作成するときは、これらのログの使用方法を指定する必要があります。

ログの収集

ログサービスは、さまざまなログソースと収集モードをサポートしています。詳細は収集モードを参照してください。

  1. Logtail クライアントのインストール

    1. インストールパッケージをダウンロードします。

      Logtail インストールパッケージをECSインスタンスにダウンロードします。Windows インストールパッケージのダウンロードアドレスは、こちら です。

      関連するインストール方法については、Windows に Logtail をインストール または Linux に Logtail をインストール を参照してください。

    2. Logtail をインストールします。

      インストールパッケージをカレントディレクトリに解凍し、 logtail_installerディレクトリに入れます。管理者として cmd を実行し、インストールコマンド .\logtail_installer.exe install cn_hangzhouを実行します。

      注意:あなたはネットワーク環境に応じて異なるリージョンログサービスのインストールコマンドを実行する必要があります。このクイックスタートでは、中国東部 1(杭州)とクラシックネットワークを例として使用しています。他のリージョンのインストールコマンドについては、Windows に Logtail をインストール を参照してください。

  2. Logtail 構成の作成

    1. [ログサービスコンソール]にログインします。希望のプロジェクト名をクリックして、ログストアリストに移動します。 [ログストア名]をクリックして、ログストアリストに移動します。

    2. 右上隅の 作成 をクリックして、Logtail 構成プロセスに移動します。

      Logtail 構成プロセスには、データソースの選択、収集モードの指定、およびマシングループへの適用の各ステップが含まれます。

      1. データソースを選択します。

        データソースをクリックして選択します。この文書は、テキストログの収集に基づいています。Logtail 収集 syslog の詳細については、Logtail を使用して syslog を収集 を参照してください。

        4

      2. 収集モードを指定します。

        • 構成名とログパスを指定します。

          構成名、ログ・パス、およびログ・ファイル名を入力します。ログファイル名は完全な名前にすることができ、同時にファジーマッチングをサポートします。

        • ログ収集モードを指定します。

          ログサービスはシンプルモード、デリミタモード、JSON モード、フルモード、Alibaba Cloud カスタムモードをサポートしています。この文書は、デリミタモードでログを収集することに基づいています。収集モードの詳細については、その他の情報を参照してください。

        • サンプルログを入力します。

          デリミタモードまたはフルモードでは、サンプルログを入力する必要があります。Logtail を使用してログを収集する場合、ログサービスは選択したモードに基づいてログを解析します。失敗した場合は、デリミタの設定と正規表現を変更する必要があります。対応する位置にサンプルログを入力してください。

        • デリミタを指定します。

          タブ、バー、スペース、またはカスタムセパレータを区切り文字として指定できます。ログフォーマットに基づいて対応する区切り文字を選択しない場合、Logtailはログを解析できません。

        • 抽出結果のキーを指定します。

          サンプルログを入力して区切り文字を選択すると、ログサービスは選択した区切り文字に基づいてログフィールドを抽出し、値として定義します。値に対応するキーを指定する必要があります。

        5

      3. マシングループに適用します。

        マシングループを作成していない場合は、ページプロンプトに基づいてマシングループを作成し、マシングループに Logtail 構成を適用します。

        注意:使用可能なマシングループがない場合は、まずマシングループを作成する必要があります。

上記の手順を完了すると、ログサービスはすぐに ECS からログを収集し始めます。収集したログは、コンソールと API / SDK でリアルタイムに使用できます。

注意:

  • Logtail 設定が有効になるまでに最大 3 分かかる場合があります。
  • IIS アクセスログを収集する必要がある場合は、まず IISログ収集のベストプラクティス を参考にし、IIS を構成します。

ログの使用

ログサービスは、ログのプレビュー、クエリ、他の製品へのログの配送など、収集したログを使用するさまざまな方法を提供します。

プレビューログ

ログサービスを使用してログデータを収集すると、収集したログをプレビューできます。Shard IDと時刻を指定することで、最初の10パケットをプレビューできます。

1

次の例では、プレビューのShard IDは0で、時間範囲は直前の15分からの最初の10パケットです。

preview

ログのクエリ

ログサービスでログデータを収集した後、[ログ使用モード]列の[検索]をクリックしてクエリインターフェイスに移動できます。

3

クエリは、指定されたログトピック、キーワード、または時間によって実行されます。ヒストグラムでは、緑はこの期間にデータが正確であることを示し、黄色はデータが不正確であることを示します。黄色い部分をクリックまたはドラッグすると、さらにクエリーを実行できます。不正確なログデータは”一致したログ”に表示されません。

次の例では、クエリ条件は空白で、時間範囲は前の15分に設定されています。

rawlogs

ログを OSS に転送(EMR コンピューティングを使用)

  1. OSS 環境の準備

    ログサービスをOSSに出荷するには、まず次の手順で説明するようにOSS環境を準備する必要があります。

    1. OSSサービスを有効化します。

    2. OSS バケット作成し、関連する許可操作を実行します。

    注意: OSS バケットリージョンとログサービスプロジェクトを同じにする必要があります。データは、ログサービスプロジェクトと同じリージョン OSS バケットにの shipping できます。

  2. OSS 転送ルールの作成

    ログサービスは、OSS にログデータを送信する機能を提供します。ログストアリストで、ログ使用モード列の OSS をクリックし、 有効化 をクリックして OSSshipping ルールを設定します。

    2

    投稿する OSS バケット 、権限コンソールの役割名(ARN)、データが圧縮されているかどうか、その他の属性を指定する必要があります。

    7

  3. OSSshipping タスクの表示

    コンソールの OSSshipping タスク管理では、shipping タスクのステータスを表示することができます。ログをインポートした後は、OSS コンソールで確認ができます。また、OSSへのログの転送 では、インポートしたデータの使い方について説明しています。