Simple Log Service:LoongCollector のインストール (Kubernetes)

コアコンセプト

ログ収集を設定する前に、Alibaba Cloud Simple Log Service (SLS) のコアリソースの概念と、Kubernetes 環境における LoongCollector の実行モードについて理解してください。

前提条件

インストール方法の選択

クラスターのタイプと要件に基づいて、次の表からインストール方法を選択してください：

ACK クラスターへのインストール (DaemonSet モード)

自己管理型クラスターへのインストール (DaemonSet モード)

サイドカーパターンを使用したインストール

アプリケーションレベルの詳細なログコレクションを行うには、サイドカーパターンを使用して LoongCollector をインストールできます。このパターンは、LoongCollector をコンテナーとしてアプリケーション Pod に挿入します。

• 利点: 優れたリソースの隔離、柔軟な構成を提供し、他のアプリケーションに影響を与えません。

• 欠点: DaemonSet パターンと比較して、このパターンではアプリケーションのデプロイメント YAML ファイルを手動で変更する必要があるため、構成とメンテナンスがより複雑になります。

手順

前提条件を満たしたら、次の手順に従って LoongCollector をインストールし、構成します。

1. (任意) テストデモのデプロイ: 適切なアプリケーションコンテナーがない場合、またはコレクション機能を迅速にテストしたい場合は、次のデプロイメントテンプレートを使用して専用のテストコンテナーをデプロイできます。

   test-demo-deployment.yaml

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     annotations:
       deployment.kubernetes.io/revision: '1'
     labels:
       app: deployment-file
       cluster_label: CLUSTER-LABEL-A
     name: deployment-file
     namespace: default
   spec:
     progressDeadlineSeconds: 600
     replicas: 1
     revisionHistoryLimit: 10
     selector:
       matchLabels:
         app: deployment-file
     strategy:
       rollingUpdate:
         maxSurge: 25%
         maxUnavailable: 25%
       type: RollingUpdate
     template:
       metadata:
         labels:
           app: deployment-file
           cluster_label: CLUSTER-LABEL-A
       spec:
         containers:
           - name: timestamp-test
             image: 'mirrors-ssl.aliyuncs.com/busybox:latest'
             args:
               - >-
                 while true; mkdir -p /root/log; do date '+%Y-%m-%d %H:%M:%S'
                 >>/root/log/timestamp.log; echo 1 >>/root/log/timestamp.log; echo
                 2 >>/root/log/timestamp.log; echo 3 >>/root/log/timestamp.log;
                 echo 4 >>/root/log/timestamp.log; echo 5
                 >>/root/log/timestamp.log; echo 6 >>/root/log/timestamp.log;
                 echo 7 >>/root/log/timestamp.log; echo 8
                 >>/root/log/timestamp.log; echo 9 >>/root/log/timestamp.log;
                 sleep 10; done
             command:
               - /bin/sh
               - '-c'
               - '--'
             env:
               - name: cluster_id
                 value: CLUSTER-A
             imagePullPolicy: IfNotPresent
             resources: {}
             terminationMessagePath: /dev/termination-log
             terminationMessagePolicy: File

2. アプリケーションのデプロイメント YAML を取得する: アプリケーションが実行されているクラスターに接続します。次のコマンドを実行して、デプロイメントの YAML ファイルをエクスポートします。

   # test-demo-deployment をデプロイメントの名前に置き換えます。
   kubectl get deploy test-demo-deployment -o yaml > current-config.yaml

