Container Service for Kubernetes:Pod の環境変数を使用してアプリケーションログを収集する

イメージ

1. ACK コンソール にログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、管理するクラスターを見つけ、その名前をクリックします。左側のウィンドウで、[ワークロード] > [デプロイメント] を選択します。

3. [デプロイメント] ページの上部にある [名前空間] ドロップダウンリストから、アプリケーションを作成する名前空間を選択します。次に、ページの右上隅にある [イメージから作成] をクリックします。

   1. [基本情報] ステップで、[名前]、[レプリカ]、および [タイプ] パラメーターを設定します。次に、[次へ] をクリックします。

   2. [コンテナー] ステップで、[log Service] セクションのパラメーターを設定します。

      説明

      次の表では、Simple Log Service に関連するパラメーターのみを説明します。その他のパラメーターの詳細については、「デプロイメントを作成する」をご参照ください。

      次の図は例です。

      パラメーター	説明
      収集構成	[収集構成] をクリックします。[ログストア] と [コンテナー内のログパス（stdout に設定可能）] を設定します。 ログストア：使用するログストアの名前。名前には、小文字、数字、およびハイフン（-）のみを含めることができます。 このパラメーターを使用して、収集されたログを格納するログストアを指定できます。指定されたログストアが存在しない場合、システムはクラスターに関連付けられている Simple Log Service プロジェクトにログストアを自動的に作成します。 コンテナー内のログパス（stdout に設定可能）：ログを収集するパス。/usr/local/tomcat/logs/catalina.*.log の値は、Tomcat アプリケーションのログファイルが収集されることを示します。 説明 値を stdout に設定すると、stdout と stderr が収集されます。 すべての設定は、対応するログストアに構成エントリとして追加されます。デフォルトでは、ログはシンプルモード（行ごと）で収集されます。他の方法でログを収集する場合は、Simple Log Service コンソール にログイン し、プロジェクトとログストアのログ収集構成を変更します。デフォルトでは、プロジェクトは k8s-log プレフィックスを使用します。
      カスタムタグ	[カスタムタグ] をクリックします。[タグキー] と [タグ値] を設定します。 各タグは、収集されたログデータに追加されるキーと値のペアです。カスタムタグを使用して、ログデータにマークを付けることができます。たとえば、タグを使用してアプリケーションバージョンを示すことができます。

   3. パラメーターを構成した後、[次へ] をクリックして詳細設定を構成します。後続のステップの詳細については、「デプロイメントを作成する」をご参照ください。

YAML テンプレート

1. ACK コンソール にログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。

2. [クラスター] ページで、管理するクラスターを見つけ、その名前をクリックします。左側のウィンドウで、[ワークロード] > [デプロイメント] を選択します。

3. [デプロイメント] ページの上部にある [名前空間] ドロップダウンリストから、アプリケーションを作成する名前空間を選択します。次に、ページの右上隅にある [YAML から作成] をクリックします。

4. [作成] ページで、[サンプルテンプレート] ドロップダウンリストからテンプレートを選択し、[テンプレート] コードエディターで要件に基づいてテンプレートの内容を変更します。次に、[作成] をクリックします。

   YAML テンプレートは Kubernetes 構文に準拠しています。env を使用して、ログ収集構成とカスタムタグを定義できます。volumeMounts パラメーターと volumes パラメーターも設定する必要があります。Pod の YAML テンプレートの例：

   apiVersion: v1
   kind: Pod
   metadata:
     name: my-demo
   spec:
     containers:
     - name: my-demo-app
       image: 'registry.cn-hangzhou.aliyuncs.com/log-service/docker-log-test:latest'
       args:
       - -c
       - mkdir -p /log;while true; do echo hello world; date; echo hello sls >> /var/log/test.log; sleep 1;done
       command:
       - /bin/sh
       env:
       ######### 環境変数を指定します。###########
       - name: aliyun_logs_log-stdout
         value: stdout
       - name: aliyun_logs_log-varlog
         value: /var/log/*.log
       - name: aliyun_logs_mytag1_tags
         value: tag1=v1
       ######### ボリュームマウントパラメーターを指定します。###########
       volumeMounts:
       - name: volumn-sls-mydemo
         mountPath: /var/log
     volumes:
     - name: volumn-sls-mydemo
       emptyDir: {}

   要件に基づいて次の構成を追加できます。

   説明

   ログ収集に関するその他の要件がある場合は、「ステップ 2：env フィールドの詳細設定を構成する」をご参照ください。

   1. 環境変数を使用して、ログ収集構成とカスタムタグを追加します。ログ収集に関連するすべての環境変数は、プレフィックスとして aliyun_logs_ を使用する必要があります。

      1. 次の形式でログ収集構成を追加します。

         - name: aliyun_logs_log-stdout
           value: stdout
         - name: aliyun_logs_log-varlog
           value: /var/log/*.log

         前の例では、aliyun_logs_{key} という形式の 2 つの環境変数がログ収集構成に追加されています。環境変数の {key} は、log-stdout と log-varlog です。

         • aliyun_logs_log-stdout 環境変数 は、コンテナーから収集された stdout を格納するために、log-stdout という名前のログストアが作成されることを示します。収集構成の名前は log-stdout です。このようにして、コンテナーの stdout は log-stdout という名前のログストアに収集されます。

         • aliyun_logs_log-varlog 環境変数 は、/var/log/*.log パスから収集されたログファイルを格納するために、log-varlog という名前のログストアが作成されることを示します。収集構成の名前は log-varlog です。このようにして、/var/log/*.log パスのログファイルは log-varlog という名前のログストアに収集されます。

      2. 次の形式でカスタムタグを追加します。

         - name: aliyun_logs_mytag1_tags
           value: tag1=v1

         タグが追加されると、タグはコンテナーから収集されたログデータに自動的に追加されます。mytag1 の値には、小文字、数字、およびハイフン（-）のみを含めることができます。

   2. stdout 以外のログファイルを収集するためにログパスを指定する場合は、volumeMounts パラメーターを設定する必要があります。前の YAML テンプレートでは、volumeMounts の mountPath フィールドは /var/log に設定されています。これにより、Logtail は /var/log/*.log ファイルからログデータを収集できます。