3. サイドカーコンテナーと共有ボリュームを挿入するために YAML ファイルを変更する: 次の例とパラメーターの説明に従って YAML ファイルを変更します。

   主要なパラメーターの説明	Loongcollector コンテナーを挿入するための YAML 構成 apiVersion: apps/v1 kind: Deployment metadata: name: your-app-deployment # これはアプリケーションのデプロイメントです spec: # ... その他の既存の spec 構成 ... template: spec: containers: # =================================================================== # ステップ 1: 既存のアプリケーションコンテナーを変更する # アプリケーションコンテナーの定義で、volumeMounts セクションを見つけるか追加します。 # =================================================================== - name: your-business-app-container # <--- これはアプリケーションコンテナーです image: your-app-image:latest # ... アプリケーションコンテナーのその他の構成 ... volumeMounts: # ... 既存の他のマウントポイント ... # --- 開始: 次の内容を追加 --- - name: ${shared_volume_name} mountPath: ${shared_volume_path} # 共有ボリュームをコンテナーのログディレクトリにマウントします - name: tasksite mountPath: /tasksite # Loongcollector コンテナーとの通信用の共有ディレクトリ # --- 終了: 内容の追加 --- # =================================================================== # ステップ 2: Loongcollector サイドカーコンテナーを追加する # containers リストの最後に、以下の完全なサイドカーコンテナー定義を貼り付けます。 # =================================================================== - name: loongcollector image: ${loongcollector_image} command: ["/bin/sh", "-c"] args: - >- /etc/init.d/ilogtaild start; sleep 10; touch /tasksite/cornerstone; until [[ -f /tasksite/tombstone ]]; do sleep 1; done; sleep 10; /etc/init.d/ilogtaild stop; livenessProbe: exec: command: - /etc/init.d/ilogtaild - status initialDelaySeconds: 30 periodSeconds: 30 env: # タイムゾーンを設定します。Kubernetes クラスターのリージョンに基づいてタイムゾーンを構成します。フォーマットは "Area/City" です。 # タイムゾーンが正しく構成されていない場合、生ログと処理済みログのタイムスタンプが一致しない可能性があります。 - name: TZ value: "${timezone}" - name: ALIYUN_LOGTAIL_USER_ID value: "${your_aliyun_user_id}" - name: ALIYUN_LOGTAIL_USER_DEFINED_ID value: "${your_machine_group_user_defined_id}" - name: ALIYUN_LOGTAIL_CONFIG value: "/etc/ilogtail/conf/${your_region_config}/ilogtail_config.json" # Pod 環境コンテキストをログタグとして追加 - name: "ALIYUN_LOG_ENV_TAGS" value: "_pod_name_|_pod_ip_|_namespace_|_node_name_|_node_ip_" # Pod とノード情報を取得 - name: "_pod_name_" valueFrom: fieldRef: fieldPath: metadata.name - name: "_pod_ip_" valueFrom: fieldRef: fieldPath: status.podIP - name: "_namespace_" valueFrom: fieldRef: fieldPath: metadata.namespace - name: "_node_name_" valueFrom: fieldRef: fieldPath: spec.nodeName - name: "_node_ip_" valueFrom: fieldRef: fieldPath: status.hostIP volumeMounts: # Loongcollector コンテナーのログディレクトリを共有ボリュームにマウントします - name: ${shared_volume_name} mountPath: ${dir_containing_your_files} # アプリケーションコンテナーとの対話用のマウントポイント - name: tasksite mountPath: /tasksite # =================================================================== # ステップ 3: 共有ボリュームを定義する # spec.template.spec の下、containers と同じレベルに volumes 定義を追加します。 # =================================================================== volumes: # ログストレージ用に空の共有ボリュームを定義します - name: ${shared_volume_name} emptyDir: {} # コンテナー間通信用のボリュームを定義します - name: tasksite emptyDir: medium: Memory
   ${timezone} コンテナーのタイムゾーン。詳細については、「サポートされているタイムゾーン」をご参照ください。
   ${your_aliyun_user_id} Simple Log Service に使用する Alibaba Cloud アカウントの ID。
   ${your_machine_group_user_defined_id} マシングループのカスタム識別子。これは、カスタムマシングループを作成するために使用されます。 重要 この識別子は、プロジェクトのリージョン内で一意である必要があります。
   ${your_region_config} このパラメーターは、Simple Log Service プロジェクトのリージョンとネットワークアクセスタイプに基づいて設定します。たとえば、プロジェクトが中国 (杭州) リージョンにある場合: Alibaba Cloud 内の内部ネットワークアクセスの場合: このパラメーターを cn-hangzhou に設定します。 パブリックネットワークアクセスの場合: このパラメーターを cn-hangzhou-internet に設定します。 リージョン ID については、「リージョン」をご参照ください。
   ${loongcollector_image} Loongcollector イメージアドレス。イメージアドレスの ${region-id} を、クラスターのリージョンに対応するリージョン ID に置き換えます。 イメージアドレス: aliyun-observability-release-registry.${region-id}.cr.aliyuncs.com/loongcollector/loongcollector:v3.0.12.0-25723a1-aliyun
   ${shared_volume_name} ボリュームのカスタム名。 重要 volumeMounts ノードの name パラメーターの値は、volumes ノードの name パラメーターの値と同じでなければなりません。これにより、Loongcollector コンテナーとアプリケーションコンテナーが同じボリュームにマウントされることが保証されます。
   ${dir_containing_your_files} マウントパス。これは、収集したいテキストログを含むコンテナー内のディレクトリです。

4. 更新された構成を適用する: 次のコマンドを実行してアプリケーションを更新します。

   kubectl apply -f current-config.yaml

5. Loongcollector のインストールを検証する: 次のコマンドを実行して新しい Pod を確認します。アプリケーションコンテナーと LoongCollector コンテナーの両方が実行中状態であることを確認してください。

   kubectl describe pod <YOUR-POD-NAME>

   LoongCollector コンテナーのステータスが Running の場合、インストールは成功です。

   

6. マシングループを作成する:

   1. Simple Log Service コンソールにログインし、プロジェクトをクリックします。

   2. 左側のナビゲーションウィンドウで、[リソース] > [マシングループ] を選択し、[マシングループ] ページで [] > [マシングループの作成] をクリックします。

   3. [マシングループの作成] ダイアログボックスで、次のパラメーターを構成し、[OK] をクリックします。

      1. マシングループ名に値を入力します。

      2. マシングループ ID には、[カスタム識別子] を選択します。

      3. カスタム識別子には、構成ファイルの ${your_machine_group_user_defined_id} の値を入力します。

   4. マシングループが作成されたら、マシングループリストでその名前をクリックします。[マシングループ設定] > [マシングループステータス] セクションで、[ハートビート] ステータスを確認します。ステータスが OK の場合、マシングループが正常に作成されたことを示します。ハートビートが失敗した場合は、ユーザー ID とカスタム識別子が正しいことを確認してください。

よくある質問

次のステップ

LoongCollector をインストールした後、コア原則、主要なプロセス、選択に関する推奨事項、およびベストプラクティスについては、「Kubernetes コンテナーのログ収集」をご参照ください。次に、以下のいずれかのメソッドを使用してコレクション構成を作成します。

• Kubernetes-CRD

• Simple Log Service コンソール

関連リファレンス